Skip to content
MCP server

Twitterapi Io MCP Server

Twitter/X tweets, users, followers and trends for AI agents through twitterapi.io

Runs locallyStatus and history
Install
Pricing
Free trial
Platforms
API, CLI
Runs
Locally
Version
0.2.1
Listing updated
1 day ago

About Twitterapi Io MCP Server

Twitterapi Io MCP Server is an MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • TWITTERAPI_IO_API_KEYYour twitterapi.io API key — get from https://twitterapi.io dashboardRequired

What it does

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

Pricing

Free trial

Pay per result from $0.00015 per request; up to $1 free credits for new accounts

Prices change. Check twitterapi.io before you buy.

Twitterapi Io MCP Server 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 to Twitterapi Io MCP Server

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  4. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  5. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  6. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments