Social Media Search API (XPOZ) — Claude Code MCP server
Remote MCP server that searches Twitter, Instagram, Reddit, and TikTok without native platform API keys. Built for audience research, lead generation, and brand tracking.
claude mcp add --transport http social-insights https://mcp.xpoz.ai/mcpWhat Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) does
The server runs as a hosted endpoint at https://mcp.xpoz.ai/mcp over Streamable HTTP. It exposes dedicated tools for Twitter, Instagram, Reddit, and TikTok. Agents can look up creators by bio keywords, pull full comment trees, inspect user connections, and monitor specific subreddits.
Large extractions run through background operations that produce CSV files up to 500K rows. A cache bypass flag forceLatest: true lets the agent request live figures instead of cached entries. If your development environment supports only local stdio processes, the repository provides a Docker image powered by mcp-remote.
Direct HTTP calls return a 401 response because the service enforces OAuth 2.1 via Google sign-in. Your MCP client must be capable of launching the browser authentication handshake, or you must supply XPOZ_API_KEY directly inside the Docker bridge.
What it helps with
- discover creators on TikTok and Twitter by bio keywords
- pull post comment trees and quote tweets for sentiment review
- export up to 500K social media rows to CSV asynchronously
- track mentions across subreddits without maintaining developer keys
Example prompts for the agent
- Search Reddit for recent discussions mentioning Tailwind CSS and return the authors.
- Find TikTok profiles that regularly publish content about mobile development.
- Retrieve replies and engagement metrics for tweet ID
1890000000000000000.
How to install Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)
Platform CLI: remote server
claude mcp add --transport http social-insights https://mcp.xpoz.ai/mcpPlatform CLI: remote server
codex mcp add social-media-search-api-twitter-instagram-reddit-tiktok-xpoz --url https://mcp.xpoz.ai/mcpConfig file
{
"mcpServers": {
"social-media-search-api-twitter-instagram-reddit-tiktok-xpoz": {
"url": "https://mcp.xpoz.ai/mcp"
}
}
}Config file
{
"servers": {
"social-media-search-api-twitter-instagram-reddit-tiktok-xpoz": {
"type": "http",
"url": "https://mcp.xpoz.ai/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http social-media-search-api-twitter-instagram-reddit-tiktok-xpoz https://mcp.xpoz.ai/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)
How do I install Social Media Search API (XPOZ) in Claude Code?
Run claude mcp add --transport http social-media-search-api-twitter-instagram-reddit-tiktok-xpoz https://mcp.xpoz.ai/mcp in your terminal. When prompted, complete the Google OAuth sign-in flow inside your browser.
Do I need separate API keys for Twitter, Instagram, or Reddit?
No developer keys for individual social networks are required. Authentication runs through XPOZ using OAuth 2.1.
How do I connect clients that do not support HTTP transport?
Build the included container with docker build -t xpoz-mcp . and execute docker run -i --rm -e XPOZ_API_KEY=your-key xpoz-mcp. This containerized mcp-remote bridge converts stdio traffic to the hosted endpoint.
