Twitterapi Io Mcp Server

Name: Twitterapi Io Mcp Server
Author: kaitoInfra

@kaitoInfra

Repository

About Twitterapi Io Mcp Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Twitterapi Io Mcp Server?

Official Model Context Protocol server for twitterapi.io, a Twitter/X data API. It connects Claude Desktop, Cursor, VS Code Copilot, or any MCP client to 12 read-only tools for searching tweets, fetching user profiles, followers, replies, trends, and more using natural language.

How to use Twitterapi Io Mcp Server?

Get a free API key from twitterapi.io, then configure your MCP client (Claude Desktop, Cursor, VS Code, Claude Code) by adding a JSON block with npx -y @twitterapi_io/mcp-server and the TWITTERAPI_IO_API_KEY environment variable. Once configured, use natural language prompts in any MCP-enabled chat — the client automatically selects the right tool.

Key features of Twitterapi Io Mcp Server

12 read-only tools mapped to twitterapi.io’s verified endpoints.
Advanced search with Twitter operators (from:, since:, lang:, etc.).
Paginated results via next_cursor field.
Automatic retry with exponential backoff on 429/5xx errors.
30-second network timeout per request.

Use cases of Twitterapi Io Mcp Server

Search recent tweets with complex operators.
Get detailed user profiles and about pages.
Fetch followers and followings with full metadata.
Retrieve replies, quotes, retweeters, and mentions.
Discover trending topics by location (WOEID).

FAQ from Twitterapi Io Mcp Server

What tools does Twitterapi Io Mcp Server provide?

Twelve tools: search_tweets, get_user_info, get_user_about, get_user_followers, get_user_followings, get_user_last_tweets, get_user_mentions, get_tweets_by_ids, get_tweet_replies, get_tweet_quotes, get_tweet_retweeters, and get_trends.

How is authentication handled?

Authentication uses the TWITTERAPI_IO_API_KEY environment variable. The server never stores or logs the key; each tool call sends it in the X-API-Key header to https://api.twitterapi.io.

Does Twitterapi Io Mcp Server support pagination?

Yes. Tools that return lists include a next_cursor field. Pass it as the cursor argument on the next call to page through results (typically ~20 items per page).

What transport does Twitterapi Io Mcp Server use?

Currently uses stdio transport. Streamable HTTP is planned for v0.2+ for remote/hosted use.

Does Twitterapi Io Mcp Server allow writing (posting tweets, etc.)?

No. The server is intentionally read-only to keep it safe for autonomous agent use. Write endpoints (posting tweets, likes, follows, DMs, etc.) are excluded.