Xpoz MCP Server
OfficialClick on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Xpoz MCP Serverfind recent tweets about AI"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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/mcpreturn401 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/integrationsOpenClaw
clawhub install xpoz-social-searchThen 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.
Related MCP server: XActions MCP Server
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/xpozSource: XPOZpublic/xpoz-ts-sdk.
Python
pip install xpozSource: XPOZpublic/xpoz-python-sdk.
CLI
Platform | Install command |
macOS / Linux (Homebrew) |
|
macOS / Linux (one-liner) |
|
Windows (PowerShell) |
|
Windows (winget) |
|
Any platform with Python ≥ 3.10 |
|
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)
Tool | Description |
| Find users by name, bio, or keywords |
| Get profile details (followers, bio, metrics) |
| Discover users actively posting about topics |
| Get followers or following list |
| Search tweets by keywords, hashtags, mentions |
| Get tweets from a specific user |
| Fetch specific tweets by ID |
| Get replies to a tweet |
| Get retweets of a tweet |
| Get quote tweets |
| Users who liked/retweeted a post |
| Count tweets matching a query (hourly/daily buckets) |
| Poll async export operations |
| Cancel a running operation |
Instagram (9 tools)
Tool | Description |
| Find users by name or username |
| Get profile details and metrics |
| Discover users posting about topics |
| Get followers or following list |
| Search posts by keywords or hashtags |
| Get posts from a specific user |
| Fetch specific posts by ID |
| Users who liked/commented on a post |
| Get comments on a post |
Reddit (9 tools)
Tool | Description |
| Find users by name |
| Get user profile and karma |
| Discover users active in topics |
| Search posts across subreddits |
| Get a post with its comment tree |
| Search comments by keywords |
| Find subreddits by name |
| Get a subreddit's metadata and recent posts |
| Discover subreddits by topic |
TikTok (7 tools)
Tool | Description |
| Find creators by name or username |
| Get creator profile (followers, likes, bio, verification) |
| Discover creators by topic in their post history |
| Search videos by keywords or hashtags |
| Get videos posted by a specific creator |
| Fetch specific videos by ID |
| Get comments on a specific video |
Tracking & Monitoring (3 tools)
For continuous brand monitoring and lead generation — Xpoz indexes new matching content as it appears.
Tool | Description |
| Subscribe to ongoing monitoring of a query, user, or subreddit across any platform |
| List your active tracked items with last-update timestamps |
| Stop monitoring tracked items by ID |
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: truebypasses cache for real-time dataAsync 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:
Surface | URL |
MCP manifest | |
MCP tool catalog (descriptions + JSON-Schema parameters) | |
Agent Skills index (agentskills.io v0.2.0) | |
| |
| |
| |
Webhooks contract | |
Rate limits & 429 contract |
Links
🌐 xpoz.ai
💰 Pricing
🐙 XPOZpublic on GitHub — TS SDK, Python SDK, CLI, agent skills, cookbooks
License
This repository contains configuration and documentation only. The Xpoz MCP server is a hosted service — see Terms of Service.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/XPOZpublic/xpoz-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server