Servidor MCP

Conecta Claude, ChatGPT, Cursor y otros agentes de IA a TwexAPI mediante el Model Context Protocol. Inicia sesión con tu cuenta de TwexAPI o usa una API key.

TwexAPI ofrece un servidor Model Context Protocol en https://api.twexapi.io/mcp. Los asistentes de IA y los agentes de código pueden usarlo para buscar tweets, leer perfiles, seguidores, respuestas, hilos, comunidades, listas y tendencias. Cada llamada usa tus créditos de TwexAPI, igual que una solicitud REST.

Esta página trata del servidor MCP de la API. Para que un agente busque en la documentación de TwexAPI, usa el servidor Docs MCP en https://docs.twexapi.io/mcp, que no requiere iniciar sesión.

Inicio rápido

Pasos según el cliente:

Autenticación

El servidor acepta dos tipos de credenciales:

Crea o copia tu API key en el dashboard de TwexAPI. ChatGPT no puede enviar headers personalizados, así que siempre usa el inicio de sesión.

Qué concede el inicio de sesión

• La app recibe un token que solo funciona en https://api.twexapi.io/mcp. Nunca ve tu contraseña ni tu API key, y no puede modificar tu cuenta ni leer tu dashboard.
• Las llamadas se cobran a los créditos de tu cuenta, exactamente igual que las llamadas hechas con tu API key.
• El acceso de lectura siempre se concede. El acceso de escritura (publicar tweets y respuestas con twexapi_write) es una casilla en la página de consentimiento; desmárcala para conectarte en modo de solo lectura.
• Los access tokens duran una hora y los clientes los renuevan automáticamente. Una autorización que ninguna app usa durante 30 días expira.
• Cada vez que conectas un cliente, aparece una nueva entrada en Authorized apps (apps autorizadas) del dashboard. Selecciona Revoke para cortar el acceso de una app de inmediato. Eliminar un conector dentro del cliente no lo revoca en nuestro lado.

Antes de aprobar

• Tu cuenta necesita una API key activa con créditos disponibles. Sin créditos, la página de consentimiento te pide recargar primero. La solicitud sigue siendo válida durante 10 minutos, así que puedes recargar y volver a seleccionar Approve.
• Revisa la línea After you approve, you will return to. Debe indicar la app que estás usando, como claude.ai, chatgpt.com o una dirección 127.0.0.1 en apps de escritorio.

Descubrimiento

Los clientes MCP obtienen todo lo que necesitan del propio servidor:

Una solicitud sin credenciales devuelve 401 con un desafío WWW-Authenticate: Bearer que indica la URL de los metadatos del recurso protegido. Ese desafío es lo que le indica al cliente que debe iniciar sesión. Consulta OAuth para clientes MCP para ver el flujo completo.

Herramientas

Clientes como Claude piden confirmación antes de cada llamada a twexapi_write. Otras acciones de escritura, como likes, follows y mensajes directos, solo están disponibles en la API REST. Consulta la referencia de herramientas MCP para ver entradas, salidas y el catálogo completo.

Créditos y errores

Incluye el header de respuesta X-Request-Id y la hora UTC cuando reportes un problema de conexión.

Pago por llamada sin cuenta

Los clientes MCP que pagan con el Machine Payments Protocol en lugar de una API key se conectan a https://api.twexapi.io/mcp/pay. Ese endpoint acepta solicitudes anónimas y responde a las llamadas de herramientas elegibles con un desafío de pago. El endpoint principal /mcp siempre requiere inicio de sesión o una API key.

Claude.ai y Claude Desktop

Claude.ai y Claude Desktop comparten los mismos conectores, así que solo agregas TwexAPI una vez.

En los planes Team y Enterprise, puede que un owner tenga que permitir primero los conectores personalizados.

Frameworks de agentes

Los runtimes de agentes y los scripts suelen enviar una API key. Por ejemplo, con el OpenAI Agents SDK:

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    params={
        "url": "https://api.twexapi.io/mcp",
        "headers": {"x-api-key": "YOUR_API_KEY"},
    },
) as twexapi:
    # use TwexAPI as a tool provider
    pass

Carga la key desde una variable de entorno o un gestor de secretos en lugar de escribirla en el código.

MCP vs API REST

Servidor MCP

Ideal para asistentes de IA, agentes en el IDE y flujos en lenguaje natural. El agente encuentra endpoints con explore y los llama con twexapi_request o twexapi_write.

API REST

Ideal para servicios backend, tareas programadas e integraciones directas. Llama a https://api.twexapi.io/* con Authorization: Bearer YOUR_API_KEY. Usa la referencia de la API cuando necesites todos los endpoints, paginación detallada o código de SDK.

Usa MCP cuando quieras que un agente trabaje con datos de X/Twitter en lenguaje natural. Usa REST cuando estés construyendo un backend de producción o guardando grandes volúmenes de resultados.

Ejemplos de prompts

Una vez conectado, puedes pedirle a tu agente de IA cosas como:

Búsqueda y consulta

• Busca posts recientes en X sobre AI agents de las últimas 24 horas. Devuelve los 20 tweets principales con ID del tweet, autor, fecha de creación, likes, reposts y un resumen de una línea.
• Encuentra tweets recientes de @elonmusk que mencionen Grok o AI. Agrupa los resultados por tema e incluye enlaces directos a X.
• Lee este tweet: https://x.com/elonmusk/status/2104354931595423762. Resume el post y luego trae las respuestas más relevantes con sus IDs.
• Obtén tweets similares al tweet con ID 2104354931595423762 y explica por qué cada resultado está relacionado.

Perfiles y seguidores

• Lee la bio del perfil de @openai y devuelve username, nombre visible, user ID, ubicación, número de seguidores y URL del perfil.
• Busca usuarios de X sobre AI infrastructure. Devuelve 25 cuentas con username, bio, número de seguidores y por qué coinciden.
• Obtén los seguidores más recientes de @elonmusk e identifica qué cuentas mencionan IA, startups o cripto en su bio.
• Trae una página de seguidores de @sama paginada por cursor, devuelve los primeros 20 usuarios y conserva el next_cursor para la siguiente ejecución.

Tendencias

• Muestra todos los países de tendencias globales disponibles y luego trae los temas en tendencia principales de united-states.
• Trae tweets en tendencia de united-states con el tema technology y la etiqueta de contenido AI. Devuelve IDs de tweets, autores y métricas de interacción.
• Compara los temas en tendencia de united-states, japan y united-kingdom y resume las diferencias por región.

Respuestas, citas e hilos

• Trae las respuestas a https://x.com/elonmusk/status/2104354931595423762, ordénalas por relevancia y devuelve ID de la respuesta, autor, texto y número de likes.
• Lista 50 usuarios que retuitearon el tweet con ID 2104354931595423762. Devuelve user ID, username, nombre visible y número de seguidores si está disponible.
• Obtén los tweets que citan el tweet con ID 2104354931595423762 y clasifícalos como a favor, críticos o neutrales.
• Extrae el hilo completo del tweet con ID 2104354931595423762 y conviértelo en un esquema en Markdown.

Artículos, comunidades y listas

• Trae el artículo de X 2104354931595423762 en Markdown y conviértelo en un resumen ejecutivo de 5 puntos.
• Busca comunidades de X sobre AI builders. Devuelve ID de la comunidad, nombre, número de miembros y descripción.
• Busca listas sobre AI founders. Devuelve las 10 listas principales con ID, nombre, descripción y número de miembros.

Guías de frameworks

Crea agentes con las herramientas MCP de TwexAPI en tu framework preferido:

Skill para agentes de IA

La skill de TwexAPI les da a los agentes de código un conocimiento profundo de la API de TwexAPI sin necesidad de una conexión MCP. Instálala para que tu agente escriba integraciones con la API, configure conexiones MCP y siga las buenas prácticas de TwexAPI.

npx skills add twexapi-dev/x-api-scraper-cli