Use Xpoz from the Claude Code CLI
Add the Xpoz MCP server to Claude Code and query Twitter/X, Instagram, TikTok, and Reddit directly from your terminal.
What is Claude Code?
Claude Code is Anthropic's command-line coding agent. It natively supports the Model Context Protocol, so adding Xpoz takes a single shell command — no wrapper, no plugin. Once connected, Claude Code can search social data, detect brand mentions, and generate leads from public conversations without you writing API integrations.
Install
Run this once to register Xpoz with Claude Code. Replace YOUR_XPOZ_API_TOKEN with your token from the Xpoz dashboard.
claude mcp add --transport http --scope user xpoz-mcp https://mcp.xpoz.ai/mcp --header "Authorization: Bearer YOUR_XPOZ_API_TOKEN"Test query
Run this to confirm the connection works:
> Use the xpoz-mcp server to search Twitter for posts mentioning "Claude Code" in the last 24 hours and summarize sentiment.Example prompts
Brand monitoring
Cross-platform brand mention sweep
> Use xpoz-mcp to search Twitter/X, Reddit, and Instagram for "YourBrand" in the last 7 days. Group mentions by platform, flag anything with negative sentiment, and summarize the top 5 conversations I should respond to.Lead generation
Buying-signal discovery on Reddit
> Use xpoz-mcp to find recent Reddit posts where someone is asking for alternatives to CompetitorName or complaining about it. For each post, return the subreddit, author, and a one-line lead qualification note.Troubleshooting
Tools from xpoz-mcp do not appear in Claude Code
Run `claude mcp list` to confirm xpoz-mcp is registered. If it is, restart your Claude Code session. The OAuth-style token in the Authorization header must be a valid Xpoz API token generated from your dashboard.
401 Unauthorized errors
Your token has expired or was revoked. Generate a fresh token at https://www.xpoz.ai/get-token and re-run the `claude mcp add` command.
Rate-limit errors on heavy sweeps
The free tier allows 100,000 results/month and 60 requests/minute. Break long sweeps into smaller batches or upgrade at https://www.xpoz.ai/pricing.
Why XPOZ + Claude Code?
No Platform API Keys Needed
Access Twitter, Instagram, TikTok, and Reddit data without obtaining API keys from each platform.
Natural Language Queries
Ask questions in plain English instead of writing complex API calls.
Unified Multi-Platform Access
One tool to query all major social platforms simultaneously.
Generous Usage Limits
Free tier includes 100K results/month. Pro plans scale to 10M+.
Getting Started
Sign up for XPOZ
Create a free account at xpoz.ai to get your MCP server credentials.
Configure Claude Code
Add the XPOZ MCP server to your Claude Code configuration.
Start Querying
Your Claude Code agents can now access social media data through natural language queries.
Ready to Connect XPOZ with Claude Code?
Get started with 100,000 free results per month. No credit card required.