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_KEY with your Xpoz API key from the dashboard.
claude mcp add --transport http --scope user xpoz-mcp https://mcp.xpoz.ai/mcp --header "Authorization: Bearer YOUR_XPOZ_API_KEY"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 value in the Authorization header must be a valid Xpoz API key generated from your dashboard.
401 Unauthorized errors
Your API key has expired or was revoked. Generate a fresh one 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 5,000 credits. Pro and Max plans scale with your needs.
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 5,000 free credits. No credit card required.