Skip to main content
Glama
deenesjakoruzh
RobertDWhite

x-mcp

by RobertDWhite
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

x-mcp

Servidor MCP frente a la API v2 de X (Twitter). Imagen: ghcr.io/robertdwhite/x-mcp. Manifiestos en whitehouse-rke2 (apps/ai/x-mcp/).

Las lecturas son gratuitas. Las escrituras son de dos pasos — draft_post devuelve una vista previa más un confirm_token de un solo uso, y no se publica nada hasta que se llama a publish_post con ese token exacto. Un agente no puede publicar en una sola llamada, por lo que siempre existe primero una vista previa visible para humanos. Eso importa cuando la salida es pública y permanente.

Deliberadamente no hay herramienta de borrado. El borrado es destructivo e irreversible; elimina las publicaciones desde la aplicación de X.

Herramientas

Herramienta

Tipo

Notas

whoami

lectura

Qué cuenta representan las credenciales

get_tweet

lectura

Una publicación por id

get_user_posts

lectura

Publicaciones recientes de un usuario

get_mentions

lectura

Menciones de la cuenta autenticada

get_home_timeline

lectura

Cronología de inicio en orden cronológico inverso

search_recent

lectura

Búsqueda de los últimos 7 días (según plan)

draft_post

etapa

Valida + previsualiza. No publica nada.

list_drafts

lectura

Borradores en etapa y su TTL restante

publish_post

escritura

Publica un borrador. Público y permanente.

Los borradores están en memoria: un reinicio los borra, por lo que un token de confirmación obsoleto nunca sobrevive al proceso que mostró la vista previa.

Related MCP server: x-mcp

Endpoints

  • POST /mcp — MCP HTTP transmisible, protegido con Authorization: Bearer $MCP_TOKEN

  • GET /healthz — abierto, para liveness/readiness

Cualquier otra ruta devuelve 404, no 401 — incluyendo las sondas /.well-known/oauth-* que los clientes MCP hacen al iniciar. Un 401 allí hace que los clientes intenten un flujo OAuth interactivo, que cuelga a los clientes sin interfaz como un tiempo de espera de conexión.

Configuración

Env

Requerido

Propósito

MCP_TOKEN

recomendado

Bearer para /mcp. Sin definir = sin autenticación.

X_API_KEY

sí

Clave de consumidor

X_API_SECRET

sí

Secreto de consumidor

X_ACCESS_TOKEN

sí

Token de acceso (contexto de usuario)

X_ACCESS_TOKEN_SECRET

sí

Secreto del token de acceso

X_MAX_CHARS

no

Límite de longitud, por defecto 280. Aumentar para premium.

X_DRAFT_TTL

no

Vida útil del borrador en segundos, por defecto 600

X_TIMEOUT

no

Tiempo de espera HTTP, por defecto 30

La autenticación con X es OAuth 1.0a contexto de usuario, firmada por solicitud. Los tokens de portador solo de aplicación no pueden publicar, porque publicar actúa como la cuenta. Obtén los cuatro valores de una aplicación de X con permiso Lectura y Escritura: claves de consumidor más un par de token/secreto de acceso generado para tu propia cuenta.

Si faltan las credenciales, cada herramienta devuelve un error claro de "no configurado" en lugar de un rastreo de pila — para que el servicio pueda desplegarse antes de que existan las credenciales.

Nota sobre los planes de la API de X

El acceso de escritura está limitado por los niveles de pago de la API de X, y el nivel gratuito está muy restringido. Un 429 de este servidor muestra el restablecimiento del límite de velocidad cuando X lo proporciona. Consulta tu plan en developer.x.com si las escrituras fallan de inmediato.

Ejecución local

pip install -r requirements.txt
MCP_TOKEN=dev X_API_KEY=... X_API_SECRET=... \
  X_ACCESS_TOKEN=... X_ACCESS_TOKEN_SECRET=... python server.py

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • TwitGhost

    arvinmoj
    A
    license
    B
    quality
    D
    maintenance
    Enables interacting with Twitter/X through natural language, including searching tweets, posting, sending DMs, and managing timelines via any MCP client.
    8
    MIT

  • x-mcp

    namank42
    F
    license
    A
    quality
    D
    maintenance
    Enables interaction with the X (Twitter) API through MCP tools for managing users, posts, bookmarks, likes, and lists. Supports markdown or JSON output and uses OAuth 2.0 PKCE authentication.
    22
    -

  • x-mcp-server

    lluisfont
    F
    license
    B
    quality
    B
    maintenance
    MCP server for the official X API, enabling agents to read and publish posts, look up users, and search posts with safe read-only default and explicit write mode.
    8
    6 npm
    -

  • x-mcp-ai

    IvanBBaev
    A
    license
    A
    quality
    A
    maintenance
    Enables MCP clients to interact with the X (Twitter) API v2 through 41 typed tools for reading, searching, engaging, publishing, and managing content, with policy-based access control and session credit budgets to prevent overspending.
    41
    74 npm
    1
    MIT