English Français العربية

TwtAPI

Official registry Search and web

Hosted Twitter/X tools for search, users, timelines, followers, trends, and research.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http twtapi 'https://mcp.twtapi.com/mcp' --header 'Authorization: <Bearer token using your TwtAPI MCP key, for example: Bearer sk-your-mcp-key>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "twtapi": {
            "type": "http",
            "url": "https://mcp.twtapi.com/mcp",
            "headers": {
                "Authorization": "<Bearer token using your TwtAPI MCP key, for example: Bearer sk-your-mcp-key>"
            }
        }
    }
}
Remote (sse)
Claude Code 
claude mcp add --transport sse twtapi 'https://mcp.twtapi.com/sse?mcp_key={mcp_key}'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "twtapi": {
            "type": "sse",
            "url": "https://mcp.twtapi.com/sse?mcp_key={mcp_key}"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. TwtAPI MCP Server
  2. Quick start
  3. Client setup
  4. Available tools
  5. Documentation
  6. Health check
  7. Security

TwtAPI MCP Server

Use public Twitter/X data from Cursor, Claude Code, Codex CLI, Grok, or any compatible MCP client. TwtAPI hosts the server, so there is no local runtime to install or maintain.

Quick start

  1. Create a free TwtAPI account at twtapi.com.
  2. Open the MCP page in the dashboard and generate an sk- MCP key.
  3. Pick a client configuration below and replace sk-your-mcp-key.

The recommended transport is Streamable HTTP:

https://mcp.twtapi.com/mcp

Send the MCP key as a bearer token:

Authorization: Bearer sk-your-mcp-key

SSE remains available for clients that do not yet support Streamable HTTP:

https://mcp.twtapi.com/sse?mcp_key=sk-your-mcp-key

Client setup

ClientSetup
Cursorexamples/cursor.json
Claude Codeexamples/claude-code.md
Codex CLIexamples/codex-cli.md
Grokexamples/grok.md

Available tools

The hosted server currently exposes 10 tools for search, user lookup, timelines, followers, tweet detail, and trends. See docs/tools.md for parameters and example prompts.

Documentation

Health check

curl https://mcp.twtapi.com/health

Expected response:

{"status":"ok","service":"twtapi-mcp"}

Security

Do not commit MCP keys to a repository. Prefer environment variables or your client's secret storage. Regenerate the key from the TwtAPI dashboard if it is exposed.

This repository contains public configuration and documentation for the hosted service. The production server implementation is maintained separately.

Frequently asked questions

What is TwtAPI?

Hosted Twitter/X tools for search, users, timelines, followers, trends, and research.

How do I install TwtAPI?

It runs as a remote server. In Claude Code: claude mcp add --transport http twtapi 'https://mcp.twtapi.com/mcp' --header 'Authorization: <Bearer token using your TwtAPI MCP key, for example: Bearer sk-your-mcp-key>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does TwtAPI need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is TwtAPI open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains TwtAPI?

It is published by TonyGJJ. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.