Skip to main content
Glama
XPOZpublic

Xpoz MCP Server

Official
by XPOZpublic
OverviewSchemaSourceRelated ServersDiscussionsAdmin
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: Spectre

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

Links

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

Related MCP Connectors

Related MCP Servers

  • Spectre

    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.
    MIT

  • socialcrawl-mcp

    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.
    4
    318 npm
    MIT