llms.txt Content
# twitterapi.io
> twitterapi.io is a Twitter/X data API for AI agents and developers. Search tweets, fetch user profiles, get followers/following, replies, retweeters, trends, and perform authenticated actions (post, like, follow, DM) via a single `x-api-key` header — no OAuth, no Twitter Developer approval, no rate-limit hell.
## What it is
Pay-per-call REST API on top of normalized Twitter/X data. Three product surfaces, one billing model (free tier on signup):
1. **REST API** — `api.twitterapi.io` — read/write tweets, users, followers, communities, lists, DMs. Verified against live X.
2. **Stream Service** — webhook + WebSocket — push new tweets matching keywords or user filters within seconds.
3. **MCP Server** — `mcp.twitterapi.io/mcp` — same 12 read tools exposed as MCP tools for Claude.ai, Claude Code, Cursor, Gemini CLI, ChatGPT (via custom connectors).
## For AI agents
- **MCP manifest**: <https://twitterapi.io/.well-known/mcp.json>
- **MCP tools catalog**: <https://twitterapi.io/.well-known/mcp/tools.json>
- **Agent Skills index**: <https://twitterapi.io/.well-known/agent-skills/index.json>
- **Long-form docs**: <https://twitterapi.io/llms-full.txt>
- **Discovery pointer**: <https://twitterapi.io/discovery.txt>
## Install / Connect
### Claude.ai Web Connector
Settings → Connectors → Add custom connector → URL `https://mcp.twitterapi.io/mcp` → paste your twitterapi.io API key when prompted.
### Claude Code CLI
```
claude mcp add --transport http --scope user twitterapi-mcp \
https://mcp.twitterapi.io/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
```
### Stdio (Claude Desktop)
```
npx -y @twitterapi_io/mcp-server
```
Set `TWITTERAPI_IO_API_KEY` env var.
### Anthropic Skill (any agent that reads SKILL.md)
```
npx skills add kaitoInfra/twitterapi-io
```
## Pricing
Pay per request, no monthly minimum, free tier on signup.
| Operation | Price |
|---|---|
| Tweet read (advanced search, by id, replies) | $0.15 / 1,000
OpenAPI Spec (preview)
{
"x-comment": "TwitterAPI.io OpenAPI Specification - This file defines the API endpoints for the TwitterAPI.io service.",
"openapi": "3.0.1",
"info": {
"title": "TwitterAPI.io the most stable/fastest/cheapest twitter api.",
"description": "Provide the most stable/fastest/cheapest twitter api.",
"license": {
"name": "MIT"
},
"version": "1.0.0"
},
"servers": [
{
"url": "https://api.twitterapi.io"
}
],
"security": [
{
"ApiKeyAuth": []