About TwtAPI
TwtAPI is a hosted MCP server that gives compatible clients tools for querying public Twitter/X data. It requires no local runtime to install or maintain and supports searches, user lookups, timelines, followers, and trend research.
Key features
- 01Search public Twitter/X data
- 02Look up users and timelines
- 03Retrieve followers and tweet details
- 04Access trend data
- 05Connect to a hosted service without a local runtime
Use cases
- 01Research public posts from an MCP client
- 02Review a user's timeline and followers
- 03Inspect tweet details and track trends
MCP support
It provides a hosted MCP server over Streamable HTTP, with SSE also available for clients that do not support that transport. Clients authenticate with an MCP key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.twtapi.com/mcpclaude mcp add --transport http tonygjj-twtapi https://mcp.twtapi.com/mcp{"mcpServers":{"tonygjj-twtapi":{"type":"http","url":"https://mcp.twtapi.com/mcp"}}}Open in Cursor{"servers":{"tonygjj-twtapi":{"type":"http","url":"https://mcp.twtapi.com/mcp"}}}Open in VS Code{"mcpServers":{"tonygjj-twtapi":{"type":"http","url":"https://mcp.twtapi.com/mcp"}}}{"mcpServers":{"tonygjj-twtapi":{"serverUrl":"https://mcp.twtapi.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://mcp.twtapi.com/mcpAuth requiredhttps://mcp.twtapi.com/sse?mcp_key={mcp_key}Tools
Details
From the project READMETwtAPI 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
- Authentication
- Tool reference
- Troubleshooting
- TwtAPI MCP setup page
- TwtAPI API documentation
- Pricing
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.