# Twitterapi Io MCP Server

> Twitterapi Io MCP Server is an MCP server for analytics and data. Twitter/X tweets, users, followers and trends for AI agents through twitterapi.io. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, CLI
- **Website:** https://twitterapi.io
- **Repository:** https://github.com/kaitoinfra/twitterapi-io-mcp-server
- **MCP Registry name:** io.github.kaitoInfra/twitterapi-io-mcp-server
- **Categories:** analytics and data, web search and scraping
- **Listing updated:** 2026-11-16

## About

This is the official stdio server from twitterapi.io, installed from npm as @twitterapi_io/mcp-server, and it needs a TWITTERAPI_IO_API_KEY from the service's dashboard. It passes through the provider's REST API, which is described as covering 75 endpoints for public data from X.

That API handles advanced tweet search with query filters and date windows, user timelines and mentions, profiles (singly or batched by ID), the follower graph, reply and quote trees, retweeters, trending topics by region, lists and communities. Real-time delivery by webhook filter rules and WebSocket streams is part of the underlying service.

Billing is per result returned, with a minimum of $0.00015 per request and volume discounts on batch profile and follower calls. New accounts can claim up to $1 in free credits without a card, and credits are bought as you go or through subscriptions. The credit rate is $1 for 100,000 credits.

## Features

- **Tweet search:** Advanced search with query filters, date windows and bulk sub-queries.
- **User timelines:** Latest tweets, mentions and history for public accounts.
- **Profiles:** User info and bios, singly or batched by ID.
- **Follower graph:** Followers, followings and follower IDs with page-size scaling.
- **Reply and quote trees:** Replies, quotes and retweeter lists for any tweet.
- **Trends and lists:** Trending topics by region, plus list members and communities.

## Good for

- Let an assistant search recent posts on a topic
- Pull a public account's timeline or mentions into a report
- Map an account's followers for audience research
- Track trending topics by region
- Monitor accounts through webhook or stream rules

## Install

### Claude Code (Terminal)

```sh
claude mcp add twitterapi-io-mcp-server --env TWITTERAPI_IO_API_KEY='<TWITTERAPI_IO_API_KEY>' -- npx -y @twitterapi_io/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "twitterapi-io-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@twitterapi_io/mcp-server"
      ],
      "env": {
        "TWITTERAPI_IO_API_KEY": "<TWITTERAPI_IO_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "twitterapi-io-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@twitterapi_io/mcp-server"
      ],
      "env": {
        "TWITTERAPI_IO_API_KEY": "<TWITTERAPI_IO_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "twitterapi-io-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@twitterapi_io/mcp-server"
      ],
      "env": {
        "TWITTERAPI_IO_API_KEY": "<TWITTERAPI_IO_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "twitterapi-io-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@twitterapi_io/mcp-server"
      ],
      "env": {
        "TWITTERAPI_IO_API_KEY": "<TWITTERAPI_IO_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "twitterapi-io-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@twitterapi_io/mcp-server"
      ],
      "env": {
        "TWITTERAPI_IO_API_KEY": "<TWITTERAPI_IO_API_KEY>"
      }
    }
  }
}
```

## FAQ

### How do I get an API key?

Sign in with Google on twitterapi.io; the site says no card or project approval is needed.

### How is usage billed?

Per result returned, with a $0.00015 minimum per request, and 1 USD equals 100,000 credits.

### Are there free credits?

New accounts get up to $1 of free credits, which expire after 31 days.

### Can I use it in commercial projects?

The FAQ says yes, subject to its Terms of Service and Acceptable Use Policy.

### Is Twitterapi Io MCP Server free?

Twitterapi Io MCP Server is a paid product with a free trial.

### How do I add Twitterapi Io MCP Server to Claude Code?

Run this command in your terminal: claude mcp add twitterapi-io-mcp-server --env TWITTERAPI_IO_API_KEY='<TWITTERAPI_IO_API_KEY>' -- npx -y @twitterapi_io/mcp-server

### What are the best alternatives to Twitterapi Io MCP Server?

The closest alternatives to Twitterapi Io MCP Server are Scrapling MCP Server, Firecrawl MCP Server, Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP and SearXNG Search.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/twitterapi-io-mcp-server
