Which integrations are available for this server?

Provides tools for searching and retrieving Instagram users, posts, comments, and interactions. Provides tools for searching and retrieving Reddit users, posts, comments, and subreddits. Provides tools for searching and retrieving TikTok users, videos, and comments.

How do I use Xpoz MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Xpoz MCP Server find 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

Official

by XPOZpublic

Overview Schema Source Related Servers Discussions Admin

Remote

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.

MCP Registry Website

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/mcp return 401 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/integrations

OpenClaw

clawhub install xpoz-social-search

Then authenticate via the OAuth link when prompted. More pre-built skills are available — see clawhub.ai/u/atyachin.

Docker (stdio-only clients)

The repository ships a small Docker image that bridges stdio to the remote server through mcp-remote, for clients that can only launch local commands:

docker build -t xpoz-mcp .
docker run -i --rm -e XPOZ_API_KEY=your-key xpoz-mcp

XPOZ_API_KEY is optional: without it the bridge falls back to the OAuth sign-in flow, which needs a browser. Get a key at xpoz.ai/get-token.

Related MCP server: X-Trend Intelligence 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/xpoz

Source: XPOZpublic/xpoz-ts-sdk.

Python

pip install xpoz

Source: XPOZpublic/xpoz-python-sdk.

CLI

Platform	Install command
macOS / Linux (Homebrew)	`brew install XPOZpublic/xpoz/xpoz-cli`
macOS / Linux (one-liner)	`curl -fsSL https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.sh \| sh`
Windows (PowerShell)	`iwr -useb https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.ps1 \| iex`
Windows (winget)	`winget install Xpoz.XpozCli`
Any platform with Python ≥ 3.10	`pip install xpoz-cli`

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
`searchTwitterUsers`	Find users by name, bio, or keywords
`getTwitterUser`	Get profile details (followers, bio, metrics)
`getTwitterUsersByKeywords`	Discover users actively posting about topics
`getTwitterUserConnections`	Get followers or following list
`getTwitterPostsByKeywords`	Search tweets by keywords, hashtags, mentions
`getTwitterPostsByAuthor`	Get tweets from a specific user
`getTwitterPostsByIds`	Fetch specific tweets by ID
`getTwitterPostComments`	Get replies to a tweet
`getTwitterPostRetweets`	Get retweets of a tweet
`getTwitterPostQuotes`	Get quote tweets
`getTwitterPostInteractingUsers`	Users who liked/retweeted a post
`countTweets`	Count tweets matching a query (hourly/daily buckets)
`checkOperationStatus`	Poll async export operations
`cancelOperation`	Cancel a running operation

Instagram (9 tools)

Tool	Description
`searchInstagramUsers`	Find users by name or username
`getInstagramUser`	Get profile details and metrics
`getInstagramUsersByKeywords`	Discover users posting about topics
`getInstagramUserConnections`	Get followers or following list
`getInstagramPostsByKeywords`	Search posts by keywords or hashtags
`getInstagramPostsByUser`	Get posts from a specific user
`getInstagramPostsByIds`	Fetch specific posts by ID
`getInstagramPostInteractingUsers`	Users who liked/commented on a post
`getInstagramCommentsByPostId`	Get comments on a post

Reddit (9 tools)

Tool	Description
`searchRedditUsers`	Find users by name
`getRedditUser`	Get user profile and karma
`getRedditUsersByKeywords`	Discover users active in topics
`getRedditPostsByKeywords`	Search posts across subreddits
`getRedditPostWithCommentsById`	Get a post with its comment tree
`getRedditCommentsByKeywords`	Search comments by keywords
`searchRedditSubreddits`	Find subreddits by name
`getRedditSubredditWithPostsByName`	Get a subreddit's metadata and recent posts
`getRedditSubredditsByKeywords`	Discover subreddits by topic

TikTok (7 tools)

Tool	Description
`searchTiktokUsers`	Find creators by name or username
`getTiktokUser`	Get creator profile (followers, likes, bio, verification)
`getTiktokUsersByKeywords`	Discover creators by topic in their post history
`getTiktokPostsByKeywords`	Search videos by keywords or hashtags
`getTiktokPostsByUser`	Get videos posted by a specific creator
`getTiktokPostsByIds`	Fetch specific videos by ID
`getTiktokCommentsByPostId`	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
`addTrackedItems`	Subscribe to ongoing monitoring of a query, user, or subreddit across any platform
`getTrackedItems`	List your active tracked items with last-update timestamps
`removeTrackedItems`	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: true bypasses cache for real-time data
Async 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	https://www.xpoz.ai/.well-known/mcp.json
MCP tool catalog (descriptions + JSON-Schema parameters)	https://www.xpoz.ai/.well-known/mcp/tools.json
Agent Skills index (agentskills.io v0.2.0)	https://www.xpoz.ai/.well-known/agent-skills/index.json
`llms.txt`	https://www.xpoz.ai/llms.txt
`llms-full.txt`	https://www.xpoz.ai/llms-full.txt
`discovery.txt`	https://www.xpoz.ai/discovery.txt
Webhooks contract	https://www.xpoz.ai/webhooks
Rate limits & 429 contract	https://www.xpoz.ai/rate-limits

License

This repository contains configuration and documentation only. The Xpoz MCP server is a hosted service — see Terms of Service.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessUnresponsive

Resources

Need Help?

Related Servers

Related MCP Connectors

social-dataOAuth
com.superagnt
Live social media data for AI agents: X, LinkedIn, Instagram, TikTok, YouTube, Reddit, Facebook.
Social Media
1
superagntOAuth
com.superagnt
AI agent toolkit: live social media data, lead enrichment + email finder, Postgres DB, webhooks.
Social Media Databases Email
1
SocialData
tools.socialdata
Twitter (X) API alternative for AI agents: tweet search, profiles, followers. $0.0002 per result.
Social Media Search
1
x-twitter-dataOAuth
com.superagnt
X (Twitter) data for AI agents: tweets, profiles, followers, search, trends + social listening.
Social Media Search
1

Related MCP Servers

Spectre
Social Media Communication
pranrichh
A
license
Not graded
quality
C
maintenance
Enables AI agents to fully automate X/Twitter interactions including searching, posting, engaging, and managing multiple accounts without paid API keys.
Updated 4 months ago (2026-06-22 12:05 UTC)
MIT
X-Trend Intelligence MCP
Social Media Marketing
mwaxman1
F
license
Not graded
quality
C
maintenance
Provides social intelligence tools for AI agents to analyze competitor sentiment, trends, and brand mentions from X/Twitter data.
Updated 2 months ago (2026-08-07 01:55 UTC)
-
socialcrawl-mcp
Social Media Search
RidioDevelopment
A
license
A
quality
D
maintenance
Provides AI agents with unified access to 21 social media platforms and 105 endpoints for retrieving profiles, posts, comments, search results, trending content, and analytics without per-platform authentication.
Updated 6 months ago (2026-04-10 13:53 UTC)
4
576 npm
MIT
Social Fetch MCPofficial
Social Media Web Scraping
social-freak-ltd
A
license
Not graded
quality
D
maintenance
Lets coding agents fetch real social media and web data from platforms like TikTok, Instagram, YouTube, and more, directly inside editors like Cursor and VS Code.
Updated 4 months ago (2026-06-01 10:22 UTC)
1
MIT

Xpoz MCP Server

Quick Start

Claude Desktop / Cursor / Windsurf

Claude Code, Codex, Gemini CLI

OpenClaw

Docker (stdio-only clients)

SDKs & CLI

TypeScript / Node.js

Python

CLI

Platforms & Tools

Twitter / X (14 tools)

Instagram (9 tools)

Reddit (9 tools)

TikTok (7 tools)

Tracking & Monitoring (3 tools)

Key Features

Use Cases

Discovery surfaces (for AI agents and scanners)

Links

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Spectre

X-Trend Intelligence MCP

socialcrawl-mcp

Social Fetch MCPofficial