# xpoz

xpoz queries Twitter/X, Instagram, Reddit, and TikTok directly from your assistant to extract social posts and metrics.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 4846 installs
- Author: net-service
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/net-service/xpoz
- Updated: 2025-11-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/xpoz

## What it does

This server connects AI assistants to social platform data without requiring individual developer keys. It handles user lookups, keyword searches across post archives, follower extractions, and comment threads. Datasets can also be pulled into CSV files.

Most queries execute as background jobs that return an `operationId`, requiring the client to poll `checkOperationStatus` for the payload. Results arrive paginated at 100 records per page, while bulk data dumps deliver signed S3 download links.

## Requirements
- Remote server: `https://xpoz--net-service.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http xpoz https://xpoz--net-service.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add xpoz --url https://xpoz--net-service.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xpoz": {
            "url": "https://xpoz--net-service.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "xpoz": {
            "type": "http",
            "url": "https://xpoz--net-service.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http xpoz https://xpoz--net-service.run.tools
```

## When to use it
- search Twitter/X posts using boolean keywords and phrases
- inspect Instagram accounts, captions, and engagement figures
- fetch retweets, quotes, or replies for specific social posts
- track and retrieve background query dumps via checkOperationStatus

## Example prompts
- Count how many tweets mentioned our brand name during the last month
- Retrieve the profile details and recent updates for handle elonmusk on Twitter
- Look up comments on Instagram post ID 123456789 and check operation status

## Similar
- [Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)](https://affpapa.org/en/nevibecode/mcp/social-media-search-api-twitter-instagram-reddit-tiktok-xpoz.md) — MCP server · ★ 13 repo stars
- [social-scraping](https://affpapa.org/en/nevibecode/skills/social-scraping.md) — skill · 311 installs
- [ProLevelMax](https://affpapa.org/en/nevibecode/mcp/prolevelmax.md) — MCP server
- [WoopSocial Social Media MCP](https://affpapa.org/en/nevibecode/mcp/woopsocial-social-media-mcp.md) — MCP server · ★ 2 repo stars
- [mcp](https://affpapa.org/en/nevibecode/mcp/rolliinc-mcp.md) — MCP server · ★ 2 repo stars
- [tracking-brand-sentiment-across-platforms](https://affpapa.org/en/nevibecode/skills/tracking-brand-sentiment-across-platforms.md) — skill · 918 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
