TwitterAPIs
Servidor MCP para la API de Twitter/X: 51 herramientas que cubren búsqueda de tweets y usuarios, perfiles, cronologías, seguidores, hilos, listas, menciones, me gusta, marcadores y mensajes directos, además de acciones de escritura.
Documentación
Servidor MCP de Twitter / X para Claude, Cursor y cualquier cliente MCP
Funciona en Claude Desktop, Cursor y cualquier cliente MCP.
Sin clave que pegar: en Claude Code, añade el servidor alojado e inicia sesión con tu cuenta de TwitterAPIs.
$0.50 de crédito gratuito al registrarte, sin tarjeta. Eso cubre aproximadamente 625 llamadas de lectura a $0.0008 cada una antes de que pagues algo.
¿Qué es el servidor MCP de Twitter (X)?
El Servidor MCP de TwitterAPIs es un servidor de Protocolo de Contexto de Modelo que brinda a Claude Desktop, Cursor, Cline y cualquier agente compatible con MCP acceso nativo a la API de Twitter/X. Busca tweets, lee perfiles, seguidores, hilos y listas, y publica, responde, da me gusta, retuitea o sigue desde una cuenta vinculada, todo con un único token de portador. Las llamadas de lectura cuestan $0.0008; las acciones de escritura se facturan desde $0.0008 (creación de tweets $0.0016), las mismas tarifas que la API REST directa.
Cada tarifa aquí es el precio que publica TwitterAPIs. La tarifa facturada es de $0.0008 por llamada de lectura; $0.04 por cada 1,000 tweets se deriva de ella con una página completa de 20 tweets, el tamaño de página predeterminado en lugar de un rendimiento garantizado. Según nuestra propia especificación, 65 de 112 endpoints se facturan a esa tarifa (fuente: twitterapis.com/pricing).
Lo que el servidor ofrece a un agente
Cada cifra a continuación se lee del sistema que la emite: el número de herramientas del paquete npm publicado, el número de endpoints del enrutador REST y los precios de la tarjeta de tarifas que cobra el facturador. Cuando uno de esos cambia, el número en esta página cambia con él en la siguiente compilación.
112
Herramientas MCP
68 lecturas y 44 acciones de escritura, una herramienta por endpoint REST.
112
Endpoints REST detrás de ellas
Llama a cualquiera de ellos directamente por HTTPS con la misma clave.
$0.0008
Por llamada de lectura
Aproximadamente $0.04 por cada 1,000 tweets con una página completa de 20 tweets. La propia API de X cobra $0.005 por publicación leída.
$0.50
Crédito gratuito para empezar
Aproximadamente 625 llamadas de lectura antes de cualquier cargo, y sin necesidad de crear una aplicación de desarrollador de X.
Configuración para Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline
El servidor es el mismo en cada cliente: npx inicia @twitterapis/mcp y cada herramienta de lectura solo necesita tu TWITTERAPIS_KEY, sin pantalla de OAuth de X y sin cuenta de desarrollador de X. Lo que cambia por cliente es el archivo de configuración y la clave bajo la que viven los servidores. Elige tu cliente, pega el bloque, reinícialo y las herramientas twitter_* aparecerán en su lista de herramientas.
claude_desktop_config.json
{
"mcpServers": {
"twitterapis": {
"command": "npx",
"args": ["-y", "@twitterapis/mcp@latest"],
"env": { "TWITTERAPIS_KEY": "YOUR_API_KEY" }
}
}
}
Lo que puedes construir con seis líneas de configuración
Los endpoints de lectura de TwitterAPIs se convierten en herramientas nativas dentro de tu cliente MCP. Sin código de conexión, sin aplicación OAuth de X, sin revisión de alcances.
Pide a Claude que encuentre tweets sobre cualquier tema
Escribe "encuentra publicaciones recientes sobre servidores MCP" en Claude Desktop y el agente llama al endpoint de búsqueda avanzada y resume los resultados en línea.
twitter_advanced_search
Trae las publicaciones recientes de un usuario a Cursor
Configura un comando de barra en Cursor que pase un usuario a la herramienta twitter_user_tweets. La capa MCP obtiene las publicaciones más recientes y las devuelve para redactar o analizar.
twitter_user_tweets
Reconstruye un hilo completo con un agente de Claude
Dale a Claude un ID de tweet y pídele que extraiga toda la conversación. Las herramientas twitter_tweet_thread y twitter_tweet_replies devuelven el árbol completo de respuestas para resumir.
twitter_tweet_thread, twitter_tweet_replies
Crea un panel de análisis de Twitter con Claude Artifacts
Dale a Claude un usuario y un rango de fechas. El agente llama a twitter_user_info, twitter_user_followers y twitter_user_tweets, y luego renderiza un panel de Recharts en un Artifact.
twitter_user_info, twitter_user_followers
Sincroniza seguidores con Notion a través de Claude
Programa un agente de Claude para que llame a twitter_user_followers, elimine duplicados contra tu base de datos de Notion y añada nuevas filas. Sin código de conexión, sin middleware de Zapier.
twitter_user_followers
Monitor de menciones que redacta respuestas
Ejecuta un agente de Cursor o Claude que revise las menciones cada 30 minutos, las clasifique por relevancia y redacte una respuesta que puedas revisar antes de enviar.
twitter_user_mentions
Las herramientas que expone el servidor
El servidor mapea la API de Twitter/X de TwitterAPIs a herramientas MCP. A continuación se muestran las que los agentes usan con más frecuencia. Las herramientas de lectura funcionan solo con tu clave de TwitterAPIs o con el inicio de sesión alojado, sin pantalla de OAuth de X y sin cuenta de desarrollador de X; las acciones de escritura actúan como una cuenta de X vinculada. Cada una envuelve un endpoint al que también puedes llamar por REST directamente.
Herramientas de búsqueda y tweets
Solo TWITTERAPIS_KEY
twitter_advanced_searchBúsqueda avanzada con operadores, filtros y rangos de fechastwitter_tweet_detailConsulta un tweet individual por ID con metadatos completostwitter_tweet_repliesExtrae las respuestas bajo un tweet con paginacióntwitter_tweet_retweetersLista las cuentas que retuitearon un tweettwitter_tweet_threadReconstruye un hilo completo desde un ID de tweet
Herramientas de usuario y grafo
Solo TWITTERAPIS_KEY
twitter_user_infoPerfil, biografía, recuento de seguidores y seguidos para un usuariotwitter_user_tweetsExtrae las publicaciones recientes de un usuariotwitter_user_mentionsLee las menciones de una cuenta (una búsqueda to:username)twitter_user_followersLista los seguidores de una cuenta con paginacióntwitter_user_followingLista las cuentas que sigue un usuariotwitter_user_verified_followersLista los seguidores verificados de una cuenta
Herramientas de lectura adicionales
Solo TWITTERAPIS_KEY
twitter_user_searchBusca usuarios por nombre visible o usuariotwitter_user_info_by_idConsulta un perfil de usuario por ID numéricotwitter_user_tweets_and_repliesExtrae los tweets y respuestas de un usuario juntostwitter_user_mediaLista los tweets de medios (imágenes y video) de un usuariotwitter_list_membersLista los miembros de una lista de X por ID de lista
Acciones de escritura
Sesión de X vinculada
twitter_create_tweetPublica un tweet, respuesta o citatwitter_favorite_tweetDa me gusta a un tweet (deshacer con twitter_unfavorite_tweet)twitter_retweetRetuitea una publicación (deshacer con twitter_unretweet)twitter_follow_userSigue una cuenta (deshacer con twitter_unfollow_user)twitter_dm_sendEnvía un mensaje directo a un usuario
¿Quieres las herramientas de lectura sin la capa MCP? Envuelven los mismos endpoints detrás de nuestra API de búsqueda de Twitter y scraper de Twitter, invocables por HTTP simple. Cada llamada de herramienta se factura a la tarifa estándar de $0.0008 por lectura, y solo necesitas una clave de API de Twitter en el bloque de entorno para empezar.
TODAS LAS HERRAMIENTAS
Las 112 herramientas, qué hace cada una y cuánto cuesta
Esta tabla se genera a partir del paquete @twitterapis/mcp publicado, y una verificación previa hace fallar la compilación si alguna vez no coincide con el paquete, por lo que una herramienta añadida o eliminada en una versión aparece aquí o bloquea el cambio. Las herramientas de lectura solo necesitan tu clave; las herramientas marcadas como tu cuenta actúan como la sesión de X que vinculas.
| Herramienta | Qué hace | Precio por llamada |
|---|---|---|
| Tweets e hilos (6) | ||
twitter_advanced_search | Busca tweets recientes usando los operadores de búsqueda avanzada de X. | $0.0008 |
twitter_tweet_detail | Obtén el detalle completo de un solo tweet: texto, perfil del autor, marca de tiempo de publicación, conteos de me gusta/retweets/respuestas/citas, medios adjuntos, tweet citado referenciado y padre... | $0.0008 |
twitter_tweet_replies | Obtén las respuestas a un tweet específico. | $0.0008 |
twitter_tweet_thread | Obtén todos los tweets de un hilo: la cadena conectada de tweets publicados por el MISMO autor en secuencia (una tormenta de tweets o hilo numerado). | $0.004 |
twitter_tweet_retweeters | Lista las cuentas que retuitearon un tweet específico. | $0.0008 |
twitter_tweet_quotes | Lista los tweets que CITAN un tweet específico, paginados con cursor como objetos de tweet completos, para que obtengas los comentarios que la gente adjuntó en lugar de solo un número. | $0.0008 |
| Usuarios y el grafo de seguidores (21) | ||
twitter_user_search | Busca cuentas de usuario de Twitter/X por nombre visible o handle (búsqueda de personas de X; el texto de la biografía NO se busca, por lo que una palabra que aparece solo en una biografía no devuelve coincidencias). | $0.0008 |
twitter_user_info | Obtén el perfil público completo de un usuario por su @handle: nombre visible, biografía, conteo de seguidores, conteo de seguidos, estado de verificación, ubicación, sitio web, creación de cuenta... | $0.0008 |
twitter_user_info_by_id | Obtén el perfil público completo de un usuario por su id numérico de usuario. | $0.0008 |
twitter_user_status | Comprueba si una cuenta de Twitter/X está activa, suspendida o eliminada. | $0.0008 |
twitter_user_about | Obtén el objeto 'Acerca de' completo de un usuario: los hechos de perfil estructurados que X muestra más allá de la biografía, incluyendo la categoría de cuenta y etiquetas profesionales/de negocio, verificación... | $0.0008 |
twitter_user_about_batch | Obtén el objeto 'Acerca de' (país de la cuenta, cómo se creó la cuenta, historial de cambios de nombre de usuario, verificación y el resto de twitter_user_about) para hasta 100 cuentas... | $0.0008 por elemento |
twitter_user_affiliates | Lista las cuentas afiliadas de un perfil de organización (las cuentas más pequeñas que X muestra bajo la insignia 'Afiliadas' de una empresa, p. ej. | $0.0008 |
twitter_check_follow_relationship | Comprueba la relación de seguimiento entre dos cuentas: si la fuente sigue al objetivo, si el objetivo sigue a la fuente, banderas de bloqueo/silenciamiento cuando estén disponibles. | $0.0008 |
twitter_check_follow_relationship_batch | Comprueba una cuenta contra hasta 100 otras en UNA sola llamada. | $0.0008 por elemento |
twitter_audience_summary | Resume quién es una audiencia en UNA llamada: muestrea hasta 100 seguidores de una cuenta (nombre de usuario o user_id) o retuiteadores de un tweet (tweet_id), lee cada muestra... | $0.0008 por elemento |
twitter_user_tweets | Obtén la línea de tiempo de publicaciones recientes de un usuario. | $0.0008 |
twitter_user_tweets_and_replies | Obtén la línea de tiempo de actividad completa de un usuario: sus tweets originales Y respuestas a otros. | $0.0008 |
twitter_user_tweets_complete | Obtén un lote grande del historial de tweets de un usuario en una llamada, con auto-paginación en el servidor a través de páginas ascendentes. | $0.0024 |
twitter_user_media | Obtén las imágenes y videos que un usuario ha publicado. | $0.0008 |
twitter_user_mentions | Obtén tweets públicos recientes que mencionan (etiquetan con @) a un usuario. | $0.0008 |
twitter_user_likes | Obtén los tweets que a un usuario le han gustado (su pestaña pública de Me gusta), los más recientes primero. | $0.0008 |
twitter_user_followers | Lista las cuentas que siguen a un usuario dado. | $0.0008 |
twitter_user_following | Lista las cuentas que un usuario dado sigue. | $0.0008 |
twitter_user_followers_v2 | Lista los seguidores de un usuario usando la forma de respuesta v2 (campos de perfil más ricos y cursorización más confiable para audiencias grandes). | $0.0008 |
twitter_user_following_v2 | Lista las cuentas que un usuario sigue usando la forma de respuesta v2 (campos de perfil más ricos y cursorización más confiable). | $0.0008 |
twitter_user_verified_followers | Lista los seguidores de un usuario que tienen una cuenta verificada (marca de verificación). | $0.0008 |
| Listas, Spaces, Comunidades y tendencias (14) | ||
twitter_list_members | Lista los miembros de una Lista de Twitter/X por su id numérico de lista. | $0.0008 |
twitter_list_followers | Obtén los seguidores de una Lista pública por su id numérico, paginados con cursor. | $0.0008 |
twitter_list_tweets | Lee las publicaciones escritas por los miembros de una Lista pública de Twitter/X, las más recientes primero, a través del índice de búsqueda de X. | $0.0008 |
twitter_list_timeline | Lee el feed NATIVO de una Lista pública de Twitter/X, las mismas publicaciones y el mismo orden que la Lista muestra en x.com, incluyendo los retweets de los miembros. | $0.0008 |
twitter_spaces_info | Obtén metadatos y la lista de participantes de un X Space por id, en vivo o terminado: título, estado del ciclo de vida (Programado, NoIniciado, EnEjecución o Terminado), anfitrión, temas,... | $0.0008 |
twitter_community_search | Encuentra Comunidades de X por palabra clave, paginadas con cursor. | $0.0008 |
twitter_community_info | Obtén los metadatos de una Comunidad de X por su id numérico: nombre, descripción, member_count, moderator_count, join_policy, invites_policy, la pregunta de unión, principal... | $0.0008 |
twitter_community_about | La pestaña Acerca de de una Comunidad de X: sus moderadores y una vista previa de sus miembros, ambos devueltos como perfiles de usuario COMPLETOS con biografía, conteos de seguidores y seguidos, tweet... | $0.0008 |
twitter_community_members | Lista la lista de miembros de una Comunidad de X, paginada con cursor, con cada fila llevando el propio rol de ese miembro en la comunidad: 'Admin', 'Moderador' o 'Miembro'. | $0.0008 |
twitter_community_moderators | Lista los moderadores y administradores de una Comunidad de X, paginados con cursor, en la misma forma de fila { user, role } que devuelve twitter_community_members (el array también se llama... | $0.0008 |
twitter_community_tweets | Lee la línea de tiempo de publicaciones propia de una Comunidad de X, paginada con cursor como objetos de tweet completos, con la publicación FIJADA de la comunidad devuelta como su propio campo separado 'pinned' en lugar de... | $0.0008 |
twitter_community_memberships | La búsqueda de comunidad INVERSA: dado un id numérico de USUARIO de X, lista las comunidades a las que pertenece esa cuenta, paginadas con cursor. | $0.0008 |
twitter_trends | Obtén las tendencias principales actuales para una ubicación. | $0.0008 |
twitter_trends_locations | Lista cada ubicación para la que X publica tendencias, cada una con el WOEID numérico para pasar de vuelta a twitter_trends como woeid. | $0.0008 |
| Tu propia cuenta de X (sesión vinculada) (17) | ||
twitter_followers_you_know | Lista los 'Seguidores que conoces' para un id de usuario objetivo: los seguidores de esa cuenta que TU cuenta autenticada también sigue (superposición de conexión mutua). | $0.0008 |
twitter_grok_chat | Haz una pregunta al propio Grok de X COMO tu cuenta autenticada, y obtén UNA respuesta JSON completa con la respuesta más las fuentes que citó. | $0.004 |
twitter_grok_config | Comprueba si la cuenta autenticada puede usar Grok, y qué modelos puede elegir. | Gratis |
twitter_home_timeline | Obtén la línea de tiempo de Inicio de TU cuenta autenticada (el feed 'Siguiendo'/'Para ti'), la más reciente primero. | $0.0008 |
twitter_bookmarks | Lista los tweets marcados de TU cuenta autenticada, los más recientes primero. | $0.0008 |
twitter_blocking | Lista las cuentas que TU cuenta autenticada ha BLOQUEADO, como objetos de usuario completos, paginadas con cursor. | $0.0008 |
twitter_muting | Lista las cuentas que TU cuenta autenticada ha SILENCIADO, como objetos de usuario completos, paginadas con cursor. | $0.0008 |
twitter_bookmark_search | Búsqueda de texto completo dentro de los marcadores de TU cuenta autenticada. | $0.0008 |
twitter_bookmark_folders | Lista las CARPETAS de marcadores de TU cuenta autenticada (el nombre interno de X: colecciones), los grupos nombrados en los que puedes organizar tweets guardados, separados de tu lista plana... | $0.0008 |
twitter_bookmark_folder_timeline | Lee los tweets dentro de UNA de las carpetas de marcadores de tu cuenta autenticada, identificada por folder_id (de twitter_bookmark_folders). | $0.0008 |
twitter_dm_list | Lista las conversaciones de Mensajes Directos de TU cuenta autenticada (bandeja de entrada), cada una con el participante y un conversation_id que puedes pasar a twitter_dm_conversation. | $0.0016 |
twitter_dm_conversation | Obtén los mensajes en una conversación de Mensaje Directo por su conversation_id (de twitter_dm_list). | $0.0016 |
twitter_draft_list | Lista los borradores PRIVADOS guardados en tu cuenta autenticada. | $0.0016 |
twitter_scheduled_list | Lista las publicaciones EN COLAs para publicar en tu cuenta autenticada. | $0.0016 |
twitter_media_status | Comprueba si un media_id subido ha terminado de procesarse en X, antes de adjuntarlo a un tweet. | $0.0008 |
twitter_article_get | Lee el contenido completo de un artículo (título, content_state, medio de portada, autor, marcas de tiempo, public_url). | $0.0008 |
twitter_article_list | Lista TUS PROPIOS artículos (borradores o publicados) COMO tu cuenta autenticada, los más recientes primero. | $0.0008 |
| Acciones de escritura (sesión vinculada) (30) | ||
twitter_dm_send | Envía un Mensaje Directo COMO tu cuenta autenticada. | $0.0016 |
twitter_create_tweet | Publica un nuevo tweet COMO tu cuenta autenticada. | $0.0016 |
twitter_delete_tweet | Elimina un tweet COMO tu cuenta autenticada. | $0.0008 |
twitter_update_profile | Cambia el nombre visible, la biografía, la ubicación o el enlace en el propio perfil de X de tu cuenta autenticada. | $0.0016 |
twitter_update_avatar | Reemplaza la foto de perfil en el propio perfil de X de tu cuenta autenticada. | $0.0016 |
twitter_update_banner | Reemplaza la imagen de cabecera ancha en el propio perfil de X de tu cuenta autenticada. | $0.0016 |
twitter_draft_create | Guarda un tweet de borrador PRIVADO en tu cuenta autenticada. | $0.0016 |
twitter_draft_edit | Reemplaza el contenido de un borrador PRIVADO existente en tu cuenta autenticada. | $0.0016 |
twitter_draft_delete | Elimina un borrador PRIVADO de tu cuenta autenticada por id. | $0.0008 |
twitter_scheduled_create | Programa un tweet para PUBLICAR PÚBLICAMENTE en un instante futuro desde tu cuenta autenticada. | $0.0016 |
twitter_scheduled_delete | Cancela una publicación programada PENDIENTE en tu cuenta autenticada para que nunca se publique. | $0.0008 |
twitter_favorite_tweet | Da Me gusta (favorito) a un tweet COMO tu cuenta autenticada. | $0.0008 |
twitter_unfavorite_tweet | Quita un Me gusta (quitar favorito) de un tweet COMO tu cuenta autenticada. | $0.0008 |
twitter_retweet | Retuitea un tweet COMO tu cuenta autenticada. | $0.0008 |
twitter_unretweet | Deshaz un retweet COMO tu cuenta autenticada. | $0.0008 |
twitter_bookmark_tweet | Marca un tweet en los marcadores privados de TU cuenta autenticada. | $0.0008 |
twitter_unbookmark_tweet | Quita un tweet de los marcadores de TU cuenta autenticada. | $0.0008 |
twitter_follow_user | Sigue a un usuario COMO tu cuenta autenticada, por user_id numérico o por @handle (proporciona exactamente uno). | $0.0008 |
twitter_unfollow_user | Deja de seguir a un usuario COMO tu cuenta autenticada, por user_id numérico o por @handle (proporciona exactamente uno). | $0.0008 |
twitter_list_add_member | Añade una cuenta a una Lista de Twitter/X que TU sesión de X registrada posee, por id numérico de lista e id numérico de usuario. | $0.0008 |
twitter_list_remove_member | Quita una cuenta de una Lista de Twitter/X que TU sesión de X registrada posee, por id numérico de lista e id numérico de usuario. | $0.0008 |
twitter_list_create | Crea una nueva Lista de Twitter/X propiedad de TU sesión de X registrada, con un nombre y una descripción y bandera de privacidad opcionales. | $0.0016 |
twitter_media_upload | Sube una imagen a X y obtén un media_id para adjuntar a un tweet vía media_ids de twitter_create_tweet. | $0.0008 |
twitter_article_create | Inicia un nuevo artículo BORRADOR ('Nota') COMO tu cuenta autenticada. | $0.0016 |
twitter_article_update_cover_media | Adjunta una imagen YA SUBIDA como portada de un artículo BORRADOR o PUBLICADO, COMO tu cuenta autenticada. | $0.0016 |
twitter_article_update_title | Establece o reemplaza el título de un artículo BORRADOR o PUBLICADO COMO tu cuenta autenticada. | $0.0016 |
twitter_article_update_content | Reemplaza el contenido del cuerpo de un artículo BORRADOR o PUBLICADO COMO tu cuenta autenticada. | $0.0016 |
twitter_article_publish | Publica un artículo BORRADOR COMO tu cuenta autenticada, transicionándolo a Publicado y publicando un tweet de anuncio REAL y PÚBLICO que tus seguidores y cualquier persona con... | $0.0016 |
twitter_article_unpublish | Revierte un artículo PUBLICADO de vuelta a Borrador COMO tu cuenta autenticada. | $0.0016 |
twitter_article_delete | Elimina un artículo COMO tu cuenta autenticada. | $0.0008 |
| Monitores y webhooks (15) | ||
twitter_monitor_create | Comienza a observar una cuenta de X para nuevas publicaciones. | Gratis |
twitter_monitor_list | Lista todos los monitores de tu cuenta: id, asunto (su consulta from:<handle>), tipo, estado ('active' o 'paused'), indicador de degradación, events_possibly_missed, webhook_ids... | Gratis |
twitter_monitor_update | Actualiza parcialmente un monitor existente: pausa o reanuda mediante status, cambia qué webhooks reciben sus eventos mediante webhook_ids, cambia o limpia su domain_filter, o... | Gratis |
twitter_monitor_delete | Detén y elimina un monitor por id. | Gratis |
twitter_monitor_health | Lee el estado actual de un monitor, su indicador de degradación, el intervalo de sondeo, el recuento de eventos posiblemente perdidos y la posición del cursor (last_tweet_id, last_poll_at), para construir tu... | Gratis |
twitter_monitor_account_health | Resumen de monitoreo a nivel de cuenta en UNA llamada, distinto de twitter_monitor_health (que requiere un id y reporta el cursor de un solo monitor): estado del servicio ('operational'... | Gratis |
twitter_monitor_deliveries | Lista tus eventos de entrega de monitoreo más recientes en todos los monitores, del más reciente al más antiguo: id, monitor_id, tweet_id, status, tweet_created_at, y la medición real... | Gratis |
twitter_x_user_stream_add_user | Reemplazo compatible para twitter_monitor_create usando un envoltorio de solicitud/respuesta con forma de x_user_stream: observa una cuenta de X para detectar nuevas publicaciones, traducido al mismo... | Gratis |
twitter_x_user_stream_remove_user | Reemplazo compatible para twitter_monitor_delete usando un envoltorio con forma de x_user_stream: deja de observar una cuenta. | Gratis |
twitter_x_user_stream_list_users | Reemplazo compatible para twitter_monitor_list usando un envoltorio con forma de x_user_stream: lista todas las cuentas que estás monitoreando actualmente para tweets. | Gratis |
twitter_monitor_webhook_create | Registra un endpoint HTTPS para recibir eventos de monitor firmados. | Gratis |
twitter_monitor_webhook_list | Lista todos los webhooks registrados en tu cuenta: id, url, estado ('active' entrega, 'disabled' significa que el endpoint devolvió un 410 Gone y necesita re-registro para... | Gratis |
twitter_monitor_webhook_delete | Elimina suavemente un webhook por id: deja de recibir entregas inmediatamente y desaparece de twitter_monitor_webhook_list, pero el historial de entregas que lo referencia se... | Gratis |
twitter_monitor_webhook_test | Envía un evento de prueba firmado con HMAC a la URL de este webhook ahora mismo y devuelve el resultado de forma síncrona: entregado (true si tu endpoint devolvió un 2xx dentro del... | Gratis |
twitter_monitor_webhook_redrive | Reproduce entregas que quedaron en cola de mensajes muertos mientras tu endpoint estaba caído. | Gratis |
| Créditos, sesión y comentarios (9) | ||
twitter_account_me | Obtén los detalles de TU cuenta de twitterapis.com: correo electrónico, nombre, créditos restantes, créditos usados, solicitudes totales realizadas y fecha de creación de la cuenta. | Gratis |
twitter_account_payments | Obtén TU historial de pagos de twitterapis.com: la lista de recargas y cargos en tu cuenta. | Gratis |
twitter_feedback_send | Reporta un problema del producto o una brecha en twitterapis.com a su equipo desde esta sesión, de la misma manera que funciona la herramienta de comentarios de Claude Code: un informe se REDACTAA a un archivo local... | Gratis |
twitter_feedback_get | Verifica el estado de un informe de comentarios que esta cuenta envió anteriormente (el id de servidor devuelto por la acción "send" de twitter_feedback_send): estado new, triaged, shipped o... | Gratis |
twitter_feedback_list | Lista los informes de comentarios que esta cuenta ya ha ENVIADO a twitterapis.com, del más reciente al más antiguo. | Gratis |
twitter_customer_session | Registra TU PROPIA sesión de cuenta de X contra tu clave de API, para que las herramientas de cuenta autenticada (twitter_home_timeline, twitter_bookmarks, twitter_dm_list,... | Gratis |
twitter_customer_session_status | Lee la sesión de cuenta de X que registraste con twitter_customer_session, sin cambiarla. | Gratis |
twitter_customer_session_delete | Revoca la sesión de cuenta de X que registraste con twitter_customer_session, eliminando el auth_token y ct0 almacenados de twitterapis.com. | Gratis |
twitter_user_login | Inicia sesión en X con un nombre de usuario y contraseña (además de totp_secret si la cuenta tiene 2FA) y almacena la sesión resultante contra tu clave de API, para que la cuenta autenticada... | $0.01 |
| Generated from @twitterapis/mcp@0.19.0. |
P RUÉBALO
Ejemplos de prompts que funcionan desde el primer día
No llamas a las herramientas tú mismo. Pregunta en lenguaje natural y el cliente elige la herramienta, completa los argumentos y pagina con el cursor devuelto. Estos prompts están escritos para las herramientas tal como existen en la versión actual, y cada uno nombra las herramientas a las que el modelo suele recurrir, para que el costo de una solicitud sea fácil de leer.
"Encuentra publicaciones de las últimas 24 horas sobre servidores MCP con más de 50 me gusta y resume los argumentos."
twitter_advanced_search
"Trae las últimas 50 publicaciones de @vercel y dime qué temas recibieron más respuestas."
twitter_user_tweets, twitter_tweet_detail
"Reconstruye este hilo y enumera cada respuesta que no esté de acuerdo con el autor."
twitter_tweet_thread, twitter_tweet_replies
"¿Qué cuentas siguen a @openai y además están verificadas? Dame las 20 principales por seguidores."
twitter_user_verified_followers, twitter_user_info
"Vigila @stripe en busca de nuevas publicaciones y envía cada una a mi webhook."
twitter_monitor_webhook_create, twitter_monitor_create
"Redacta una respuesta a esta publicación y guárdala como borrador privado, no la publiques."
twitter_draft_create
"¿Cuánto crédito queda en esta clave antes de que empiece una larga sesión de investigación?"
twitter_account_me
CONECTAR
Dos formas de conectar el servidor
El servidor alojado no requiere instalar nada: apunta tu cliente a la URL e inicia sesión cuando lo pida. El servidor npx se ejecuta en tu propia máquina y toma tu clave de un bloque de entorno. Ambos exponen las mismas herramientas; elige dónde quieres que vivan el proceso y la clave.
| Ruta | Cómo añadirla | Dónde destaca | Qué te pide |
|---|---|---|---|
| Alojado (recomendado) https://api.twitterapis.com/mcp | Añade la URL como servidor MCP remoto en tu cliente. Responde a la primera llamada con un aviso de inicio de sesión, lo apruebas una vez y el cliente mantiene la sesión a partir de entonces. | Nada que instalar, sin Node, sin clave pegada en un archivo de configuración y nada que mantener en ejecución. | Necesita un navegador para el inicio de sesión único y un cliente que admita servidores MCP remotos. |
| Local (npx) npx -y @twitterapis/mcp | Añádelo como servidor de tipo comando con TWITTERAPIS_KEY en el bloque de entorno. El cliente inicia el proceso y se comunica con él a través de stdin y stdout. | Funciona en cualquier cliente MCP sin navegador, por lo que los runners de CI y las máquinas headless pueden usarlo. La clave permanece en tu propio entorno. | Necesita Node 18 o superior (el paquete declara engines >=18), y la clave queda en texto plano en la configuración de tu cliente. |
El servidor alojado te autentica, por lo que no hay clave que pegar, pero no es anónimo: aún inicias sesión en una cuenta de TwitterAPIs y las llamadas se facturan a ella exactamente igual que a través de npx.
Qué cliente puede usar cada ruta
El MCP remoto por HTTP con inicio de sesión es más nuevo que el transporte local stdio, por lo que la compatibilidad no es uniforme entre clientes. La ruta npx es la que funciona en todas partes; elige según lo que tu cliente admita hoy, no según cuál sea más nueva.
| Cliente | URL alojada | npx | Qué saber |
|---|---|---|---|
| Aplicación de escritorio de Claude | Sí | Sí | Añade la URL alojada como conector y aprueba el inicio de sesión una vez, o añade npx como servidor local. |
| Claude en la web | Sí | No | Una pestaña del navegador no puede iniciar un proceso local, así que la URL alojada es la única ruta. La disponibilidad de conectores personalizados depende de tu plan de Claude; verifica el tuyo antes de confiar en ello. |
| Claude Code | Sí | Sí | claude mcp add acepta una URL o un comando. |
| Cursor | Sí | Sí | Ambas formas van en el archivo de configuración de MCP. |
| Un agente que escribiste | Depende de tu SDK | Sí | Cualquier biblioteca de cliente MCP habla stdio; el remoto necesita una que implemente el transporte HTTP y un flujo OAuth. |
| CI, un contenedor, una máquina headless | No | Sí | El inicio de sesión necesita un navegador una vez, así que la ruta alojada queda descartada. npx aún necesita acceso de red a la API; lo que elimina es el navegador, no la red. |
AUTENTICACIÓN Y PRECIOS
Una clave, facturación por llamada
Cada herramienta de lectura se autentica con tu cuenta de TwitterAPIs y nada más: la clave bearer en TWITTERAPIS_KEY cuando ejecutas el servidor con npx, o un inicio de sesión cuando añades el servidor alojado. Sin app de desarrollador de X, sin pantalla OAuth de X, sin revisión de alcances. Las herramientas que actúan como una cuenta de X usan una sesión que vinculas una vez, ya sea pegando cookies de tu propio navegador o mediante la herramienta de inicio de sesión. La facturación es por llamada desde tu saldo de crédito.
| Qué | Cómo funciona | Costo |
|---|---|---|
| Herramientas de lectura | Búsqueda, tweets, usuarios, el grafo de seguidores, listas, Spaces, Comunidades, tendencias. | $0.0008 por llamada |
| Hilo completo e historial completo | twitter_tweet_thread expande un hilo completo; twitter_user_tweets_complete pagina el historial de una cuenta en el servidor. | $0.004 y $0.0024 por llamada |
| Acciones de escritura | Publicar, responder, dar me gusta, retweetear, seguir, DM, borradores y publicaciones programadas, como tu sesión de X vinculada. | Desde $0.0008; creación de tweets $0.0016 |
| Monitores y webhooks | Vigila cuentas en busca de nuevas publicaciones y entrega eventos firmados a tu endpoint. Una cuenta monitoreada es gratis; más cuentas requieren un plan de monitoreo mensual. | Gratis por llamada; planes desde $15 al mes |
| Créditos y comentarios | twitter_account_me, historial de pagos y las herramientas de comentarios nunca se miden. | Gratis |
| Crédito de registro | Cada cuenta nueva, sin tarjeta en archivo. | $0.50 gratis |
Tarjeta de tarifas completa: precios. Estima una carga de trabajo primero con la calculadora de costos.
LÍMITES DE TASA
Límites de tasa y qué significa un 429
Hay un solo techo por clave de API, y es el mismo para las herramientas MCP y los endpoints REST porque son las mismas llamadas. No hay ventanas de 15 minutos o 24 horas por endpoint que rastrear. Cada respuesta incluye los encabezados que un agente necesita para dosificarse antes de ver siquiera una negativa.
| Límite | Valor |
|---|---|
| Solicitudes por minuto | 600 por clave de API |
| Solicitudes concurrentes en vuelo | 20 por clave de API |
| Superar cualquiera de los límites | HTTP 429 con un encabezado Retry-After |
| Encabezados en cada respuesta | X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset |
¿Necesitas un techo más alto para un agente por lotes? Envía un correo a emma@twitterapis.com. Detalles completos en la página de límites de tasa.
FRENTE AL MCP OFICIAL DE X
Más allá del servidor MCP propio de X en api.x.com/mcp
X ejecuta un servidor MCP alojado en api.x.com/mcp, y es la opción correcta si ya construyes sobre la API oficial de X. Cada afirmación sobre él en esta tabla se leyó de la documentación propia de X el 2026-09-24, con la fuente enlazada debajo. Cualquier cosa que no pudimos confirmar allí se omite.
| Pregunta | TwitterAPIs MCP | X MCP (api.x.com/mcp) |
|---|---|---|
| Qué necesitas antes de la primera llamada | Una clave de API del registro | Tu propia app de desarrollador de X, creada en el Portal de Desarrolladores de X |
| Cómo se autentica | Una clave bearer en el bloque de entorno (npx), o un inicio de sesión de TwitterAPIs para el servidor alojado | OAuth 2.0 PKCE a través del puente local xurl, con inicio de sesión en navegador en la primera ejecución, o un token bearer solo de app para endpoints de lectura sin contexto de usuario |
| Registro de cliente | No necesario | Sin registro dinámico de cliente; el puente posee la identidad de tu app |
| Cómo se facturan las lecturas | $0.0008 por llamada, hasta 20 tweets por página | Pago por uso desde un saldo que prepagas: $0.005 por publicación leída, $0.010 por usuario leído |
| Techo de volumen | 600 solicitudes por minuto por clave | Planes de pago por uso limitados a 3 millones de lecturas de publicaciones por ciclo de facturación mensual |
| Endpoints de webhook | Monitores y webhooks firmados como herramientas MCP | El servidor xmcp de código abierto de X excluye los endpoints de streaming y webhook |
| Costo inicial | $0.50 de crédito gratis, sin tarjeta | Un saldo prepagado comprado en la Consola de Desarrolladores de X |
Fuentes, leídas el 2026-09-24: docs.x.com/tools/mcp, precios de la API de X, README de xdevplatform/xmcp. También es cierto del lado de X, y vale la pena saberlo: su servidor busca en el archivo completo de publicaciones y admite escrituras de marcadores y Artículos cuando usas la ruta OAuth.
Construye tu propio servidor MCP, o usa el nuestro
La mayoría de los servidores MCP de Twitter en GitHub son envoltorios delgados sobre la API oficial de X. Funcionan, pero heredas la configuración de la API de X y sus límites. Aquí está el intercambio honesto frente al servidor de TwitterAPIs.
Crea el tuyo sobre la API oficial de X
- Crea una app de desarrollador de X en la Consola de Desarrolladores antes de la primera llamada.
- Configura OAuth 1.0a u OAuth 2.0 con PKCE, gestiona la renovación de tokens y almacena secretos por usuario.
- Prepaga un saldo de la API de X: $0.005 por publicación leída y $0.010 por usuario leído, con pago por uso limitado a 3 millones de lecturas de publicaciones al mes (documentos de precios de X, verificados el 2026-09-24).
- Mantén el manejo de límites de tasa y los respaldos de v1.1 a v2 tú mismo.
El servidor MCP de TwitterAPIs (en vivo en npm)
- Una línea para instalar y una clave de API en el bloque de entorno, sin revisión de cuenta de desarrollador.
- Las herramientas de lectura funcionan solo con tu clave de TwitterAPIs o inicio de sesión alojado. Sin pantalla OAuth de X que configurar para búsqueda, perfiles y seguidores.
- Las acciones de escritura (publicar, dar me gusta, retweetear, seguir, DM) actúan como una cuenta de X vinculada, facturadas desde $0.0008.
- Paga por llamada desde $0.0008, sin suscripción mensual y sin puerta de nivel en los endpoints de lectura.
- Código abierto en GitHub. Los mismos endpoints de lectura también se pueden llamar por REST con la misma clave.
SOLUCIÓN DE PROBLEMAS
Síntoma, causa y solución
La mayoría de los problemas de configuración se reducen a un puñado de causas: configuración inválida, clave faltante o incorrecta, saldo vacío, una herramienta de escritura llamada sin sesión vinculada, o una ráfaga que supera el techo por clave. Compara lo que ves en la columna izquierda. Para cualquier cosa no listada, el servidor puede redactar un informe de comentarios que revisas antes de que se envíe.
| Síntoma | Solución |
|---|---|
| Las herramientas twitter_* nunca aparecen | Verifica que la configuración sea JSON válido, que npx esté en tu PATH y que Node.js sea 18 o superior, luego reinicia el cliente por completo. En Claude Code, ejecuta claude mcp list para ver el estado del servidor. |
| claude mcp add falla con -y | Pon cada opción antes del comando del servidor y el comando después de un -- desnudo: claude mcp add twitterapis --env TWITTERAPIS_KEY=... -- npx -y @twitterapis/mcp@latest. |
| HTTP 401 | TWITTERAPIS_KEY falta o es incorrecta en el bloque de entorno. Copia la clave de nuevo desde el panel y reinicia el cliente. |
| HTTP 402 | El saldo de crédito está agotado. Recarga en la página de precios; twitter_account_me muestra el saldo gratis. |
| Una herramienta de escritura dice sin sesión | Las acciones de escritura actúan como una cuenta de X. Vincula una con twitter_customer_session y luego verifícala con twitter_customer_session_status. |
| HTTP 429 | Superaste 600 solicitudes por minuto o 20 en vuelo. Espera el valor de Retry-After y limita la concurrencia en el agente. |
| Menos tweets de los solicitados | Las páginas de búsqueda devuelven unos 20 tweets cada una. Pasa el cursor devuelto para leer la siguiente página. |
DOCUMENTACIÓN
Docs, llms.txt y el código fuente
Si tu agente lee documentación antes de actuar, apúntalo a llms.txt: enumera cada página pública y endpoint en texto plano. La referencia de API documenta el endpoint detrás de cada herramienta con sus parámetros y campos de respuesta, y el paquete npm y el repositorio de GitHub contienen el catálogo y el registro de cambios para la versión exacta que ejecutas.
- llms.txt, el índice del sitio para agentes
- llms-full.txt, la versión de texto completo
- Referencia de API, cada endpoint detrás de las herramientas
- @twitterapis/mcp en npm, README, catálogo y versiones
- Código fuente en GitHub, el servidor de código abierto
- Guía del servidor MCP de Twitter, el tutorial extenso
Preguntas frecuentes
Todo lo que los desarrolladores preguntan antes de cambiar su stack de la API de X a MCP.
¿Qué es el Protocolo de Contexto de Modelo (MCP)?
MCP es un protocolo abierto de Anthropic para conectar asistentes de IA a herramientas y datos externos. Un servidor MCP expone un conjunto de herramientas (con entradas y salidas tipadas) que cualquier cliente compatible (Claude Desktop, Cursor, Cline, Continue, otros) puede llamar durante una conversación. El servidor MCP de TwitterAPIs convierte la API de Twitter/X de TwitterAPIs en herramientas MCP para que Claude pueda buscar tweets, obtener perfiles, listar seguidores, leer hilos, publicar y más.
¿Cómo se compara el servidor MCP de TwitterAPIs con la API oficial de X?
La API oficial de X (Twitter) cobra por uso según un saldo que pagas por adelantado ($0.005 por publicación leída según la tarifa propia de X) y necesita tu propia aplicación de desarrollador de X y un flujo OAuth por usuario. TwitterAPIs cobra por llamada desde $0.0008 por solicitud, sin suscripciones ni revisión de cuenta de desarrollador. El servidor MCP añade cero gastos adicionales más allá de tu clave API de TwitterAPIs existente. Los mismos endpoints y precios que llamar a TwitterAPIs directamente, solo que expuestos como herramientas MCP.
¿Cuánto cuesta usar el servidor MCP?
Nada extra por el servidor en sí. Cada llamada de herramienta llega al endpoint subyacente de TwitterAPIs y se factura a la tarifa estándar de $0.0008 por llamada de lectura (búsqueda, perfil, seguidores, hilos). Tus primeros $0.50 en llamadas son por nuestra cuenta.
¿Con qué clientes MCP funciona esto?
Con cualquier cliente que implemente la especificación MCP: Claude Desktop, Claude Code, Cursor, VS Code (modo agente Copilot), Windsurf, Cline, Continue, y cualquier runtime compatible con MCP, incluidos agentes personalizados construidos sobre el SDK de Anthropic con la capa de transporte MCP.
¿Puede el servidor MCP publicar tweets o escribir en X?
Sí. Junto a las herramientas de lectura, el servidor expone acciones de escritura: crear un tweet (respuesta o cita), dar me gusta, retweetear, marcar como favorito, seguir y enviar un mensaje directo. Las acciones de escritura actúan como una cuenta X vinculada (o credenciales en línea por llamada) en lugar de solo tu clave API, y como X bloquea suavemente las escrituras desde IPs de centros de datos, estas se ejecutan a través de un proxy residencial. La creación de tweets cuesta $0.0016 por llamada y las acciones de escritura más simples cuestan $0.0008.
¿Cómo puedo dar acceso a Twitter a Claude hoy?
Instala el servidor MCP con npx -y @twitterapis/mcp@latest, añade el bloque de configuración a tu cliente MCP (Claude Desktop, Cursor o Cline) y reinicia el cliente. Las herramientas aparecen automáticamente. También puedes llamar a los endpoints REST de TwitterAPIs directamente: cada uno es una sola solicitud HTTP GET con un encabezado Authorization: Bearer TWITTERAPIS_KEY, sin cuenta de desarrollador de X ni pantalla OAuth de X.
¿Cómo empiezo?
Regístrate en twitterapis.com/signup, genera una clave API desde el panel de control y ejecuta npx -y @twitterapis/mcp@latest. Coloca tu clave en la variable de entorno TWITTERAPIS_KEY en la configuración de tu cliente MCP. Envía un correo a emma@twitterapis.com si tienes preguntas.
¿El servidor MCP de TwitterAPIs ya está disponible?
Sí. El servidor MCP está publicado en npm como @twitterapis/mcp y es de código abierto en GitHub. Instálalo con npx -y @twitterapis/mcp@latest y añade un pequeño bloque de configuración a tu cliente MCP. También puedes llamar a cada endpoint directamente por HTTP con tu clave bearer; consulta las páginas de la API de búsqueda de Twitter y del scraper de Twitter.
¿En qué se diferencia el servidor MCP de TwitterAPIs del servidor MCP oficial de X?
X lanzó su propio servidor MCP alojado en api.x.com/mcp en junio de 2026, y es una buena opción si ya usas la API oficial de X: se autentica a través de tu propia aplicación de desarrollador de X con OAuth 2.0 y factura según el precio de pago por uso de la API de X desde un saldo que pagas por adelantado (ambos verificados contra la documentación propia de X el 2026-09-24). El servidor MCP de TwitterAPIs está diseñado para el caso en que no quieres esa configuración. Se autentica con tu cuenta de TwitterAPIs (una clave bearer del registro, o un inicio de sesión en el servidor alojado en api.twitterapis.com/mcp), no necesita cuenta de desarrollador de X ni aplicación OAuth de X, expone el conjunto completo de herramientas de lectura y escritura (búsqueda, perfiles, el grafo de seguidores, hilos, además de publicar, dar me gusta, retweetear y mensajes directos), y factura por llamada desde $0.0008 por solicitud, lo que equivale a unos $0.04 por 1,000 tweets cuando una llamada devuelve una página completa de 20 tweets, con un crédito inicial de $0.50. Usa el servidor de X si quieres la opción nativa de la plataforma y ya pagas por la API de X; usa este para la ruta de pago por uso más económica hacia datos de Twitter y X dentro de un agente sin revisión de cuenta de desarrollador.
¿Necesito una clave API de TwitterAPIs?
Sí. Regístrate en twitterapis.com/signup (con Google o correo electrónico), genera una clave API desde el panel de control y luego colócala en el bloque de entorno de la configuración de tu cliente MCP (TWITTERAPIS_KEY). El servidor MCP lee la clave al iniciar y la reenvía en cada llamada de herramienta. La misma clave también funciona con los endpoints REST.
¿Qué puedo leer a través del servidor MCP?
El servidor expone la superficie de lectura de TwitterAPIs como herramientas MCP: búsqueda avanzada de tweets (twitter_advanced_search), detalle de un tweet individual (twitter_tweet_detail), respuestas, retweeters, hilos, información y búsqueda de usuarios, líneas de tiempo de usuarios, menciones, el grafo de seguidores y seguidos, seguidores verificados y miembros de listas. Cada llamada está protegida por tu clave API de TwitterAPIs.
¿Hay un límite de tasa en el servidor MCP?
El servidor MCP en sí no añade ningún límite propio. La API subyacente de TwitterAPIs permite 600 solicitudes por minuto y 20 solicitudes concurrentes por clave API, muy por encima de lo que una sesión interactiva de Claude o Cursor puede alcanzar; si superas cualquiera de los dos, recibes un 429 con un encabezado Retry-After. Si estás ejecutando un agente por lotes de alto rendimiento, envía un correo a emma@twitterapis.com y subiremos el límite.
¿Hay un servidor MCP de Twitter gratuito?
El servidor MCP de TwitterAPIs es gratuito de instalar. Las llamadas se facturan por solicitud desde $0.0008, y tus primeros $0.50 de uso son gratis, lo que cubre unas 625 llamadas de lectura antes de que pagues un céntimo. La mayoría de los servidores MCP de Twitter de código abierto son gratuitos de ejecutar, pero se apoyan en la API oficial de X, donde cada lectura se factura desde un saldo que pagas por adelantado, $0.005 por publicación leída según la tarifa propia de X (verificado el 2026-09-24). TwitterAPIs factura $0.0008 por llamada y no tiene límites de nivel en los endpoints de lectura.
Dónde encontrarnos
TwitterAPIs está listado en varios mercados de desarrolladores y cubierto por la comunidad. El servidor MCP está publicado en npm como @twitterapis/mcp y es de código abierto en GitHub.
¿Listo para darle a Claude un cerebro de Twitter/X?
Instala el servidor MCP con un solo comando, o llama a los endpoints de lectura directamente por REST. $0.50 de créditos gratis cubren las primeras 625 llamadas.