How do I install TwtAPI?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does TwtAPI need an API key?

No required environment variable is listed on this record.

TwtAPI

by io.github.TonyGJJ

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

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Server URL

https://mcp.twtapi.com/mcp

Provider

Add in Claude

Claude opens with the name and URL filled in. You still confirm it there.

Claude Code

claude mcp add --transport http io.github.tonygjj-twtapi https://mcp.twtapi.com/mcp

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.tonygjj-twtapi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.twtapi.com/mcp"
      ]
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

Related skills

View all

Questions

How do I install TwtAPI?: Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does TwtAPI need an API key?: No required environment variable is listed on this record.
What transport does TwtAPI use?: TwtAPI is reached over HTTP.
When was TwtAPI last checked?: Last checked 2026-10-16. Hosted Twitter/X tools for search, users, timelines, followers, trends, and research.

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

Create a free TwtAPI account at twtapi.com.
Open the MCP page in the dashboard and generate an sk- MCP key.
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

Client	Setup
Cursor	`examples/cursor.json`
Claude Code	`examples/claude-code.md`
Codex CLI	`examples/codex-cli.md`
Grok	`examples/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.