Servidor MCP

El servidor MCP alojado de Fuxux: el endpoint, iniciar sesión o usar una clave de API, la configuración del cliente, las herramientas y los límites.

Fuxux ofrece un servidor MCP alojado sobre Streamable HTTP. Conecta cualquier cliente MCP y tu agente podrá listar tus cuentas y publicaciones, y redactar, programar y publicar en 14 redes. La configuración completa, cliente por cliente, está en la guía de configuración de MCP (en inglés).

¿Usas Cursor, Claude Code u otro asistente de programación con el servidor MCP de Context7? Esta documentación está indexada allí: añade use context7 a tu prompt o pide la biblioteca /llmstxt/fuxux_llms_txt (Fuxux en Context7). La referencia de la API también está indexada, como Fuxux API.

Endpoint

https://www.fuxux.com/api/mcp

Sin estado: envía JSON-RPC con POST. No hay flujo SSE, así que GET devuelve 405.

Autenticación

Iniciar sesión (OAuth)

Añade el endpoint sin ninguna cabecera. El cliente abre Fuxux en el navegador, inicias sesión y eliges Allow access. Funciona en cualquier plan, también en el gratis. Para desarrolladores de clientes: OAuth 2.1 con PKCE, metadatos en /.well-known/oauth-authorization-server, compatible con Client ID Metadata Documents y con el registro dinámico de clientes; los tokens de acceso duran una hora y se renuevan.

Clave de API

Para clientes sin inicio de sesión (scripts, algunos agentes), envía una clave en cada petición. Las claves de API vienen con todos los planes de pago (Creator, Growth o Pro), sin coste adicional. Las claves empiezan por fx_live_ y se crean en la página API keys.

Authorization: Bearer fx_live_your_key_here

Los clientes que no pueden añadir el prefijo Bearer pueden enviar x-api-key: fx_live_… en su lugar.

Configuración rápida

Claude Code, iniciando sesión:

claude mcp add --transport http fuxux https://www.fuxux.com/api/mcp

Cursor (~/.cursor/mcp.json), con una clave en la variable de entorno FUXUX_API_KEY:

{
  "mcpServers": {
    "fuxux": {
      "url": "https://www.fuxux.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:FUXUX_API_KEY}" }
    }
  }
}

Herramientas

Herramienta	Qué hace
`whoami`	Comprueba la conexión y devuelve tu email y tu plan.
`list_connected_accounts`	Tus cuentas sociales conectadas, con los ids que usan los targets de `create_post`.
`get_dashboard`	Estadísticas, próximas publicaciones y cuentas que necesitan atención.
`list_posts`	La cola, filtrada por `month`, `status` (scheduled, published, draft, failed), con `limit` (1–50), `offset` y `order`.
`create_post`	Publica ahora, programa con `scheduled_at` o guarda un borrador con `draft: true`. `targets` elige las cuentas; los textos pueden ser distintos en cada plataforma.
`get_post`	Una publicación con sus versiones y resultados por plataforma.
`update_post`	Reprograma, edita textos o cambia los archivos de un borrador o de una publicación programada.
`delete_post`	Elimina una publicación de Fuxux (no de la red si ya se publicó).

Ids de plataforma: twitter, instagram, linkedin, facebook, tiktok, youtube, bluesky, threads, pinterest, discord, kick, twitch, telegram, slack.

Límites

120 peticiones por minuto por clave de API, y 300 por minuto por cuenta entre todas las claves y apps con sesión iniciada. Por encima del límite, las herramientas indican cuántos segundos esperar.
No hagas sondeos: la publicación se resuelve en pocos minutos, así que consulta una publicación con get_post como mucho una vez por minuto.
Cuando una regla de la red bloquea una publicación (por ejemplo, Instagram necesita una imagen o un vídeo), la herramienta devuelve el motivo como error.

Ver en Markdown (en inglés)