# xdataapi: X (Twitter) data

Provides read-only access to public X (Twitter) profiles and search queries. Usage charges deduct credits per returned item without fixed subscriptions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: xdataapi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/xdataapi/xdataapi
- Updated: 2026-09-22
- HTML: https://affpapa.org/en/nevibecode/mcp/xdataapi-x-twitter-data

## What it does

This server connects coding agents to public X data through a remote HTTP endpoint at `https://api.xdataapi.io/mcp`. Built-in tools include `get_user`, `get_user_tweets`, `search_tweets`, `get_thread`, and `get_balance`. Queries accept standard search operators recognized by x.com.

Authentication handles OAuth automatically on first launch. For environments without OAuth support, clients pass an `x-api-key` HTTP header. Stdio-only clients can connect through the `mcp-remote` bridge package.

All available tools are strictly read-only, meaning the server cannot post updates or modify accounts. Every returned post or profile consumes one credit from a prepaid balance. Empty queries and network errors cost nothing.

## Requirements
- Remote server: `https://api.xdataapi.io/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http xdataapi https://api.xdataapi.io/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add xdataapi-x-twitter-data --url https://api.xdataapi.io/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xdataapi-x-twitter-data": {
            "url": "https://api.xdataapi.io/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "xdataapi-x-twitter-data": {
            "type": "http",
            "url": "https://api.xdataapi.io/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http xdataapi-x-twitter-data https://api.xdataapi.io/mcp
```

## When to use it
- fetch complete conversation threads by tweet ID
- search public posts on X using native query operators
- inspect profile details and follower lists for an account
- track remaining prepaid credits via `get_balance`

## Example prompts
- Search for recent posts from user `x` discussing AI agents.
- Fetch the entire reply thread for tweet ID `1234567890`.
- Check my remaining credit balance in xdataapi.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27844
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49863

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