# Xpoz MCP Server

> Xpoz is a Model Context Protocol (MCP) server that provides AI agents with real-time access to social media data from Twitter/X, Instagram, and Reddit (TikTok coming soon). Query 1.5B+ posts through natural language—no API keys required.

## Quick Start

- [Installation Guide](https://www.xpoz.ai/#install): Connect Xpoz to Claude, ChatGPT, or any MCP-compatible AI assistant in 2 minutes
- [MCP Server URL](https://mcp.xpoz.ai/mcp): Remote MCP endpoint for direct integration
- [Getting Started](https://help.xpoz.ai/en/collections/16124756-getting-started): Step-by-step setup tutorials

## Integration Guides

- [Claude.ai Web Integration](https://help.xpoz.ai/en/articles/12616835-connecting-xpoz-with-claude-ai-personal-account): Add Xpoz as a web connector in Claude.ai
- [Claude Desktop Setup](https://help.xpoz.ai/en/articles/12616835-connecting-xpoz-with-claude-ai-personal-account): Configure Claude Desktop with Xpoz MCP
- [Claude Code CLI](https://help.xpoz.ai/en/articles/12617533-connecting-xpoz-with-claude-code): Use Xpoz in command-line workflows
- [ChatGPT Integration](https://www.xpoz.ai/#install): Connect via remote MCP server URL

## Claude Skills (Pre-built Workflows)

- [Brand Snapshot](https://www.xpoz.ai/apps/claude-skills/brand-snapshot/): Get deep brand intelligence with `/brand-snapshot [BRAND]`
- [Brand Competition](https://www.xpoz.ai/apps/claude-skills/brand-competition/): Compare brands with `/brand-competition [YOUR_BRAND] vs [COMPETITOR]`
- [Brand Influencers](https://www.xpoz.ai/apps/claude-skills/brand-influencers/): Discover influencers with `/brand-influencers [BRAND]`

## OpenClaw Skills (ClawHub Marketplace)

- [Social Search](https://www.xpoz.ai/apps/openclaw-skills/xpoz-social-search/): Search Twitter, Instagram, Reddit, and TikTok in real-time from one tool ([ClawHub](https://clawhub.ai/skills/xpoz/xpoz-social-search))
- [Social Sentiment](https://www.xpoz.ai/apps/openclaw-skills/social-sentiment/): AI-powered sentiment analysis across social platforms ([ClawHub](https://clawhub.ai/skills/xpoz/social-sentiment))
- [Lead Generation](https://www.xpoz.ai/apps/openclaw-skills/lead-generation/): Find high-intent buyers on Twitter and Reddit ([ClawHub](https://clawhub.ai/skills/xpoz/lead-generation))
- [XPOZ Setup](https://www.xpoz.ai/apps/openclaw-skills/xpoz-setup/): Guided setup for connecting XPOZ to Claude or ChatGPT ([ClawHub](https://clawhub.ai/skills/xpoz/xpoz-setup))
- [Expert Finder](https://www.xpoz.ai/apps/openclaw-skills/expert-finder/): Discover industry experts and thought leaders on Twitter and Reddit ([ClawHub](https://clawhub.ai/skills/xpoz/expert-finder))
- [Twitter API Alternative](https://www.xpoz.ai/apps/openclaw-skills/twitter-api-alternative/): Search 1B+ tweets without an API key ([ClawHub](https://clawhub.ai/skills/xpoz/twitter-api-alternative))
- [Social Intelligence](https://www.xpoz.ai/apps/openclaw-skills/social-intelligence/): AI-powered social media research across platforms ([ClawHub](https://clawhub.ai/skills/xpoz/social-intelligence))
- [Reddit Search](https://www.xpoz.ai/apps/openclaw-skills/reddit-search/): Search 100M+ Reddit posts and comments ([ClawHub](https://clawhub.ai/skills/xpoz/reddit-search))
- [Instagram Search](https://www.xpoz.ai/apps/openclaw-skills/instagram-search/): Search 400M+ Instagram posts and Reels ([ClawHub](https://clawhub.ai/skills/xpoz/instagram-search))

## Available Tools

### Twitter/X Tools
- `getTwitterPostsByKeywords`: Search tweets by keywords, hashtags, or phrases with boolean operators
- `getTwitterPostsByAuthor`: Get all posts from a specific Twitter user
- `getTwitterPostsByIds`: Fetch specific tweets by ID
- `getTwitterUser`: Get user profile including followers, following, bio, verification status
- `getTwitterUserConnections`: Get followers or following lists for any user
- `getTwitterUsersByKeywords`: Find users who posted about specific topics
- `getTwitterPostComments`: Get replies to a specific tweet
- `getTwitterPostQuotes`: Get quote tweets of a post
- `getTwitterPostRetweets`: Get retweets of a post
- `getTwitterPostInteractingUsers`: Get users who commented, quoted, or retweeted a post
- `searchTwitterUsers`: Search for Twitter users by name
- `countTweets`: Count tweets matching a phrase within a date range

### Instagram Tools
- `getInstagramPostsByKeywords`: Search Instagram posts by keywords (captions and video subtitles)
- `getInstagramPostsByUser`: Get all posts from an Instagram user
- `getInstagramPostsByIds`: Fetch specific posts by ID
- `getInstagramUser`: Get user profile with follower counts, bio, verification
- `getInstagramUserConnections`: Get followers or following lists
- `getInstagramUsersByKeywords`: Find users who posted about specific topics
- `getInstagramCommentsByPostId`: Get comments on a post
- `getInstagramPostInteractingUsers`: Get users who commented or liked a post
- `searchInstagramUsers`: Search for Instagram users by name

### Reddit Tools
- `getRedditPostsByKeywords`: Search Reddit posts by keywords
- `getRedditCommentsByKeywords`: Search Reddit comments
- `getRedditPostWithCommentsById`: Get a post with all its comments
- `getRedditSubredditWithPostsByName`: Get subreddit info and posts
- `getRedditSubredditsByKeywords`: Find subreddits discussing specific topics
- `getRedditUser`: Get Reddit user profile with karma breakdown
- `getRedditUsersByKeywords`: Find users who posted about specific topics
- `searchRedditSubreddits`: Search for subreddits by name
- `searchRedditUsers`: Search for Reddit users

### Utility Tools
- `checkOperationStatus`: Check status of background operations and retrieve results
- `cancelOperation`: Cancel a running operation
- `checkAccessKeyStatus`: Verify API key status

## Pricing

- [Pricing Plans](https://www.xpoz.ai/pricing): Free tier (100K results/month), Pro ($20/month, 1M results), Max ($200/month, 10M results)

## Use Cases

### By Industry
- [Finance & Trading](https://www.xpoz.ai/use-cases/finance/): Market signals, crypto sentiment, trading intelligence
- [Security & OSINT](https://www.xpoz.ai/use-cases/security/): Threat detection, vulnerability intel, bot networks
- [Sales Development](https://www.xpoz.ai/use-cases/sales/): Lead discovery, buyer signals, prospect research
- [Crisis Management](https://www.xpoz.ai/use-cases/crisis-management/): Brand monitoring, PR response, reputation management
- [Developer Relations](https://www.xpoz.ai/use-cases/devrel/): Community intelligence, developer sentiment

### Popular Recipes
- [Detect Market-Moving Tweets](https://www.xpoz.ai/use-cases/detect-market-moving-tweets-before-the-market-does/)
- [Find Buyers Before Competitors](https://www.xpoz.ai/use-cases/find-buyers-before-they-find-competitors/)
- [Real-time Crisis Detection](https://www.xpoz.ai/use-cases/detect-and-respond-to-crises-in-real-time/)
- [Track Competitor Strategy](https://www.xpoz.ai/use-cases/track-competitor-social-media-strategy/)

## Tutorials

- [How to Query Twitter with Claude AI](https://www.xpoz.ai/blog/tutorials/how-to-query-twitter-with-claude-ai-mcp/)
- [Extract Reddit Data for Market Research](https://www.xpoz.ai/blog/tutorials/how-to-extract-reddit-data-for-market-research/)
- [Build a Social Listening Dashboard](https://www.xpoz.ai/blog/tutorials/how-to-build-a-social-listening-dashboard/)
- [All Tutorials](https://www.xpoz.ai/blog/tutorials/)

## Technical Details

- [About Xpoz](https://www.xpoz.ai/about): Architecture and mission
- [FAQ](https://www.xpoz.ai/#faq): Common questions answered
- [Troubleshooting](https://help.xpoz.ai/en/collections/16124757-troubleshooting): Solutions to common issues

## Blog

- [Blog](https://www.xpoz.ai/blog): Tutorials, comparisons, and best practices
- [Sample Queries](https://help.xpoz.ai/en/collections/16127999-samples): Example queries and use cases

## Support

- Email: support@xpoz.ai
- Help Center: https://help.xpoz.ai
- Twitter: https://x.com/XPOZAI
- LinkedIn: https://linkedin.com/company/xpozinc
- YouTube: https://www.youtube.com/@xpoz-ai