{
  "markdown": "# Xpoz MCP Server\n\n**Search Twitter, Instagram, Reddit & TikTok from any AI agent.** Billions of posts indexed. Natural language queries. CSV exports up to 500K rows. No API keys needed.\n\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-blue)](https://registry.modelcontextprotocol.io/?q=xpoz)\n[![Website](https://img.shields.io/badge/xpoz.ai-visit-green)](https://xpoz.ai)\n\n> **Remote MCP server** — no local installation required. Connect via Streamable HTTP and authenticate with OAuth 2.1 (sign in with Google, no API keys to manage). Direct probes to `https://mcp.xpoz.ai/mcp` return `401 Unauthorized` — that's expected; your MCP client handles the OAuth flow.\n\n## Quick Start\n\n### Claude Desktop / Cursor / Windsurf\n\nAdd to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"xpoz\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://mcp.xpoz.ai/mcp\"\n    }\n  }\n}\n```\n\n### Claude Code, Codex, Gemini CLI\n\n```bash\n# Claude Code\nclaude mcp add --transport http --scope user xpoz https://mcp.xpoz.ai/mcp\n\n# Codex / Gemini CLI: see https://www.xpoz.ai/integrations\n```\n\n### OpenClaw\n\n```bash\nclawhub install xpoz-social-search\n```\n\nThen authenticate via the OAuth link when prompted. Eight more pre-built skills are available — see [`clawhub.ai/u/atyachin`](https://clawhub.ai/u/atyachin).\n\n### Try it without signing up\n\nWant to kick the tires first? Mint a free trial token — no sign-in required, valid for 5 days. It returns a limited set of results so you can see the server in action:\n\n```bash\n# Get a trial token (starts with \"TRIAL\")\ncurl -X POST https://api.xpoz.ai/api/trial/token\n# -> { \"success\": true, \"data\": { \"accessKey\": \"TRIAL...\", \"expiresInSeconds\": 432000 }, ... }\n```\n\nSkip the OAuth flow by passing the trial token as a bearer header in your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"xpoz\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://mcp.xpoz.ai/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer TRIAL...\" }\n    }\n  }\n}\n```\n\nFor full results, [grab your own API key](https://www.xpoz.ai/get-token) or just connect via OAuth as shown above.\n\n---\n\n## SDKs & CLI\n\nIf you'd rather call Xpoz directly from code or a terminal instead of through an MCP client:\n\n### TypeScript / Node.js\n\n```bash\nnpm install @xpoz/xpoz\n```\n\nSource: [`XPOZpublic/xpoz-ts-sdk`](https://github.com/XPOZpublic/xpoz-ts-sdk).\n\n### Python\n\n```bash\npip install xpoz\n```\n\nSource: [`XPOZpublic/xpoz-python-sdk`](https://github.com/XPOZpublic/xpoz-python-sdk).\n\n### CLI\n\n| Platform | Install command |\n|---|---|\n| macOS / Linux (Homebrew) | `brew install XPOZpublic/xpoz/xpoz-cli` |\n| macOS / Linux (one-liner) | `curl -fsSL https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.sh \\| sh` |\n| Windows (PowerShell) | `iwr -useb https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.ps1 \\| iex` |\n| Windows (winget) | `winget install Xpoz.XpozCli` |\n| Any platform with Python ≥ 3.10 | `pip install xpoz-cli` |\n\nSource: [`XPOZpublic/xpoz-cli`](https://github.com/XPOZpublic/xpoz-cli).\n\nAll four channels speak the same MCP protocol against `https://mcp.xpoz.ai/mcp` under the hood, so any tool you see below is reachable from every surface. Get an API token at [`xpoz.ai/get-token`](https://www.xpoz.ai/get-token).\n\n---\n\n## Platforms & Tools\n\n### Twitter / X (14 tools)\n\n| Tool | Description |\n|------|-------------|\n| `searchTwitterUsers` | Find users by name, bio, or keywords |\n| `getTwitterUser` | Get profile details (followers, bio, metrics) |\n| `getTwitterUsersByKeywords` | Discover users actively posting about topics |\n| `getTwitterUserConnections` | Get followers or following list |\n| `getTwitterPostsByKeywords` | Search tweets by keywords, hashtags, mentions |\n| `getTwitterPostsByAuthor` | Get tweets from a specific user |\n| `getTwitterPostsByIds` | Fetch specific tweets by ID |\n| `getTwitterPostComments` | Get replies to a tweet |\n| `getTwitterPostRetweets` | Get retweets of a tweet |\n| `getTwitterPostQuotes` | Get quote tweets |\n| `getTwitterPostInteractingUsers` | Users who liked/retweeted a post |\n| `countTweets` | Count tweets matching a query (hourly/daily buckets) |\n| `checkOperationStatus` | Poll async export operations |\n| `cancelOperation` | Cancel a running operation |\n\n### Instagram (9 tools)\n\n| Tool | Description |\n|------|-------------|\n| `searchInstagramUsers` | Find users by name or username |\n| `getInstagramUser` | Get profile details and metrics |\n| `getInstagramUsersByKeywords` | Discover users posting about topics |\n| `getInstagramUserConnections` | Get followers or following list |\n| `getInstagramPostsByKeywords` | Search posts by keywords or hashtags |\n| `getInstagramPostsByUser` | Get posts from a specific user |\n| `getInstagramPostsByIds` | Fetch specific posts by ID |\n| `getInstagramPostInteractingUsers` | Users who liked/commented on a post |\n| `getInstagramCommentsByPostId` | Get comments on a post |\n\n### Reddit (9 tools)\n\n| Tool | Description |\n|------|-------------|\n| `searchRedditUsers` | Find users by name |\n| `getRedditUser` | Get user profile and karma |\n| `getRedditUsersByKeywords` | Discover users active in topics |\n| `getRedditPostsByKeywords` | Search posts across subreddits |\n| `getRedditPostWithCommentsById` | Get a post with its comment tree |\n| `getRedditCommentsByKeywords` | Search comments by keywords |\n| `searchRedditSubreddits` | Find subreddits by name |\n| `getRedditSubredditWithPostsByName` | Get a subreddit's metadata and recent posts |\n| `getRedditSubredditsByKeywords` | Discover subreddits by topic |\n\n### TikTok (7 tools)\n\n| Tool | Description |\n|------|-------------|\n| `searchTiktokUsers` | Find creators by name or username |\n| `getTiktokUser` | Get creator profile (followers, likes, bio, verification) |\n| `getTiktokUsersByKeywords` | Discover creators by topic in their post history |\n| `getTiktokPostsByKeywords` | Search videos by keywords or hashtags |\n| `getTiktokPostsByUser` | Get videos posted by a specific creator |\n| `getTiktokPostsByIds` | Fetch specific videos by ID |\n| `getTiktokCommentsByPostId` | Get comments on a specific video |\n\n### Tracking & Monitoring (3 tools)\n\nFor continuous brand monitoring and lead generation — Xpoz indexes new matching content as it appears.\n\n| Tool | Description |\n|------|-------------|\n| `addTrackedItems` | Subscribe to ongoing monitoring of a query, user, or subreddit across any platform |\n| `getTrackedItems` | List your active tracked items with last-update timestamps |\n| `removeTrackedItems` | Stop monitoring tracked items by ID |\n\n---\n\n## Key Features\n\n- **Natural language queries** — describe what you want, Xpoz optimizes the search\n- **CSV exports** — up to 500K rows in a single download via async operations\n- **Server-side pagination** — handle large result sets efficiently\n- **Field selection** — request only the fields you need\n- **Cache control** — `forceLatest: true` bypasses cache for real-time data\n- **Async operations** — long-running exports with status polling\n- **OAuth 2.1** — dynamic client registration with Google as the upstream identity provider, no API keys to manage\n\n## Use Cases\n\n- **Lead generation** — find people discussing problems your product solves\n- **Influencer discovery** — identify creators by what they post, not just follower count\n- **Brand monitoring** — track mentions, sentiment, and competitor activity\n- **Market research** — analyze trends and conversations at scale\n- **Expert finding** — discover domain authorities across platforms\n- **Security intelligence** — monitor vulnerability discussions before CVEs publish\n\n## Discovery surfaces (for AI agents and scanners)\n\nThese public, machine-readable endpoints describe Xpoz to crawlers and agentic clients:\n\n| Surface | URL |\n|---|---|\n| MCP manifest | https://www.xpoz.ai/.well-known/mcp.json |\n| MCP tool catalog (descriptions + JSON-Schema parameters) | https://www.xpoz.ai/.well-known/mcp/tools.json |\n| Agent Skills index (agentskills.io v0.2.0) | https://www.xpoz.ai/.well-known/agent-skills/index.json |\n| `llms.txt` | https://www.xpoz.ai/llms.txt |\n| `llms-full.txt` | https://www.xpoz.ai/llms-full.txt |\n| `discovery.txt` | https://www.xpoz.ai/discovery.txt |\n| Webhooks contract | https://www.xpoz.ai/webhooks |\n| Rate limits & 429 contract | https://www.xpoz.ai/rate-limits |\n\n## Links\n\n- 🌐 [xpoz.ai](https://xpoz.ai)\n- 💰 [Pricing](https://www.xpoz.ai/pricing)\n- 📦 [MCP Registry](https://registry.modelcontextprotocol.io/?q=xpoz)\n- 🛠️ [ClawHub Skills](https://clawhub.ai/u/atyachin)\n- 📖 [Documentation](https://help.xpoz.ai)\n- 🐙 [XPOZpublic on GitHub](https://github.com/XPOZpublic) — TS SDK, Python SDK, CLI, agent skills, cookbooks\n- 🍺 [Homebrew tap](https://github.com/XPOZpublic/homebrew-xpoz)\n\n## License\n\nThis repository contains configuration and documentation only. The Xpoz MCP server is a hosted service — see [Terms of Service](https://www.xpoz.ai/terms).\n",
  "bytes": 8908,
  "sha": "8391f61fa9f6ff905693153dbb197382f2837affc0cff847b02a52a6479a4973",
  "repo_slug": "xpozpublic/xpoz-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_xpoz_social_insights_063efb48/readme"
}