Skip to main content
Glama
XPOZpublic

Xpoz MCP Server

Official
by XPOZpublic

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. 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/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 controlforceLatest: 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.

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity
Issues opened vs closed

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

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