Skip to main content
Glama
deenesjakoruzh
RobertDWhite

x-mcp

by RobertDWhite
OverviewSchemaRelated ServersScoreDiscussions
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: pyX-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 installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
F
license - not found
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • TwitGhost

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

  • pyX-MCP

    hellocybernetics
    F
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to post, search, and manage tweets on X (Twitter) via the MCP protocol.
    10
    2

  • 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

  • twitterapis

    TwitterAPIs
    A
    license
    A
    quality
    B
    maintenance
    MCP server for the Twitter/X read API, enabling search, user profiles, tweets, followers, and more via natural language.
    94
    149
    MIT

View all related MCP servers

Related MCP Connectors

  • excalibur-mcp

    FastMCP server for posting formatted content to X (Twitter) — Tollbooth-monetized, DPYC-native

  • Xquik MCP Server

    128 REST operations. 120 MCP routes; 119 JSON/text ops. OAuth 2.1. Not affiliated with X Corp.

  • uluesky

    Bluesky MCP — wraps the AT Protocol API

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/RobertDWhite/x-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server