X MCP

About

X MCP es el servidor MCP oficial y alojado de X para conectar herramientas de IA compatibles con MCP a la X API. La documentación de X identifica el endpoint API MCP como https://api.x.com/mcp; los clientes locales basados en stdio suelen conectarse mediante el puente open-source xurl mcp.

Esta entrada corresponde al servidor X API MCP, no al X Docs MCP para búsqueda de documentación ni a proyectos comunitarios Twitter/X MCP con nombres parecidos.

Key Features

• Permite que herramientas compatibles con MCP llamen capacidades de la X API con los permisos de la cuenta X del usuario.
• Las áreas documentadas incluyen posts, full-archive search, user search, user lookup, timelines, mentions, bookmarks, bookmark folders, news, trends y Articles.
• Usa xurl para autenticación OAuth 2.0 con contexto de usuario, caché de tokens y renovación de tokens.
• También documenta un modo app-only direct URL para endpoints de lectura en clientes que pueden adjuntar un Bearer token estático.

Use Cases

• Flujos de social listening e investigación que necesitan búsqueda X en vivo o contexto de usuario.
• Flujos de cuenta asistidos por agentes, como gestión de marcadores, consulta de timelines, revisión de mentions y borradores de Articles.
• Prototipar acciones de la X API desde herramientas de IA manteniendo el cliente MCP conectado a la superficie de API documentada por X.

Setup or Requirements

X MCP requiere una cuenta de X Developer Platform y una X app con OAuth habilitado. Los comandos, bloques de configuración y flujo de autorización detallados están en mcpSetup.

Compatibility

X documenta rutas de configuración para Grok Build, Cursor, Claude Desktop, VS Code with GitHub Copilot Agent mode y clientes MCP genéricos. No se confirmaron instrucciones públicas específicas para Claude Code, Codex, Windsurf o Lovable en la página oficial X MCP revisada.

Limitations

El servidor X API MCP alojado depende del acceso a la X API, la configuración de la app, OAuth scopes, límites de tasa y permisos de la cuenta. Algunas operaciones pueden requerir un API package específico, Production environment enrollment o scopes adecuados.

La página oficial describe áreas de capacidad y rutas de configuración, pero no se confirmó una lista pública completa y estable de todos los nombres de herramientas MCP expuestas.

Sources

• Official X MCP documentation: https://docs.x.com/tools/mcp
• X Agent Resources: https://docs.x.com/tools/ai
• xurl GitHub repository: https://github.com/xdevplatform/xurl
• X API OpenAPI specification: https://api.x.com/2/openapi.json

MCP Setup

Prerequisites

• Node.js installed for npx
• X Developer Platform account
• OAuth 2.0-enabled X app
• Redirect URI registered on the X app, default http://localhost:8080/callback
• CLIENT_ID and CLIENT_SECRET from the X app

Access requirements

• First-run OAuth 2.0 browser sign-in for user-context access
• xurl caches and refreshes tokens under ~/.xurl
• X API access, scopes, app package, environment, and rate limits apply
• App-only direct URL mode is documented for read endpoints only

Companion app or plugin

Name: xurl CLI / @xdevplatform/xurl Install URL: https://github.com/xdevplatform/xurl

• Use npx in the MCP client config, or install xurl with Homebrew, npm, shell script, or Go.
• Run xurl mcp as the local stdio bridge to https://api.x.com/mcp.

xurl handles OAuth, token caching, token refresh, and Bearer-token injection for the hosted X MCP endpoint.

Client setup

Grok Build

Transport: stdio

grok mcp add xapi npx -e CLIENT_ID=YOUR_X_APP_CLIENT_ID -e CLIENT_SECRET=YOUR_X_APP_CLIENT_SECRET -- -y @xdevplatform/xurl mcp https://api.x.com/mcp

[mcp_servers.xapi]
command = "npx"
args = ["-y", "@xdevplatform/xurl", "mcp", "https://api.x.com/mcp"]
enabled = true
startup_timeout_sec = 300

[mcp_servers.xapi.env]
CLIENT_ID = "YOUR_X_APP_CLIENT_ID"
CLIENT_SECRET = "YOUR_X_APP_CLIENT_SECRET"

• Run the documented grok mcp add command or edit ~/.grok/config.toml.
• Verify with grok mcp doctor xapi and grok mcp list.

Auth:

• Complete the first-run X OAuth browser login.

Documented by X for Grok Build.

Cursor

Transport: stdio

npx -y @xdevplatform/xurl mcp https://api.x.com/mcp

{"mcpServers":{"xapi":{"command":"npx","args":["-y","@xdevplatform/xurl","mcp","https://api.x.com/mcp"],"env":{"CLIENT_ID":"YOUR_X_APP_CLIENT_ID","CLIENT_SECRET":"YOUR_X_APP_CLIENT_SECRET"}}}}

• Create ~/.cursor/mcp.json or .cursor/mcp.json.
• Open Cursor Settings > MCP and confirm xapi is connected.

Auth:

• Complete the first-run X OAuth browser login.

Documented by X for Cursor.

Claude Desktop

Transport: stdio

npx -y @xdevplatform/xurl mcp https://api.x.com/mcp

{"mcpServers":{"xapi":{"command":"npx","args":["-y","@xdevplatform/xurl","mcp","https://api.x.com/mcp"],"env":{"CLIENT_ID":"YOUR_X_APP_CLIENT_ID","CLIENT_SECRET":"YOUR_X_APP_CLIENT_SECRET"}}}}

• Edit claude_desktop_config.json and restart Claude Desktop.

Auth:

• Complete the first-run X OAuth browser login.

Documented by X for Claude Desktop.

VS Code

Transport: stdio

npx -y @xdevplatform/xurl mcp https://api.x.com/mcp

{"servers":{"xapi":{"type":"stdio","command":"npx","args":["-y","@xdevplatform/xurl","mcp","https://api.x.com/mcp"],"env":{"CLIENT_ID":"YOUR_X_APP_CLIENT_ID","CLIENT_SECRET":"YOUR_X_APP_CLIENT_SECRET"}}}}

• Add the server to .vscode/mcp.json for GitHub Copilot Agent mode.

Auth:

• Complete the first-run X OAuth browser login.

Documented by X for VS Code with GitHub Copilot Agent mode.

Claude Code

Exact public Claude Code setup is not documented on the checked official X MCP page.

Codex

Exact public Codex setup is not documented on the checked official X MCP page.

Windsurf

Exact public Windsurf setup is not documented on the checked official X MCP page.

Lovable

Exact public Lovable setup is not documented on the checked official X MCP page.

Other

Transport: stdio

npx -y @xdevplatform/xurl mcp https://api.x.com/mcp

{"mcpServers":{"xapi":{"command":"npx","args":["-y","@xdevplatform/xurl","mcp","https://api.x.com/mcp"],"env":{"CLIENT_ID":"YOUR_X_APP_CLIENT_ID","CLIENT_SECRET":"YOUR_X_APP_CLIENT_SECRET"},"startup_timeout_sec":300}}}

• Use the universal stdio MCP configuration in any compatible client.
• Set startup timeout to 300 seconds or more if supported.

Auth:

• Complete the first-run browser OAuth flow.
• For headless machines, authenticate first with xurl auth oauth2 --headless.

If xurl is installed natively, X documents replacing command npx with command xurl and args ["mcp", "https://api.x.com/mcp"].

Other

Transport: HTTP

{"mcpServers":{"xapi_direct":{"url":"https://api.x.com/mcp","headers":{"Authorization":"Bearer YOUR_APP_ONLY_BEARER_TOKEN"}}}}

• Use only with MCP clients that support remote MCP endpoints with custom headers.

Auth:

• Provide an app-only Bearer token from the X Developer Platform.

Read-endpoint trade-off: no auto-refresh and no user context. The xurl bridge is recommended for full functionality.

Authorization flow

• Create an OAuth 2.0-enabled X app in the X Developer Portal.
• Register http://localhost:8080/callback or set and register REDIRECT_URI.
• Set CLIENT_ID and CLIENT_SECRET in the MCP client environment or register them in xurl.
• Start the MCP client and complete the one-time browser OAuth flow.
• For headless hosts, run xurl auth oauth2 --headless first.

Environment variables

• CLIENT_ID
• CLIENT_SECRET
• REDIRECT_URI optional
• AUTH_URL optional
• TOKEN_URL optional
• API_BASE_URL optional
• INFO_URL optional

Setup docs: https://docs.x.com/tools/mcp