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/mcp return 401 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: true bypasses 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.