Saltar al contenido
Twexapi
Español
English简体中文日本語Español한국어FrançaisTürkçe
Esc
↑↓navegar↵abrir⌘Jvista previa
En esta página

Servidor MCP

Conecta agentes de IA a Twexapi mediante el Model Context Protocol.

Conecta agentes de IA mediante MCP

Twexapi ejecuta un servidor de Model Context Protocol que permite a agentes de IA y herramientas de desarrollo interactuar con tu cuenta de Twexapi de forma programática.

Esta página cubre el servidor MCP de la API en https://api.twexapi.io/mcp para acciones autenticadas. Para búsqueda de documentación de solo lectura, usa el servidor Docs MCP en https://docs.twexapi.io/mcp.

Conexión

Protocolo

HTTP con transporte Streamable HTTP para clientes MCP.

Endpoint

Conecta los clientes a:

https://api.twexapi.io/mcp

El servidor de la API acepta tanto https://api.twexapi.io/mcp como https://api.twexapi.io/mcp/. Usa la URL sin barra final en la configuración del cliente, a menos que el cliente la normalice explícitamente.

Autenticación

Usa una API key de Twexapi en x-api-key o un token Bearer OAuth 2.1 cuando OAuth esté habilitado para tu workspace.

Los metadatos de descubrimiento del servidor MCP están disponibles en:

https://api.twexapi.io/.well-known/mcp.json

GET /.well-known/mcp.json devuelve directamente el JSON de la tarjeta del servidor del registro MCP. GET /.well-known/mcp/server-card.json devuelve la misma tarjeta para clientes que leen la ruta anidada server-card.

Los clientes que usan la tarjeta del registro reciben un remoto streamable-http para https://api.twexapi.io/mcp con autenticación por API key. Los ejemplos de cliente directo abajo pueden enviar la misma key con x-api-key cuando el cliente admite headers personalizados.

Autenticación

El servidor MCP admite estos métodos de autenticación:

  • API key (header x-api-key): usada por Claude Code, Cursor, VS Code, Windsurf, Codex CLI, OpenCode y Claude Desktop mediante puentes remotos. Pasa tu key durante el handshake MCP.
  • Token Bearer (Authorization: Bearer <token>): usado por clientes que prefieren headers Authorization. Puede ser una API key de Twexapi o un token OAuth cuando OAuth está habilitado.

Crea tu API key desde el dashboard de Twexapi.

Cómo funciona

El servidor MCP expone 2 herramientas:

explore

Busca en el catálogo de la API de Twexapi. Es una herramienta de descubrimiento: devuelve nombres de endpoints, métodos, rutas, categorías, esquemas de parámetros, ejemplos y flags de seguridad.

twexapi_request

Ejecuta llamadas autenticadas a la API de Twexapi. El costo sigue el endpoint subyacente.

El agente primero busca con explore y luego llama a twexapi_request con el método y la ruta relativa devueltos. La autenticación se inyecta automáticamente desde la solicitud MCP.

Herramienta explore

Busca en el catálogo de endpoints de la API en memoria. La llamada aún requiere autenticación MCP mediante API key o token Bearer.

interface EndpointInfo {
  name: string;
  method: string;
  path: string;
  category: string; // trending, search, users, tweets, followers, engagement, communities, lists, dm, articles, timeline, accounts, write
  description: string;
  read_only: boolean;
  parameters_schema?: Record<string, unknown>;
  example?: Record<string, unknown>;
}

Herramienta twexapi_request

Ejecuta llamadas a la API contra endpoints REST de Twexapi en la allowlist.

declare const twexapi_request: {
  method: string;
  path: string;
  query?: Record<string, unknown>;
  body?: unknown;
};

Ejemplo de llamada:

{
  "method": "GET",
  "path": "/twitter/global-trending/countries"
}

MCP vs API REST

Servidor MCP

Ideal para agentes de IA, integraciones en el IDE y flujos en lenguaje natural. Conéctate a https://api.twexapi.io/mcp con x-api-key o auth Bearer. Los agentes usan explore para buscar endpoints y twexapi_request para llamadas autenticadas.

API REST

Ideal para servicios backend, scripts de automatización y acceso programático directo. Llama a https://api.twexapi.io/* con Authorization: Bearer <token>. Usa la referencia de la API cuando necesites control detallado sobre endpoints, paginación, manejo de respuestas o código SDK directo.

Usa MCP cuando quieras que un agente interactúe con datos de X/Twitter mediante lenguaje natural. Usa REST cuando estés construyendo un backend de producción, un job programado o una integración directa.

Configuración

Clientes web y de terminal

Claude.ai

Claude.ai puede conectarse a servidores MCP remotos cuando los conectores MCP están habilitados para tu workspace. Usa https://api.twexapi.io/mcp como URL del servidor. Los workspaces con OAuth pueden completar la autenticación en el navegador; los clientes con API key deben usar x-api-key.

Claude Desktop

Claude Desktop solo admite transporte stdio. Usa el paquete npm mcp-remote como puente:

{
  "mcpServers": {
    "twexapi": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.twexapi.io/mcp",
        "--header",
        "x-api-key:twexapi_YOUR_KEY_HERE"
      ]
    }
  }
}

Claude Code

Agrega esto a tu .mcp.json:

{
  "mcpServers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

Codex CLI

Agrega esto a ~/.codex/config.toml:

[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
http_headers = { "x-api-key" = "twexapi_YOUR_KEY_HERE" }

Clientes de editor

Cursor

Agrega esto a ~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto):

{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

VS Code

Agrega esto a .vscode/mcp.json (proyecto) o usa MCP: Open User Configuration (global):

{
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

Windsurf

Agrega esto a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "twexapi": {
      "serverUrl": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

OpenCode

Agrega esto a opencode.json:

{
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

ChatGPT

Hay 3 formas de conectar ChatGPT a Twexapi:

Opción 1: Custom GPT

Crea un Custom GPT y agrega Twexapi como Action usando el esquema OpenAPI de tu despliegue de la API. Configura la autenticación como header de API key o token Bearer según tu setup.

Opción 2: Agents SDK

Usa Streamable HTTP MCP desde un runtime de agente:

from agents.mcp import MCPServerStreamableHttp

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

Opción 3: Developer Mode

Cuando tu entorno de ChatGPT admite conectores MCP, agrega Twexapi con https://api.twexapi.io/mcp como endpoint. Los workspaces con OAuth pueden completar la autenticación en el navegador.

Prompts de ejemplo

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

Búsqueda y consulta

  • Busca publicaciones recientes en X sobre AI agents de las últimas 24 horas. Devuelve los 20 tweets principales con tweet ID, autor, hora 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/1803006263529541838. Resume la publicación, luego obtén las respuestas más relevantes y muestra los reply IDs.
  • Obtén tweets similares para el tweet ID 1803006263529541838 y explica por qué cada resultado está relacionado.

Perfiles de usuario y follows

  • Lee la bio del perfil de @openai y devuelve username, display name, user ID, ubicación, cantidad de seguidores y URL del perfil.
  • Busca usuarios en X para AI infrastructure. Devuelve 25 cuentas con username, bio, cantidad de seguidores y por qué coinciden.
  • Obtén los seguidores más recientes de @elonmusk, luego identifica qué cuentas mencionan AI, startups o crypto en sus bios.
  • Obtén una página de seguidores con paginación por cursor para @sama, devuelve los primeros 20 usuarios y conserva el next_cursor para la siguiente ejecución.
  • Verifica si las cuentas 44196397, elonmusk y openai están verificadas o afiliadas a una organización.

Tendencias

  • Muestra todos los países con tendencias globales admitidos, luego obtén los temas en tendencia principales para united-states.
  • Obtén tweets en tendencia para united-states con el tema technology y la etiqueta de contenido AI. Devuelve tweet IDs, autores y métricas de engagement.
  • Verifica si AI, Bitcoin o Grok están en tendencia hoy en Estados Unidos. Explica la evidencia de los tweets devueltos.
  • Compara temas en tendencia para united-states, japan y united-kingdom y resume qué difiere por región.

Extracciones

  • Obtén respuestas a https://x.com/elonmusk/status/1803006263529541838, ordénalas por relevancia y devuelve reply ID, autor, texto y cantidad de likes.
  • Lista 50 usuarios que retweetearon el tweet ID 1803006263529541838. Devuelve user ID, username, display name y cantidad de seguidores si está disponible.
  • Obtén quote tweets para el tweet ID 1803006263529541838, luego clasifica los quotes como de apoyo, críticos o neutrales.
  • Extrae el hilo completo del tweet ID 1803006263529541838 y conviértelo en un esquema Markdown.
  • Obtén todos los tweets y respuestas de @elonmusk con un count de 20, luego separa publicaciones originales de respuestas.

Artículos

  • Obtén el artículo de X 1803006263529541838 como Markdown y conviértelo en un brief ejecutivo de 5 viñetas.
  • Obtén en lote artículos de X con los IDs 1803006263529541838 y 1803006263529541839; devuelve título, autor, hora de publicación y resumen.
  • Lee este artículo de X como Markdown, extrae todos los enlaces y produce un resumen limpio estilo newsletter.

Comunidades y listas

  • Busca comunidades en X para AI builders. Devuelve community ID, nombre, cantidad de miembros y descripción.
  • Obtén los tweets más recientes de la comunidad ID 1234567890123456789 con tweet type Latest y target count 20.
  • Busca listas para AI founders. Devuelve las 10 listas principales con list ID, nombre, descripción y cantidad de miembros.
  • Obtén miembros de la lista ID 987654321098765432, incluye el siguiente cursor y formatea el resultado como una tabla de prospección.

Acciones de escritura en X

  • Publica un tweet que diga: Just shipped v2.0 of our Twexapi integration. MCP setup now takes less than 2 minutes.
  • Responde al tweet ID 1803006263529541838 con: This is a useful example. I tested it through Twexapi MCP.
  • Crea un tweet con la URL de imagen https://example.com/launch.png y el texto: New launch: Twexapi MCP now supports agent workflows.
  • Redacta, pero no envíes, una respuesta a https://x.com/elonmusk/status/1803006263529541838 en un estilo técnico conciso.

Cuenta y uso

  • Explica por qué mi solicitud MCP a /twitter/global-trending/tweets devolvió 401 y lista los headers que debo verificar.
  • Explica por qué mi solicitud MCP devolvió 403 No available credits! y qué debo hacer antes de reintentar.
  • Explica por qué una extracción de seguidores de alto volumen devolvió 429, luego propone un plan de reintento y paginación.
  • Decide si esta tarea debe usar MCP o REST directo: pull 10,000 followers for @openai every morning and store them in my database.

Guías de frameworks

Construye agentes con las herramientas MCP de Twexapi en tu framework preferido:

LangChain

Conecta herramientas MCP de Twexapi a agentes LangChain y LangGraph.

CrewAI

Construye crews de investigación que compartan una conexión MCP de Twexapi.

Pydantic AI

Usa agentes type-safe con herramientas MCP Streamable HTTP.

Google ADK

Agrega herramientas de Twexapi a agentes ADK con Gemini.

Mastra

Conecta agentes TypeScript a herramientas MCP remotas de Twexapi.

Flujos no-code

Entrega salidas de agentes a n8n, Zapier, Make y Pipedream.

Skill para agentes de IA

El skill de Twexapi da a los agentes de código profundo conocimiento de la API de Twexapi sin requerir una conexión MCP. Instálalo para que tu agente escriba integraciones de API, configure conexiones MCP y use las mejores prácticas de Twexapi.

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

¿Te ha resultado útil esta página?