How do I install Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) need an API key?

No required environment variable is listed on this record.

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

Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) is reached over HTTP.

When was Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) last checked?

Last checked 2026-11-07. Twitter/X, Instagram, Reddit & TikTok data for AI agents. Billions of posts. No API keys.

Social Media Search API — Twitter, Instagram MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.xpoz.ai/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http ai.xpoz-social-insights https://mcp.xpoz.ai/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "ai.xpoz-social-insights": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.xpoz.ai/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.4.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

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.

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

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)?

Does Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) need an API key?

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

When was Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) last checked?

Documentation

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