# xpoz

Social intelligence for AI agents - Twitter/X, Instagram, TikTok data access and insights.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add net-service/xpoz

# Browse available tools
npx -y @smithery/cli@latest tool list net-service/xpoz

# Get full schema for a tool
npx -y @smithery/cli@latest tool get net-service/xpoz getTwitterUserById

# Call a tool
npx -y @smithery/cli@latest tool call net-service/xpoz getTwitterUserById '{}'
```

## Direct MCP Connection

Endpoint: `https://xpoz--net-service.run.tools`

## Tools (27)

- `getTwitterUserById` — Get Twitter user profile by numeric ID. Use when you have exact user ID. NOT for username - use getTwitterUserByUsernam…
- `getTwitterUserByUsername` — Get user profile by EXACT Twitter handle/username ONLY. CRITICAL: Use ONLY when you have the precise Twitter username (…
- `searchTwitterUsers` — Search users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given per…
- `getTwitterFollowers` — Get all users that follow a Twitter user (who follows them) with server-side pagination (100 users per page). Returns o…
- `getTwitterFollowing` — Get all users that a Twitter user is following (who they follow) with server-side pagination (100 users per page). Retu…
- `getTwitterPostById` — Get single Twitter post by numeric ID. First searches database, then external API if not found. Use when you have exact…
- `getTwitterPostsByAuthorId` — Get posts from author by numeric ID with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATEL…
- `getTwitterPostsByAuthorUsername` — Get posts from author by username with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY …
- `getTwitterPostsByKeywords` — Search posts by keywords with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call chec…
- `getTwitterPostRetweets` — Get retweets of specific post with server-side pagination (100 posts per page, database-only). Returns operation ID - I…
- `getTwitterPostQuotes` — Get quote posts of specific post with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY c…
- `getTwitterPostComments` — Get comments (replies) to specific post with server-side pagination (100 posts per page). Returns operation ID - IMMEDI…
- `countTweets` — Count tweets containing a specific phrase within a date range. Returns operation ID - IMMEDIATELY call checkOperationSt…
- `checkOperationStatus` — Check status and retrieve results from background operations. Required: operationId. HANDLES TWO TYPES: (1) Query opera…
- `cancelOperation` — Cancel running operation. Required: operationId. Gracefully stops operation at next checkpoint. Returns confirmation. U…
- `getInstagramPostById` — Get single Instagram post by ID. First searches database, then external API if not found or data is stale (>3 days). Us…
- `getInstagramPostsByUserId` — Get posts by Instagram user ID with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY cal…
- `getInstagramPostsByUsername` — Get posts by Instagram username with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY ca…
- `getInstagramPostsByKeywords` — Search Instagram posts by keywords with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY…
- `getInstagramUserById` — Get Instagram user profile by numeric ID. Use when you have exact user ID. NOT for username - use getInstagramUserByUse…
- `getInstagramUserByUsername` — Get user profile by EXACT Instagram username ONLY. CRITICAL: Use ONLY when you have the precise Instagram username (e.g…
- `searchInstagramUsers` — Search users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given per…
- `getInstagramFollowers` — Get all users that follow an Instagram user (who follows them) with server-side pagination (100 users per page). Return…
- `getInstagramFollowing` — Get all users that an Instagram user is following (who they follow) with server-side pagination (100 users per page). R…
- `getInstagramCommentsByPostId` — Get comments for an Instagram post with server-side pagination (100 comments per page). Returns operation ID - IMMEDIAT…
- `getUserAccessKey` — Retrieve authenticated user access key. Required: authentication, confirmation. Returns: access key, metadata.
- `checkAccessKeyStatus` — Check access key status without revealing key. Required: authentication. Returns: status, metadata.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get net-service/xpoz <tool-name>
```

## Resources

- `xpoz://instructions/llm-usage` — MUST READ: Instructions for optimal tool usage and performance
- `xpoz://docs/schema` — Documentation of the SingleStore tables schema for tweets and users data

## Prompts (2)

- `system-instructions` — CRITICAL: Instructions that MUST be followed when using tools
- `performance-test` — Demonstrates why userPrompt is critical for performance