Xpoz MCP Server

Search Twitter, Instagram, Reddit & TikTok from any AI agent. 1.5B+ 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. Eight more pre-built skills are available — see clawhub.ai/u/atyachin.

---

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
`getInstagram

... View full README on GitHub