# xdataapi MCP server

> Allows AI clients to access read-only public X (Twitter) data including profiles, tweets, threads, followers, and search results.

- Repository: https://github.com/xdataapi/xdataapi
- Page: https://hostedmcp.org/servers/xdataapi/xdataapi
- Transport: remote
- Stars: 1
- License: MIT
- Latest version: 0.3.2

## Install

### Claude Code

```sh
claude mcp add --transport http xdataapi https://api.xdataapi.io/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "xdataapi": {
      "url": "https://api.xdataapi.io/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "xdataapi": {
      "type": "http",
      "url": "https://api.xdataapi.io/mcp"
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.xdataapi]
url = "https://api.xdataapi.io/mcp"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "xdataapi": {
      "httpUrl": "https://api.xdataapi.io/mcp"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `XDATAAPI_KEY` | no | no |  |

## FAQ

### What kind of data can I access?

You can access read-only public X (Twitter) data such as profiles, tweets, timelines, threads, followers, and search using x.com operators.

### How much does it cost to use the API?

The service uses a credit system where one credit is charged per tweet or profile returned; empty results and errors are free.

### How do I authenticate with the MCP server?

The server signs you in with OAuth on first use, or you can pass an API key via headers for clients that do not support OAuth.

### Can I write or post to X using this server?

No, the server is strictly for reading public data and contains no write endpoints.