{
  "$comment": "MCP server discovery manifest for twitterapi.io. For agents/AI directories that want to find and inspect our MCP capabilities without going through OAuth.",
  "mcp_version": "2025-06-18",
  "server_name": "twitterapi.io MCP",
  "version": "0.1.0",
  "description": "Twitter/X data API as MCP tools \u2014 search tweets, lookup user profiles, fetch followers/following, replies, quotes, retweeters, trends. Read-only access to live Twitter via a single Bearer API key. Use this from Claude.ai, Claude Code, Cursor, or any MCP-compatible client.",
  "endpoint": "https://mcp.twitterapi.io/mcp",
  "transport": "streamable-http",
  "capabilities": {
    "tools": {
      "listChanged": false
    },
    "resources": false,
    "prompts": false,
    "sampling": false,
    "roots": false
  },
  "auth": {
    "type": "bearer",
    "header": "Authorization",
    "format": "Bearer <twitterapi.io api_key>",
    "oauth_protected_resource": "https://mcp.twitterapi.io/.well-known/oauth-protected-resource",
    "oauth_authorization_server": "https://mcp.twitterapi.io/.well-known/oauth-authorization-server",
    "get_key_url": "https://twitterapi.io",
    "free_tier_available": true
  },
  "tools_index": "https://twitterapi.io/.well-known/mcp/tools.json",
  "tools_count": 12,
  "tools_summary": [
    "search_tweets (Twitter advanced search syntax)",
    "get_user_info / get_user_about (profile lookup)",
    "get_user_followers / get_user_followings (paginated lists)",
    "get_user_last_tweets / get_user_mentions (timeline + mentions)",
    "get_tweets_by_ids (batch up to 100)",
    "get_tweet_replies / get_tweet_quotes / get_tweet_retweeters (conversation analysis)",
    "get_trends (by WOEID region)"
  ],
  "read_only": true,
  "open_world": true,
  "rate_limits": "Per-key, see https://twitterapi.io for current limits",
  "pricing": "Pay-per-call, no monthly minimum, free tier on signup",
  "support": {
    "homepage": "https://twitterapi.io",
    "docs": "https://twitterapi.io/docs",
    "email": "support@twitterapi.io"
  },
  "client_install": {
    "claude_ai_web": "Settings \u2192 Connectors \u2192 Add custom connector \u2192 paste https://mcp.twitterapi.io/mcp",
    "claude_code_cli": "claude mcp add --transport http --scope user twitterapi-mcp https://mcp.twitterapi.io/mcp --header \"Authorization: Bearer YOUR_API_KEY\"",
    "stdio_alternative": "npx -y @twitterapi_io/mcp-server (Claude Desktop)",
    "sdk_typescript": "npm install @twitterapi_io/twitterapi",
    "sdk_python": "pip install twitterapi-io"
  }
}