# TwitterAPIs

TwitterAPIs is a Claude Code MCP server that connects models to Twitter data without an X developer account. It enables tweet search, audience analytics, and automated posting.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: TwitterAPIs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TwitterAPIs/twitterapis-mcp
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/twitterapis

## What it does

The server connects clients directly to twitterapis.com endpoints, providing 120 tools divided into 71 reading and 49 writing operations. Agents can execute advanced searches using standard X syntax, retrieve follower lists, inspect profiles, and follow conversations. To keep token consumption low, read endpoints accept a `fields` filter and a `compact` mode.

Public lookups require only a `TWITTERAPIS_KEY`. Accounts receive 0.50 dollars in starting credits without entering payment card details, with standard reads billed at 0.0008 dollars per call and tweet creation at 0.0016 dollars.

Personal operations such as reading direct messages or posting tweets require account authentication via saved cookies, login, or inline credentials. Sending writes through a residential proxy via `proxy_url` prevents soft blocks triggered by datacenter IP addresses.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.twitterapis.com/mcp`
- Environment variables: `TWITTERAPIS_KEY`, `TWITTERAPIS_BASE_URL`, `TWITTERAPIS_TIMEOUT_MS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http twitterapis-mcp https://api.twitterapis.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env TWITTERAPIS_KEY=<TWITTERAPIS_KEY> --env TWITTERAPIS_BASE_URL=<TWITTERAPIS_BASE_URL> --env TWITTERAPIS_TIMEOUT_MS=<TWITTERAPIS_TIMEOUT_MS> --transport stdio twitterapis -- npx -y @twitterapis/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add twitterapis --url https://api.twitterapis.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add twitterapis --env TWITTERAPIS_KEY=<TWITTERAPIS_KEY> --env TWITTERAPIS_BASE_URL=<TWITTERAPIS_BASE_URL> --env TWITTERAPIS_TIMEOUT_MS=<TWITTERAPIS_TIMEOUT_MS> -- npx -y @twitterapis/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "twitterapis": {
            "url": "https://api.twitterapis.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "twitterapis": {
            "command": "npx",
            "args": [
                "-y",
                "@twitterapis/mcp"
            ],
            "env": {
                "TWITTERAPIS_KEY": "<TWITTERAPIS_KEY>",
                "TWITTERAPIS_BASE_URL": "<TWITTERAPIS_BASE_URL>",
                "TWITTERAPIS_TIMEOUT_MS": "<TWITTERAPIS_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "twitterapis": {
            "type": "http",
            "url": "https://api.twitterapis.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "twitterapis": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@twitterapis/mcp"
            ],
            "env": {
                "TWITTERAPIS_KEY": "<TWITTERAPIS_KEY>",
                "TWITTERAPIS_BASE_URL": "<TWITTERAPIS_BASE_URL>",
                "TWITTERAPIS_TIMEOUT_MS": "<TWITTERAPIS_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http twitterapis https://api.twitterapis.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e TWITTERAPIS_KEY=<TWITTERAPIS_KEY> -e TWITTERAPIS_BASE_URL=<TWITTERAPIS_BASE_URL> -e TWITTERAPIS_TIMEOUT_MS=<TWITTERAPIS_TIMEOUT_MS> twitterapis npx -y @twitterapis/mcp
```
Replace <…> with your own values

## When to use it
- search posts using advanced search operators and date filters
- audit account followers and check the estimated bot ratio
- publish posts and replies without subscribing to the official X API
- fetch complete user timelines with automated cursor pagination

## Example prompts
- Search for recent posts mentioning claude code with min_faves:50
- Inspect the audience breakdown and bot share for account openai
- Post a status update using my active TwitterAPIs session

## Similar
- [x-twitter-scraper](https://affpapa.org/en/nevibecode/skills/davepoon-x-twitter-scraper.md) — skill · 107 installs
- [x-post](https://affpapa.org/en/nevibecode/skills/rameerez-x-post.md) — skill · ★ 32 repo stars
- [tracking-competitor-social-media-growth](https://affpapa.org/en/nevibecode/skills/tracking-competitor-social-media-growth.md) — skill · 919 installs
- [xdataapi: X (Twitter) data](https://affpapa.org/en/nevibecode/mcp/xdataapi-x-twitter-data.md) — MCP server · ★ 1 repo stars
- [twitter](https://affpapa.org/en/nevibecode/skills/twitter.md) — skill · 7900 installs
- [building-full-social-audit-for-brand](https://affpapa.org/en/nevibecode/skills/building-full-social-audit-for-brand.md) — skill · 962 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
