Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)

What Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) does

Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) provides MCP tools for querying social content and user accounts across Twitter/X, Instagram, Reddit, and TikTok. Agents can search users and posts by natural-language terms, keywords, hashtags, mentions, or topics, then retrieve profiles, posts, comments, connections, and other platform-specific details.

The service indexes a large volume of historical and newly appearing content. Its use cases include lead generation, influencer and expert discovery, brand and competitor monitoring, market research, and monitoring of security-related discussions. Tracking tools can maintain subscriptions for matching queries, users, or subreddits across supported platforms.

How it works

The hosted MCP endpoint is https://mcp.xpoz.ai/mcp. MCP clients connect over Streamable HTTP and authenticate through OAuth 2.1. The documented sign-in flow uses Google as the upstream identity provider, so a direct unauthenticated request to the endpoint is expected to return 401 Unauthorized; an MCP client should initiate the authentication flow instead.

Search responses support server-side pagination and field selection. Requests can set forceLatest: true when cached results should be bypassed. Large CSV exports run as asynchronous operations, which can be checked with status polling and stopped with cancellation.

Setup and configuration

For Claude Desktop, Cursor, and Windsurf, add a Streamable HTTP server entry pointing to the hosted endpoint. Claude Code can register the same URL with its HTTP transport. The README also documents integration paths for Codex and Gemini CLI.

Clients that only launch local processes can use the repository's Docker bridge. Build the image, then run it interactively so it can relay stdio requests to the remote service through mcp-remote. XPOZ_API_KEY is optional for this bridge: without it, the bridge uses browser-based OAuth; with it, the supplied token is used instead. Tokens are available from the XPOZ website.

The project also lists TypeScript, Python, and command-line SDKs, but those are separate access surfaces rather than additional MCP tools.

Tools and capabilities

Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) exposes platform-specific tool groups:

• Twitter/X tools search users and posts, retrieve profiles, posts by author or ID, replies, retweets, quotes, interacting users, connections, and tweet counts.
• Instagram tools search users and posts, retrieve profiles, user posts, post IDs, comments, connections, and interacting users.
• Reddit tools search users, posts, comments, subreddits, and topic-related communities, and retrieve a post with its comment tree or a subreddit with recent posts.
• TikTok tools search creators and videos, retrieve creator profiles, videos by user or ID, and video comments.
• Tracking tools add, list, and remove ongoing monitoring items.

The service supports CSV downloads of up to 500,000 rows through asynchronous operations. Twitter count queries can return hourly or daily buckets. Natural-language queries are accepted, with the service selecting the search approach.

Limitations and notes

Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) is a hosted service rather than a locally run MCP implementation. The repository contains configuration and documentation, while requests are handled by the remote XPOZ endpoint. OAuth requires a browser during the fallback authentication flow, which may not suit fully headless environments unless an API token is supplied to the Docker bridge.

The README does not state a repository software license. API access, pricing, rate limits, terms, and the handling of HTTP 429 responses are described through XPOZ's linked service documentation rather than in the repository excerpt.