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

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)

Instagram (9 tools)

Reddit (9 tools)

TikTok (7 tools)

Tracking & Monitoring (3 tools)

For continuous brand monitoring and lead generation — Xpoz indexes new matching content as it appears.

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:

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.