Skip to content
MCP server

TwittrAPI

Read public Twitter/X profiles, tweets and search via TwittrAPI, no X developer account

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
1.2.0
Listing updated
2 days ago

About TwittrAPI

TwittrAPI is a freemium MCP server for web search and scraping. It can run locally on your machine or as a hosted remote server.

This server is a front end to TwittrAPI, a paid REST API for public X data, so every tool call is one billed call on your TwittrAPI balance. Besides profiles, tweets, followers and search, the docs mention lists, communities and trends. Results come back in a compact simple format by default to save tokens, or raw GraphQL JSON if you choose.

It can run hosted or locally. The hosted endpoint at mcp.twittrapi.com/mcp (note the /mcp) signs in with OAuth or an API key header and works with Claude, ChatGPT, Claude Code, Cursor and VS Code. The npm package twittrapi-mcp runs over stdio and needs Node 20 or newer and either a TwittrAPI key or a RapidAPI key.

By default it only reads public data. If you supply your own X session cookie and proxy, extra account tools appear for posting, likes, follows, DMs, lists and drafts on your own account. The site states it is not affiliated with X Corp.

Install

Run in a terminal

claude mcp add --transport http twittrapi-mcp https://mcp.twittrapi.com/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.twittrapi.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "twittrapi-mcp": {
      "url": "https://mcp.twittrapi.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "twittrapi-mcp": {
      "type": "http",
      "url": "https://mcp.twittrapi.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "twittrapi-mcp": {
      "serverUrl": "https://mcp.twittrapi.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "twittrapi-mcp": {
      "type": "http",
      "url": "https://mcp.twittrapi.com/mcp"
    }
  }
}

Configuration

  • TWITTRAPI_API_KEYYour TwittrAPI key. Set this or RAPIDAPI_KEY.
  • RAPIDAPI_KEYRapidAPI key for the Twitter AIO API. Used when TWITTRAPI_API_KEY is not set.
  • RAPIDAPI_HOSTHost of your TwittrAPI listing on RapidAPI. Change it if you subscribed to another listing.
  • TWITTRAPI_BASE_URLOverride the API base URL.
  • TWITTRAPI_RESPONSE_FORMATFormat of tool results: simple (compact JSON, far fewer tokens) or raw (X's full GraphQL JSON). Tools also take a format argument.
  • TWITTRAPI_X_COOKIECookie of your own logged-in x.com session (auth_token, ct0, twid). With TWITTRAPI_X_PROXY set, adds the account tools (post, like, follow, DMs, lists, drafts).
  • TWITTRAPI_X_PROXYYour proxy for the account tools, http://user:pass@host:port.
  • TWITTRAPI_X_CHAT_PASSCODEYour X Chat passcode. Adds send_dm and message text in the DM inbox.

What it does

Public X data
Profiles, tweets, followers, search, lists, communities and trends.
No X developer account
Authentication uses a TwittrAPI key or a RapidAPI key instead.
Compact results
A simple format uses fewer tokens; raw GraphQL JSON is optional.
Hosted or local
Remote OAuth endpoint, or the twittrapi-mcp package over stdio.
Account tools
With your own X session and proxy, it can post, like, follow and send DMs.
Billing per call
Each tool call is billed to your balance at your normal rate.

Good for

  • Pull a profile and recent tweets into an assistant's answer
  • Search X for mentions of a topic and summarise them
  • List a user's followers for audience research
  • Track communities or trends from a chat
  • Post or reply from your own account via an agent

Pricing

Freemium

Pay per call from $0.10 per 1,000 calls; $0.50 test credit; RapidAPI plans from free (75 requests/month) to $125/month

Prices change. Check twittrapi.com before you buy.

TwittrAPI FAQ

Do I need an X developer account?

No.

How is it billed?

Each tool call is one billed API call. TwittrAPI lists $0.10 per 1,000 calls at the standard tier, with $0.50 of test credit for new accounts, and RapidAPI plans from a free 75-request tier.

Which clients work with the hosted server?

Claude, ChatGPT, Claude Code, Cursor and VS Code; any client with Streamable HTTP support.

What is the correct URL?

https://mcp.twittrapi.com/mcp, with /mcp at the end.

Can it post for me?

Yes, once you provide your own X session cookie and a proxy; otherwise it is read-only.

Is TwittrAPI free?

TwittrAPI has a free plan, with paid plans for more usage or features.

How do I add TwittrAPI to Claude Code?

Run this command in your terminal: claude mcp add --transport http twittrapi-mcp https://mcp.twittrapi.com/mcp

What are the best alternatives to TwittrAPI?

The closest alternatives to TwittrAPI are Scrapling MCP Server, Firecrawl MCP Server, Google Ads + Meta Ads + SEO/GEO MCP, SearXNG Search and Calven.

Alternatives to TwittrAPI

  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. 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
  4. 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
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping