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. Eight more pre-built skills are available — see clawhub.ai/u/atyachin.

Try it without signing up

Want 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:

# Get a trial token (starts with "TRIAL")
curl -X POST https://api.xpoz.ai/api/trial/token
# -> { "success": true, "data": { "accessKey": "TRIAL...", "expiresInSeconds": 432000 }, ... }

Skip the OAuth flow by passing the trial token as a bearer header in your MCP config:

{
  "mcpServers": {
    "xpoz": {
      "type": "streamable-http",
      "url": "https://mcp.xpoz.ai/mcp",
      "headers": { "Authorization": "Bearer TRIAL..." }
    }
  }
}

For full results, grab your own API key or just connect via OAuth as shown above.

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.