Xpoz MCP Server
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.
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/mcpreturn401 Unauthorized— that's expected; your MCP client handles the OAuth flow.
Quick Start
Claude Desktop / Cursor / Windsurf
Add to your MCP config:
{
"mcpServers": {
"xpoz": {
"type": "streamable-http",
"url": "https://mcp.xpoz.ai/mcp"
}
}
}
Claude Code, Codex, Gemini CLI
# Claude Code
claude mcp add --transport http --scope user xpoz https://mcp.xpoz.ai/mcp
# Codex / Gemini CLI: see https://www.xpoz.ai/integrations
OpenClaw
clawhub install xpoz-social-search
Then authenticate via the OAuth link when prompted. More pre-built skills are available — see clawhub.ai/u/atyachin.
Docker (stdio-only clients)
The repository ships a small Docker image that bridges stdio to the remote server through mcp-remote, for clients that can only launch local commands:
docker build -t xpoz-mcp .
docker run -i --rm -e XPOZ_API_KEY=your-key xpoz-mcp
XPOZ_API_KEY is optional: without it the bridge falls back to the OAuth sign-in flow, which needs a browser. Get a key at xpoz.ai/get-token.
SDKs & CLI
If you'd rather call Xpoz directly from code or a terminal instead of through an MCP client:
TypeScript / Node.js
npm install @xpoz/xpoz
Source: XPOZpublic/xpoz-ts-sdk.
Python
pip install xpoz
Source: XPOZpublic/xpoz-python-sdk.
CLI
| Platform | Install command |
|---|---|
| macOS / Linux (Homebrew) | brew install XPOZpublic/xpoz/xpoz-cli |
| macOS / Linux (one-liner) | curl -fsSL https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.sh | sh |
| Windows (PowerShell) | iwr -useb https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.ps1 | iex |
| Windows (winget) | winget install Xpoz.XpozCli |
| Any platform with Python ≥ 3.10 | pip install xpoz-cli |
Source: XPOZpublic/xpoz-cli.
All 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.
Platforms & Tools
Twitter / X (14 tools)
| Tool | Description |
|---|---|
searchTwitterUsers | Find users by name, bio, or keywords |
getTwitterUser | Get profile details (followers, bio, metrics) |
getTwitterUsersByKeywords | Discover users actively posting about topics |
getTwitterUserConnections | Get followers or following list |
getTwitterPostsByKeywords | Search tweets by keywords, hashtags, mentions |
getTwitterPostsByAuthor | Get tweets from a specific user |
getTwitterPostsByIds | Fetch specific tweets by ID |
getTwitterPostComments | Get replies to a tweet |
getTwitterPostRetweets | Get retweets of a tweet |
getTwitterPostQuotes | Get quote tweets |
getTwitterPostInteractingUsers | Users who liked/retweeted a post |
countTweets | Count tweets matching a query (hourly/daily buckets) |
checkOperationStatus | Poll async export operations |
cancelOperation | Cancel a running operation |
Instagram (9 tools)
| Tool | Description |
|---|---|
searchInstagramUsers | Find users by name or username |
getInstagramUser | Get profile details and metrics |
getInstagramUsersByKeywords | Discover users posting about topics |
getInstagramUserConnections | Get followers or following list |
getInstagramPostsByKeywords | Search posts by keywords or hashtags |
getInstagramPostsByUser | Get posts from a specific user |
getInstagramPostsByIds | Fetch specific posts by ID |
getInstagramPostInteractingUsers | Users who liked/commented on a post |
getInstagramCommentsByPostId | Get comments on a post |
Reddit (9 tools)
| Tool | Description |
|---|---|
searchRedditUsers | Find users by name |
getRedditUser | Get user profile and karma |
getRedditUsersByKeywords | Discover users active in topics |
getRedditPostsByKeywords | Search posts across subreddits |
getRedditPostWithCommentsById | Get a post with its comment tree |
getRedditCommentsByKeywords | Search comments by keywords |
searchRedditSubreddits | Find subreddits by name |
getRedditSubredditWithPostsByName | Get a subreddit's metadata and recent posts |
getRedditSubredditsByKeywords | Discover subreddits by topic |
TikTok (7 tools)
| Tool | Description |
|---|---|
searchTiktokUsers | Find creators by name or username |
getTiktokUser | Get creator profile (followers, likes, bio, verification) |
getTiktokUsersByKeywords | Discover creators by topic in their post history |
getTiktokPostsByKeywords | Search videos by keywords or hashtags |
getTiktokPostsByUser | Get videos posted by a specific creator |
getTiktokPostsByIds | Fetch specific videos by ID |
getTiktokCommentsByPostId | Get comments on a specific video |
Tracking & Monitoring (3 tools)
For continuous brand monitoring and lead generation — Xpoz indexes new matching content as it appears.
| Tool | Description |
|---|---|
addTrackedItems | Subscribe to ongoing monitoring of a query, user, or subreddit across any platform |
getTrackedItems | List your active tracked items with last-update timestamps |
removeTrackedItems | Stop monitoring tracked items by ID |
Key Features
- Natural language queries — describe what you want, Xpoz optimizes the search
- CSV exports — up to 500K rows in a single download via async operations
- Server-side pagination — handle large result sets efficiently
- Field selection — request only the fields you need
- Cache control —
forceLatest: truebypasses cache for real-time data - Async operations — long-running exports with status polling
- OAuth 2.1 — dynamic client registration with Google as the upstream identity provider, no API keys to manage
Use Cases
- Lead generation — find people discussing problems your product solves
- Influencer discovery — identify creators by what they post, not just follower count
- Brand monitoring — track mentions, sentiment, and competitor activity
- Market research — analyze trends and conversations at scale
- Expert finding — discover domain authorities across platforms
- Security intelligence — monitor vulnerability discussions before CVEs publish
Discovery surfaces (for AI agents and scanners)
These public, machine-readable endpoints describe Xpoz to crawlers and agentic clients:
| Surface | URL |
|---|---|
| MCP manifest | https://www.xpoz.ai/.well-known/mcp.json |
| MCP tool catalog (descriptions + JSON-Schema parameters) | https://www.xpoz.ai/.well-known/mcp/tools.json |
| Agent Skills index (agentskills.io v0.2.0) | https://www.xpoz.ai/.well-known/agent-skills/index.json |
llms.txt | https://www.xpoz.ai/llms.txt |
llms-full.txt | https://www.xpoz.ai/llms-full.txt |
discovery.txt | https://www.xpoz.ai/discovery.txt |
| Webhooks contract | https://www.xpoz.ai/webhooks |
| Rate limits & 429 contract | https://www.xpoz.ai/rate-limits |
Links
- 🌐 xpoz.ai
- 💰 Pricing
- 📦 MCP Registry
- 🛠️ ClawHub Skills
- 📖 Documentation
- 🐙 XPOZpublic on GitHub — TS SDK, Python SDK, CLI, agent skills, cookbooks
- 🍺 Homebrew tap
License
This repository contains configuration and documentation only. The Xpoz MCP server is a hosted service — see Terms of Service.