Onepostly MCP

Servidor MCP

Servidor MCP remoto para Onepostly: publica, programa y mide desde cualquier cliente MCP.

Copiar Markdown

Onepostly proporciona un servidor MCP remoto sobre HTTP Streamable.

https://mcp.onepostly.com

https://mcp.onepostly.com/mcp también está disponible como alias.

Autenticación

Autentícate con una clave de API del espacio de trabajo. Crea una en Panel → Configuración → Claves de API.

Authorization: Bearer op_YOUR_KEY

x-api-key: op_YOUR_KEY

Para clientes que no pueden configurar encabezados (por ejemplo, Claude.ai web), usa el parámetro de consulta:

https://mcp.onepostly.com?access_key=op_YOUR_KEY

Las claves read_only pueden llamar a las herramientas list_* y get_*; las herramientas de escritura devuelven FORBIDDEN.

Herramientas

Tool	Descripción
list_connections	Lista cuentas conectadas (filtra por plataforma)
publish_post	Publica inmediatamente: todas las plataformas, validación por plataforma, débito de cartera
schedule_post	Programa para el futuro (scheduledFor hora local + zona horaria)
list_posts	Lista publicaciones, más recientes primero
get_post_status	Obtén el estado de la publicación y de los destinos
get_insights	Obtén métricas normalizadas para una publicación
delete_post	Elimina un destino publicado
get_pinterest_boards	Lista tableros de Pinterest (llama antes de publicar en Pinterest)
get_tiktok_creator_info	Obtén opciones de privacidad del creador de TikTok (llama antes de publicar en TikTok)

publish_post y schedule_post comparten la misma validación que POST /v1/posts. El uso de X se factura como pase directo desde tu cartera. 402 INSUFFICIENT_WALLET significa recargar en Configuración → Facturación.

Conectar

Claude Desktop, Claude Code, Cursor

{
  "mcpServers": {
    "onepostly": {
      "url": "https://mcp.onepostly.com",
      "headers": {
        "Authorization": "Bearer op_YOUR_KEY"
      }
    }
  }
}

Claude.ai (web)

Pega la URL con ?access_key:

Inspector

npx @modelcontextprotocol/inspector@latest

• URL: https://mcp.onepostly.com
• Encabezado: Authorization: Bearer op_YOUR_KEY
• Encabezado: MCP-Protocol-Version: 2025-11-25

Ejemplos

Listar conexiones

tool: list_connections

Publicar

{
  "tool": "publish_post",
  "arguments": {
    "text": "Hello from Onepostly",
    "destinations": [{ "connectionId": "YOUR_CONNECTION_ID" }]
  }
}

Programar

{
  "tool": "schedule_post",
  "arguments": {
    "text": "Hello tomorrow",
    "scheduledFor": "2026-08-10T09:00:00",
    "timezone": "America/New_York",
    "destinations": [{ "connectionId": "YOUR_CONNECTION_ID" }]
  }
}

Protocolo

• Transporte: HTTP Streamable (POST JSON-RPC 2.0).
• Versión: 2025-11-25 (encabezado MCP-Protocol-Version y params._meta["io.modelcontextprotocol/protocolVersion"]).
• Descubrimiento: server/discover devuelve supportedVersions y capabilities.

Notas

• Sin notificaciones iniciadas por el servidor; consulta get_post_status o usa webhooks.
• Los límites de tasa y cartera son idénticos a los de la API REST.

Introducción

Una API para todas las redes sociales.

Inicio rápido

Publica tu primera publicación con una clave de API.