x-mcp

Un servidor MCP con opiniones propias para gestionar una cuenta de X con un agente.

No es un envoltorio de la API de X. Es un pequeño operador que sabe cuatro cosas que la API no te cuenta:

1. Cómo clasifica Para ti — los pesos, compuertas y filtros del algoritmo de código abierto de X (xai-org/x-algorithm) están integrados en cada herramienta como salvaguardas y consejos: peso de respuesta 5→20 para mutuos, compartir por enlace 20, me gusta 0.5; vídeo estrictamente >10s; ≤1 mención @; sin cebo de interacción; ≥4h entre originales; el primer favorito abre el corpus fuera de la red; impulso de arranque en frío para cuentas con <1k seguidores; ventanas de 24h/48h.

2. Lo que realmente permite la API de pago por uso — desde 2026 X rechaza respuestas no solicitadas y eliminó los seguimientos, me gusta y citas de autoservicio. Las herramientas hacen todo lo permitido y entregan al humano un enlace de intención de un toque para el resto, luego reconcilian automáticamente lo que el humano hizo a partir de lecturas propias de $0.001.

3. Cuánto cuesta cada llamada — un libro de contabilidad local refleja los precios por recurso de X (con la deduplicación de 24h), aplica un presupuesto mensual y te avisa antes del "post con URL" de $0.20.

4. Lo que un negocio conserva — un libro de relaciones de todos los que interactuaron (y a quién seguir de vuelta), un calendario que aprende tus mejores horas, un libro de marca que comparte cada sesión, un pipeline de ideas y un bucle de informes/insights para que el agente se guíe por sus propios números en lugar de por corazonadas.

Construido sobre el SDK de TypeScript de MCP v2. stdio por defecto, HTTP Streamable opcional. Cero dependencias de ejecución más allá del SDK y zod.

Herramientas

Recursos: x://playbook (las reglas), x://boundary (lo que permite la API), x://handoff (cola humana en vivo). Prompt: operate (el bucle de trabajo).

Related MCP server: X(Twitter) V2 MCP Server

Configuración

1. Crea una aplicación en https://console.x.com → habilita OAuth 2.0 → tipo de aplicación Native App (pública, PKCE) o Automated App/Bot (confidencial, da un secreto de cliente) → añade URI de redirección http://127.0.0.1:8477/callback → copia el ID de cliente (y el secreto si es confidencial). Carga algunos créditos (pago por uso).

2. Configura — las variables de entorno se leen del entorno o de ~/.x-mcp/.env (nunca del directorio actual, para que el .env de un repositorio hostil no pueda redirigir tu token):

   cd x-mcp && npm install && npm run build
   mkdir -p ~/.x-mcp/media && cp .env.example ~/.x-mcp/.env   # set X_CLIENT_ID (+ X_CLIENT_SECRET if confidential)

   Los medios que el agente pueda subir deben estar en ~/.x-mcp/media (o en los directorios de X_MCP_MEDIA_ROOT) — coloca tu vídeo de demostración allí.

3. Inicia sesión una vez (abre un navegador, guarda tokens en ~/.x-mcp/tokens.json, modo 0600):

   node dist/bin.js login

4. Conéctalo a tu agente.

   Hermes (~/.hermes/config.yaml):

   mcp_servers:
     x:
       command: node
       args: ["/absolute/path/to/x-mcp/dist/bin.js"]
       env:
         X_CLIENT_ID: "…"
         X_CLIENT_SECRET: "…"          # confidential apps only
         X_MCP_MONTHLY_BUDGET_USD: "25"
         X_MCP_REQUIRE_APPROVAL: "true" # default; keep until you have X's AI-reply approval
       timeout: 180

   Claude Code:

   claude mcp add x -e X_CLIENT_ID=… -e X_MCP_REQUIRE_APPROVAL=true -- node /absolute/path/to/x-mcp/dist/bin.js

   HTTP en lugar de stdio: X_MCP_HTTP_TOKEN=SECRET node dist/bin.js --http --port 8478 → url: http://127.0.0.1:8478/mcp, cabecera Authorization: Bearer SECRET. Siempre se requiere un token (se genera e imprime uno si no lo estableces); Host/Origin se verifican contra localhost.

5. Ejecuta el bucle. Pide al agente que use el prompt operate (o pégalo). Comprueba node dist/bin.js queue para ver si hay algo esperándote; node dist/bin.js approve --all ejecuta las acciones de API en cola; toca los enlaces de intención para las acciones solo humanas y ejecuta handoff(reconcile) (o deja que el agente lo haga) para que la cola se vacíe sola.

6. Pon tick en un temporizador (cada 15 min es suficiente) para que las publicaciones programadas salgan, los handoffs se reconcilien y las métricas se capturen para insights:

   */15 * * * * cd /absolute/path/to/x-mcp && node dist/bin.js tick >> ~/.x-mcp/tick.log 2>&1

   (Usuarios de Hermes: un trabajo cron que llame a schedule(run_due) + handoff(reconcile) + post_performance hace lo mismo.)

Configuración (env)

Qué rechazará y por qué

• Dos o más @menciones en una publicación → se enrutan al puntaje de spam LLM en tiempo real de X. Pon los créditos en una respuesta.

• «Me gusta si / RT para / etiqueta a alguien» → SpamHighRecall, sin exención para nadie.

• Un video ≤10.0s → la cabecera del video es 0 y la publicación se excluye de todos los corpus de video.

• Video + imagen en una misma publicación → descalificado de los corpus de video.

• Un segundo original dentro de 4h → ×0.625 en slates compartidos; el impulso de arranque en frío elige una publicación por solicitud.

• El mismo texto de respuesta dos veces → agrupación de copypasta.

• Responder a una publicación que no te @mencionó → X lo rechaza; en su lugar obtienes un enlace de intención.

• Cualquier gasto que supere el presupuesto mensual.

Todo lo blando se puede anular con force: true, que siempre enruta la acción a la cola de aprobación humana; las raíces de medios, el presupuesto y los propios límites de X no se pueden anular.

Modelo de seguridad (resumen)

• Los tokens/estado viven en ~/.x-mcp (directorio 0700, archivos 0600); el servidor y la CLI x-mcp approve los comparten de forma segura (recargar antes de escribir, nunca sobrescribir un conjunto de tokens más reciente).

• El agente no puede leer archivos arbitrarios: media_paths debe resolverse dentro de las raíces de medios; los IDs se validan como copos de nieve numéricos (sin contrabando de rutas ../ hacia otros endpoints).

• Las acciones irreversibles o sensibles a políticas (delete_post, cualquier force, DMs, modo de aprobación) requieren un toque humano en la CLI. delete_post solo acepta publicaciones que este servidor sabe que son tuyas.

• El texto de terceros en las salidas de herramientas se etiqueta como datos, no como instrucciones. El modo HTTP necesita un token de portador y valida Host/Origin.

Notas de política que deberías leer

• Las reglas de automatización de X (abril de 2026) requieren aprobación escrita previa para bots de respuestas de IA, una respuesta automática por interacción de usuario, sin publicaciones duplicadas, sin seguimientos/me gusta/DMs masivos, y la etiqueta de cuenta Automatizada (Configuración → Tu cuenta → Información de la cuenta → Automatización). Este servidor aplica las partes mecánicas; la aprobación y la etiqueta son tuyas para obtener y configurar.

• El caso de uso del acuerdo de desarrollador que enviaste debe describir lo que hace el agente (publicación, lecturas de métricas propias, investigación de nicho).

Desarrollo

npm test          # rules engine + full server through an in-memory MCP client against a mock X API
npm run typecheck
npm run build

Fuentes: documentación de la API de X (docs.x.com, leída el 2026-08-19: precios, restricciones de manage-posts, changelog, media v2, OAuth 2.0), y xai-org/x-algorithm@11a71f8 (home-mixer/params/param.rs, scorers/, filters/, visibility-filtering/, phoenix/, grox/). Consulta docs/FOR_YOU_PLAYBOOK.md en el clon de x-algorithm para la investigación completa con citas archivo:línea.

MIT.