# TwittrAPI

> TwittrAPI is a freemium MCP server for web search and scraping. Read public Twitter/X profiles, tweets and search via TwittrAPI, no X developer account. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://www.twittrapi.com/docs/hosted-mcp
- **Repository:** https://github.com/twittrapi/twittrapi-mcp
- **MCP Registry name:** io.github.twittrapi/twittrapi-mcp
- **Categories:** web search and scraping, marketing and SEO
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.twittrapi.com/mcp
```

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

```json
{
  "mcpServers": {
    "twittrapi-mcp": {
      "url": "https://mcp.twittrapi.com/mcp"
    }
  }
}
```

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

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

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

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

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

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

## 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

- [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.
- [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.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/twittrapi
