Servidor MCP de Twitter: 3 tipos y una configuración de 1 línea

#Qué hace un servidor MCP de Twitter

Un servidor MCP de Twitter es un programa pequeño que le da a un agente de IA un conjunto de herramientas para X, como "buscar posts" o "listar seguidores", mediante el Model Context Protocol (se abre en una pestaña nueva), el estándar abierto que Claude, Cursor, Codex y VS Code usan para llamar a herramientas externas.

Tú pides en palabras sencillas. El agente elige una herramienta, completa sus argumentos y la llama; el servidor convierte la llamada en una solicitud de datos de X, devuelve el JSON y el agente responde a partir de él. Nunca escribes la solicitud tú mismo, y el agente puede encadenar varias llamadas para terminar un trabajo, como una búsqueda seguida de una consulta de perfil para cada autor que encontró.

El protocolo es libre y abierto, y también lo es el código de la mayoría de los servidores. Lo que cuesta un servidor, y lo que puede hacerle a tu cuenta de X, viene de la conexión que tiene detrás: de quién son las credenciales que guarda y quién cobra cada lectura. Esa conexión divide a los servidores MCP de Twitter en tres tipos, y decide más que la lista de herramientas.

#Los tres tipos de servidor MCP de Twitter

Todo servidor MCP de Twitter llega a X por una de tres conexiones: tu propia app de desarrollador de X, tu cuenta de X con sesión iniciada o una clave de API de datos. La conexión decide qué configuras, cuánto cuesta una lectura y qué puede hacer tu agente con tu cuenta.

Solo el tipo con clave de datos deja fuera por completo tu cuenta de X, y lee posts por una pequeña fracción de la tarifa oficial:

• Con una clave de API de datos (sorsa-mcp de Sorsa API)

  Qué configuras

  Una clave de Sorsa API

  Leer 1,000 posts

  Desde $0.014 por ID, desde $0.07 mediante búsqueda

  ¿Puede publicar el agente?

  No, de solo lectura por diseño

  Tu cuenta de X

  Nunca se conecta

• Con tu app de desarrollador de X (el MCP oficial de X, servidores de código abierto sobre la API oficial de X)

  Qué configuras

  Una app de X con OAuth, sus claves y créditos prepagados

  Leer 1,000 posts

  $5.00, a $0.005 por post

  ¿Puede publicar el agente?

  Depende del servidor y del acceso de escritura de tu app

  Tu cuenta de X

  Tu app actúa por ti

• Con tu inicio de sesión de X (servidores que inician sesión como tú)

  Qué configuras

  Tu nombre de usuario y contraseña de X, o cookies de sesión

  Leer 1,000 posts

  Lo fija el proveedor

  ¿Puede publicar el agente?

  Sí, como tú

  Tu cuenta de X

  Con sesión iniciada por un bot, así que puede ser marcada

Seis preguntas deciden la elección para un agente que lee X: qué configuras antes de la primera llamada, cuánto cuesta una lectura, si el agente puede publicar, si tu cuenta de X interviene, qué tan rápido responde y cuánto del contexto del agente ocupan las herramientas. La tabla resuelve las cuatro primeras; el MCP oficial de X de abajo y la sección de configuración que sigue responden el resto para cada tipo.

#El MCP oficial de X: qué necesita y qué cobra

El MCP oficial de X necesita tu propia app de desarrollador de X y cobra cada llamada con las tarifas de pago por uso de la API oficial de X. X lanzó el servidor alojado en api.x.com/mcp el 30 de junio de 2026 (anuncio de X (se abre en una pestaña nueva)), y su documentación de MCP (se abre en una pestaña nueva) enumera lo que requiere una configuración que funcione:

• una app de X en la Developer Console con OAuth 2.0 y el URI de redirección http://localhost:8080/callback;
• el client ID y el secreto de la app en la configuración de tu agente, leídos por xurl, un puente local que corre con npx;
• un inicio de sesión único en un navegador, con el tiempo de espera de arranque del cliente subido a al menos 300 segundos;
• la app pasada al paquete Pay-per-use de X, o el inicio de sesión termina en client-not-enrolled.

Una ruta más corta envía un Bearer token solo de app de la misma app, y X lo marca como de solo lectura. En cualquier caso, primero va la cuenta de desarrollador; nuestra guía de la API de Twitter sin cuenta de desarrollador recorre todo lo que implica.

Las herramientas del servidor leen posts con quienes les dieron me gusta, los republicaron o los citaron, hacen búsquedas en el archivo completo y consultan usuarios, timelines, menciones, noticias y tendencias. Sus escrituras son marcadores y Artículos; la documentación de X no lista ninguna herramienta que cree un post. Cada lectura se cobra a las tarifas de la API oficial de X (se abre en una pestaña nueva): $0.005 por post y $0.010 por usuario, hasta 3 millones de lecturas de posts al mes antes de que X pida un contrato Enterprise. Desde el 22 de noviembre de 2026, X también cobra los autores y la multimedia que llegan con los posts, a $0.010 por usuario (aviso de X (se abre en una pestaña nueva)). Nuestro desglose de precios de la API de X tiene toda la tarifa.

#Configura el servidor MCP de Sorsa en una línea

Para un agente que hace investigación, monitoreo, listas de leads o verificaciones en X, agrega el servidor MCP de Sorsa API: un comando en Claude Code o Codex, o un bloque JSON en Cursor y VS Code, con tu clave en SORSA_API_KEY, y las primeras 100 llamadas a herramientas son gratis.

Responde las seis preguntas con números: una clave de API, tweets desde $0.014 por cada 1,000, cero herramientas de escritura, ninguna cuenta de X en riesgo, 20 solicitudes por segundo en todos los planes y 40 definiciones de herramientas en unos 5,800 tokens. Publicar es el único trabajo que deja fuera a propósito; para publicar, combínalo con la API oficial de X, que mantiene las escrituras en tu propia app. El servidor corre en tu computadora y convierte cada llamada a una herramienta en una solicitud, sea cual sea de las 40 herramientas, ya devuelva un perfil o 100 posts.

Necesitas Node.js 18 o más reciente (compruébalo con node -v) y una app que ejecute servidores MCP locales. La página del servidor MCP de Sorsa guarda en un solo lugar la línea para cada agente.

1. Obtén una clave. Regístrate con tu correo o tu cuenta de Google. El panel muestra tu clave de API; las primeras 100 solicitudes no piden tarjeta y nunca vencen.

2. Agrega el servidor a tu agente. Pon tu clave en lugar de YOUR_API_KEY. Claude Code y Codex aceptan una línea en la terminal, y -s user hace que Sorsa API esté disponible en todos los proyectos de Claude Code. Cursor lee un bloque JSON de ~/.cursor/mcp.json para todos los proyectos o de .cursor/mcp.json para uno; VS Code lee .vscode/mcp.json y pide la clave una sola vez, para que nunca quede en el archivo.

   claude mcp add sorsa -s user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp
   

   codex mcp add sorsa --env SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp
   

   {
     "mcpServers": {
       "sorsa": {
         "command": "npx",
         "args": ["-y", "sorsa-mcp"],
         "env": { "SORSA_API_KEY": "YOUR_API_KEY" }
       }
     }
   }
   

   {
     "inputs": [{ "type": "promptString", "id": "sorsa-key",
       "description": "Sorsa API key", "password": true }],
     "servers": {
       "sorsa": {
         "type": "stdio",
         "command": "npx",
         "args": ["-y", "sorsa-mcp"],
         "env": { "SORSA_API_KEY": "${input:sorsa-key}" }
       }
     }
   }
   

3. Comprueba que funciona. Pregúntale a tu agente "¿Cuántas solicitudes de Sorsa API me quedan?". Llama a get_key_usage_info, que lee GET /key-usage-info (se abre en una pestaña nueva) y nunca cuenta contra tus solicitudes; un número en la respuesta significa que el agente, el servidor y la clave están conectados. En Claude Code, claude mcp get sorsa también debería decir "Connected".

4. Haz una pregunta real. Prueba "Encuentra los 50 posts con más me gusta de esta semana sobre servidores MCP y agrúpalos por tema". El agente la convierte en una llamada search_tweets como la de abajo, la repite tres o cuatro veces con el next_cursor que devuelve cada respuesta, unos 20 posts por llamada, y escribe el resumen a partir de los resultados.

   {
     "name": "search_tweets",
     "arguments": {
       "query": "\"mcp server\" min_faves:20 since:2026-10-26",
       "order": "popular"
     }
   }
   

Para tener en cuenta

En Claude Code, el nombre del servidor va antes de -e. Una línea como claude mcp add --env SORSA_API_KEY=... sorsa -- npx -y sorsa-mcp falla con "Invalid environment variable format: sorsa" (formato de variable de entorno no válido), porque --env acepta varios valores y lee el nombre como uno más.

Todo lo que va después de -- pertenece al comando del servidor, así que un -e puesto al final nunca llega al servidor, y este se detiene al arrancar sin clave. Probamos las tres formas en Claude Code 2.1.314; solo la línea de arriba conecta.

#Líneas para otras apps MCP

Cualquier app que ejecute servidores MCP locales inicia sorsa-mcp con los mismos tres ajustes: el comando npx, los argumentos -y sorsa-mcp y tu clave como SORSA_API_KEY en su entorno. Grok Build y OpenClaw lo agregan desde una terminal, y Hermes Agent lo lee de su archivo de configuración:

grok mcp add sorsa -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp

openclaw mcp add sorsa --command npx --arg -y --arg sorsa-mcp \
  --env SORSA_API_KEY=YOUR_API_KEY

mcp_servers:
  sorsa:
    command: "npx"
    args: ["-y", "sorsa-mcp"]
    env:
      SORSA_API_KEY: "YOUR_API_KEY"

Dónde va cada uno y cómo ver que se conectó:

• Claude Desktop: pega el bloque de Cursor en el archivo que abre Settings, Developer, Edit Config, cierra la app por completo y ábrela de nuevo; las herramientas aparecen bajo "+".
• Gemini CLI: pega el bloque de Cursor en ~/.gemini/settings.json y comprueba con /mcp.
• Grok Build: comprueba con grok mcp doctor sorsa.
• OpenClaw: comprueba con openclaw mcp doctor sorsa --probe.
• Hermes Agent: agrega el bloque a ~/.hermes/config.yaml y luego ejecuta /reload-mcp en tu sesión.

Claude.ai, ChatGPT y grok.com en un navegador agregan servidores solo por URL, así que no pueden iniciar un servidor en tu computadora: usa Claude Desktop o Claude Code con la misma clave. Los prompts listos que ponen el servidor a trabajar están en build with AI.

#Qué puede leer tu agente: 40 herramientas

El servidor MCP de Sorsa API tiene 40 herramientas, una por cada endpoint de la API que cubre, y todas leen datos públicos de X. El agente las elige por nombre según tu petición, así que rara vez necesitas saber cuál es cuál; esto es lo que trae una llamada en cada grupo:

• Búsqueda, unos 20 posts o cuentas por llamada, con operadores de búsqueda de X, hasta 2006: search_tweets, search_users, search_mentions.
• Posts, hasta 100 posts por ID por llamada, cada uno con el perfil completo de su autor: get_tweet_info, get_tweet_info_bulk, get_tweet_comments, get_tweet_quotes, get_retweeters, get_article, get_trends.
• Cuentas, hasta 100 perfiles por llamada, o un timeline de 20 posts a la vez: get_user_info, get_user_info_batch, get_account_about, get_user_tweets.
• Seguidores, hasta 200 por página: get_followers, get_following, get_verified_followers.
• Verificaciones, un sí o un no por llamada: check_follow, check_retweet, check_quoted, check_comment, check_community_member.
• Listas, Comunidades y Spaces, miembros, feeds y detalles de Spaces: get_list_members, get_list_tweets, get_list_followers, get_community_members, get_community_tweets, search_community_tweets, get_space_info.
• Utilidades, IDs y las solicitudes que te quedan: username_to_id, id_to_username, link_to_id, get_key_usage_info.

Otras siete herramientas devuelven datos de Sorsa Score para cuentas cripto. Las herramientas por lotes son donde un agente más ahorra: get_tweet_info_bulk ejecuta POST /tweet-info-bulk (se abre en una pestaña nueva) y get_user_info_batch ejecuta GET /info-batch (se abre en una pestaña nueva), 100 elementos por una solicitud, y check_follow responde POST /check-follow (se abre en una pestaña nueva) en una llamada en lugar de recorrer una lista de seguidores página por página.

Ninguna herramienta publica, responde, da me gusta, sigue cuentas ni envía mensajes directos, y ninguna devuelve quién dio me gusta a un post, los me gusta ni los marcadores de un usuario, los mensajes directos ni las cuentas protegidas: el servidor lee solo datos públicos.

#Cuánto cuesta una llamada a una herramienta

Una llamada a una herramienta en Sorsa API cuesta una solicitud, desde $0.0014, sin importar lo que devuelva; el MCP oficial de X cobra cada elemento dentro de la llamada, así que la misma búsqueda de 20 posts cuesta $0.10 a $0.005 por post.

La brecha crece con el tamaño de la respuesta, porque Sorsa API devuelve hasta 200 elementos por el precio de una solicitud e incluye al autor de cada post sin costo adicional:

• search_tweets

  Qué devuelve

  Unos 20 posts

  Sorsa API

  Desde $0.0014

  Tarifas de la API oficial de X

  $0.10

  Con autores, desde el 22 de nov.

  Hasta $0.30

• get_tweet_info_bulk

  Qué devuelve

  100 posts

  Sorsa API

  Desde $0.0014

  Tarifas de la API oficial de X

  $0.50

  Con autores, desde el 22 de nov.

  Hasta $1.50

• get_user_info_batch

  Qué devuelve

  100 perfiles

  Sorsa API

  Desde $0.0014

  Tarifas de la API oficial de X

  $1.00

  Con autores, desde el 22 de nov.

  $1.00

• get_followers

  Qué devuelve

  200 seguidores

  Sorsa API

  Desde $0.0014

  Tarifas de la API oficial de X

  $2.00

  Con autores, desde el 22 de nov.

  $2.00

A escala de un mes, los resultados de búsqueda mediante POST /search-tweets (se abre en una pestaña nueva) cuestan desde $0.07 por cada 1,000 en Sorsa API, frente a $5.00 por cada 1,000 posts a las tarifas de la API oficial de X. Las consultas por ID llegan de 100 en 100 por llamada, desde $0.014 por cada 1,000, y las listas de seguidores mediante GET /followers (se abre en una pestaña nueva) desde $0.007 por cada 1,000. Elige el tamaño del mes de tu agente:

La velocidad viene con el precio: Sorsa API responde 20 solicitudes por segundo en todos los planes, cuentas gratuitas incluidas, lo que equivale a hasta 2,000 tweets por segundo mediante consultas por lotes. Una llamada que falla no cuesta nada, porque las solicitudes fallidas nunca se cobran.

#Por qué un servidor de solo lectura le conviene a un agente

Un servidor de solo lectura no puede publicar, seguir ni pagar escrituras, así que un agente confundido o atrapado en un ciclo solo puede gastar solicitudes, nunca actuar en X en tu nombre.

• Ninguna herramienta escribe. No hay herramienta para publicar, responder, dar me gusta, seguir ni enviar mensajes directos, y la API detrás del servidor no tiene ese endpoint. Si se le pide post_tweet, el servidor responde "Tool post_tweet not found" (herramienta no encontrada).
• Un solo destino. El servidor corre en tu computadora, y su código envía cada llamada a https://api.sorsa.io/v3 con tu clave en el encabezado ApiKey. El código fuente está en GitHub (se abre en una pestaña nueva) con licencia MIT.
• Ninguna cuenta de X. Sorsa API nunca te pide tu inicio de sesión de X, cookies ni app.
• Un techo de gasto. Una clave hace como máximo 20 solicitudes por segundo, y en el pago por uso un límite de gasto, de $100 por defecto, acota cada periodo de facturación.

Las herramientas también son ligeras para el contexto del agente. Las 40 definiciones de herramientas suman unos 23K caracteres, aproximadamente 5,800 tokens, y Claude Code carga solo sus nombres hasta que necesita una. Los resultados son JSON completo con el perfil de cada autor, así que pide lo que necesitas ("los 50 posts más recientes"): Claude Code avisa cuando el resultado de una herramienta pasa de 10K tokens.

Para tener en cuenta

El texto dentro de los posts son datos, no instrucciones. Un agente que lee X se topará con posts escritos para manipular a agentes de IA; con un servidor de solo lectura, lo máximo que puede costarte uno de esos posts es una solicitud desperdiciada. Mantén las demás herramientas del agente, como enviar correos o editar archivos, bajo tu aprobación.

#Soluciona una configuración que no conecta

La mayoría de las configuraciones fallidas se reducen a dónde está la clave, a que falta Node.js o a que una app no recargó sus servidores. Busca lo que ves:

• Invalid environment variable format: sorsa en Claude Code

  Por qué

  El nombre del servidor está justo después de --env

  Solución

  Pon primero el nombre: claude mcp add sorsa -s user -e ...

• "Failed to connect" (no se pudo conectar), y el entorno del servidor está vacío

  Por qué

  -e quedó después de --, así que fue a npx

  Solución

  Mueve -e SORSA_API_KEY=... antes de --

• npx: command not found

  Por qué

  Node.js no está instalado

  Solución

  Instala Node.js 18 o más reciente y reinicia la app

• Missing SORSA_API_KEY environment variable

  Por qué

  La configuración no tiene clave

  Solución

  Agrega SORSA_API_KEY al env del servidor

• Cada llamada devuelve 401 invalid api key

  Por qué

  La clave está mal escrita

  Solución

  Pégala de nuevo desde el panel, sin espacios

• Las llamadas devuelven 403 pasado un tiempo

  Por qué

  Se agotaron tus solicitudes

  Solución

  Mejora el plan o activa el pago por uso; la misma clave sigue funcionando

• El servidor está agregado pero no muestra herramientas

  Por qué

  La app no se recargó

  Solución

  Cierra Claude Desktop por completo, ejecuta /reload-mcp en Hermes o activa sorsa en Cursor

• Un tiempo de espera agotado en el primer arranque

  Por qué

  npx está descargando el paquete

  Solución

  Inícialo de nuevo, o fija startup_timeout_sec = 30 en Codex

¿Sigues atascado? Pídele al agente que llame a get_key_usage_info y te muestre el resultado en bruto: un número significa que la clave llega a Sorsa API, y un error indica qué falta.

#Dale datos de X a tu agente hoy

Agrega el servidor MCP de Sorsa API y tu agente lee X mediante 40 herramientas de solo lectura: una línea en Claude Code o Codex, tweets desde $0.014 por cada 1,000 en lugar de $5.00 a las tarifas de la API oficial de X, 20 solicitudes por segundo y ninguna cuenta tuya de X en toda la cadena. Las primeras 100 llamadas a herramientas son gratis. Para agentes que llaman datos de X sin MCP, mediante REST simple o la skill de agente, lee nuestra guía de la API de Twitter para agentes de IA.

#Preguntas frecuentes