poster.ly / Posterly MCP

MCP/API en vivo para que agentes de IA puedan redactar y programar publicaciones de Instagram/redes sociales sin un panel de control. Programador social nativo de IA. Con sede en Dubái.

Ver en poster.lyPrueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://www.poster.ly/api/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servidor MCP de posterly

Programa y publica publicaciones en redes sociales desde Claude Desktop, ChatGPT, Cursor, Windsurf, Cline o cualquier otro cliente de IA compatible con MCP. Hay dos opciones de conexión disponibles: elige la que mejor se adapte.

Opción de conexión 1: stdio (paquete npm)

Para clientes de IA de escritorio que ejecutan un servidor MCP como subproceso local.

No necesitas una instalación global. Añade esto a la configuración MCP de tu cliente y deja que npx ejecute el servidor actual:

{
  "mcpServers": {
    "posterly": {
      "command": "npx",
      "args": ["-y", "posterly-mcp-server@latest"],
      "env": { "POSTERLY_API_KEY": "pst_live_your_key_here" }
    }
  }
}

Si el usuario aún no se ha registrado, instala el servidor sin POSTERLY_API_KEY. Las herramientas públicas get_mcp_status, get_agent_signup_info, start_signup y get_signup_session permiten que una IA verifique su instalación MCP, inicie el registro de pago y consulte el progreso antes de que exista una clave API de Posterly. Después de que el usuario complete el pago y la configuración de la contraseña, añade POSTERLY_API_KEY para desbloquear las herramientas de programación y conexión.

Estilo de respuesta del agente

Las herramientas de registro y conexión devuelven pasos siguientes legibles por humanos de forma predeterminada. Los agentes deben mantener el chat limpio: enviar los enlaces seguros del navegador, informar del progreso y evitar comandos curl sin procesar, cargas HTTP o JSON a menos que el usuario pida explícitamente depurar.

Usa debug: true solo cuando necesites datos sin procesar de registro o conexión de start_signup, get_signup_session, get_connect_link, create_connect_session o get_connect_session.

Las herramientas de programación devuelven enlaces del panel de Posterly. Después de crear, listar, leer o eliminar publicaciones, comparte el enlace View in Posterly devuelto. Las publicaciones programadas del mes actual se abren en Calendario con la publicación seleccionada; las vistas generales/futuras usan Tabla.

Opción de conexión 2: HTTP

Para clientes de IA basados en navegador y en la nube (Claude en Chrome, aplicaciones de modo desarrollador de ChatGPT, Cursor en navegador, Grok Bot). Páginas de conexión dedicadas: Claude, ChatGPT, Cursor, Grok Bot, Poke, Hermes y OpenClaw. Guías de primera programación: ChatGPT, Claude, Cursor, Poke, Hermes, OpenClaw, Grok Bot Marketplace. Medios: Resolviendo el límite de 4MB de MCP.

  • Endpoint: POST https://www.poster.ly/api/mcp
  • Formato de transmisión: JSON-RPC 2.0 (solicitud única, sin SSE en v1)
  • Cabecera de autenticación: Authorization: Bearer pst_live_your_key_here
  • Indicación de capacidad: GET /api/mcp devuelve información del servidor sin autenticación
curl -s https://www.poster.ly/api/mcp \
  -H "Authorization: Bearer pst_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Conexión gestionada a través de Smithery

Smithery proporciona una conexión gestionada al mismo endpoint HTTP MCP alojado:

  1. Abre https://smithery.ai/servers/awpthorp/posterly
  2. Añade posterly a tu caja de herramientas de Smithery
  3. Inicia sesión en tu propia cuenta de posterly
  4. Revisa los ámbitos solicitados y aprueba la conexión OAuth
  5. Prueba con whoami o list_accounts

Cada conexión pertenece al usuario de posterly que la aprobó. Otros usuarios de Smithery no pueden acceder a las cuentas o publicaciones de ese usuario. Aún se requiere un plan de pago de posterly más el complemento API/MCP.

Guía completa: https://www.poster.ly/blog/smithery-social-media-mcp-server

Herramientas (90 stdio, 87 HTTP alojado)

El paquete stdio incluye cuatro herramientas públicas de configuración antes de la autenticación:

  • get_mcp_status: muestra la versión del servidor instalado, la última versión npm, el estado del endpoint MCP, el estado de autenticación de la API y las recomendaciones de actualización.
  • get_agent_signup_info: explica el flujo de registro seguro guiado por el agente.
  • start_signup: inicia el registro de pago y devuelve una URL de entrega de pago de Posterly más una URL de consulta de registro.
  • get_signup_session: consulta el estado del pago, la contraseña y el acceso del agente.

Las herramientas MCP autenticadas requieren POSTERLY_API_KEY:

  • whoami: confirma la autenticación y consulta los espacios de trabajo y ámbitos.
  • create_api_key: crea una nueva clave API con ámbito específico tras confirmación explícita. La clave que realiza la llamada debe ser una clave creada desde el panel, y los nuevos ámbitos no pueden exceder los de la clave llamante.
  • delete_api_key: revoca una clave API creada por el usuario tras confirmación explícita.
  • get_credits: lee el saldo de créditos de IA para la billetera del espacio de trabajo del llamante: disponible ahora, asignación incluida usada y restante, paquetes comprados y el próximo restablecimiento (requiere billing:read). Solo lectura, no gasta nada.
  • get_subscription: lee el estado de la suscripción a posterly, el nivel y el estado de cancelación/pausa (requiere billing:read).
  • cancel_subscription: cancela la suscripción tras confirmación explícita; el agente solicita al usuario un reason primero (requiere billing:write).
  • pause_subscription: pausa la suscripción durante 30 días, una vez por período de reutilización de 90 días, tras confirmación (requiere billing:write).
  • resume_subscription: reanuda una suscripción pausada (requiere billing:write).
  • downgrade_subscription: baja un nivel en la próxima renovación tras confirmación (requiere billing:write).
  • list_accounts: lista las cuentas sociales conectadas.
  • disconnect_account: desconecta una cuenta social conectada tras confirmación explícita.
  • get_connect_link: inspecciona los enlaces de conexión del panel, la preparación del proveedor, los ámbitos y los recuentos de cuentas conectadas.
  • connect_account: conecta una cuenta basada en credenciales (telegram, bluesky, discord, wordpress, devto, hashnode, lemmy) directamente, sin necesidad de sesión de navegador.
  • create_connect_session: crea una transferencia guiada por navegador para conectar una cuenta social.
  • get_connect_session: consulta el progreso de la conexión mientras el usuario inicia sesión, aprueba OAuth o introduce credenciales.
  • list_oauth_clients / create_oauth_client / update_oauth_client / delete_oauth_client: gestiona clientes de desarrollador públicos de OAuth 2.1 + PKCE de autoservicio tras confirmación.
  • list_platforms / get_platform_schema: inspecciona integraciones compatibles, esquemas de configuración, límites de medios, herramientas auxiliares y posibles proveedores planificados.
  • trigger_platform_helper: ejecuta descubrimiento auxiliar como tableros de Pinterest, listas de reproducción de YouTube, información del creador de TikTok, menciones recientes de LinkedIn o cuota de X.
  • list_brands: lista las marcas/clientes disponibles en tus espacios de trabajo.
  • get_brand: inspecciona una marca/cliente en detalle.
  • list_brand_accounts: lista las cuentas sociales asignadas a una marca/cliente.
  • get_brand_profile: lee el perfil de marca guardado y las pautas de voz para una marca/cliente, incluido learned_voice derivado de los subtítulos publicados reales de cada cuenta conectada.
  • get_learned_voice: lee la voz aprendida de los subtítulos publicados reales de una cuenta (los "subtítulos aprendidos" mostrados en el panel), claveada por ID de cuenta social. Solo lectura.
  • list_posts / get_post / get_post_missing: navega por el contenido programado e inspecciona el contenido o la configuración faltante antes de publicar.
  • ask_support: realiza preguntas de soporte autenticadas respaldadas por documentación con diagnósticos de solo lectura de cuentas/publicaciones. La transferencia a un humano requiere confirmación explícita.
  • create_post: programa o publica una publicación, incluidas cadenas de X/Threads y controles de compositor específicos de la plataforma.
  • validate_post: valida y normaliza una publicación sin crearla; úsalo antes de mostrar la vista previa final y pedir confirmación de creación en vivo.
  • submit_agent_feedback: envía telemetría operativa privada y limitada después de un flujo de trabajo real; nunca incluyas secretos, indicaciones, subtítulos, URL de medios ni datos personales.
  • submit_product_feedback: presenta un error de producto, idea o comentario en el tablero público después de que el usuario confirme el título y la categoría; nunca lo uses para fallos de herramientas (usa submit_agent_feedback).
  • create_posts_batch: crea hasta 25 publicaciones confirmadas en una sola solicitud de API, con resultados de éxito o error por elemento.
  • generate_captions: genera o adapta sugerencias de subtítulos conscientes de la marca sin crear una publicación.
  • update_post / update_post_status / update_post_release_id / delete_post / delete_post_group: gestiona contenido programado, repara metadatos de publicación/grupo y limpia borradores/publicaciones programadas agrupados tras confirmación. Actualizar una publicación aprobada por el cliente reabre el eje de revisión modificado (las ediciones de subtítulos reabren la aprobación de subtítulos, los cambios de medios reabren la aprobación de activos) para que vuelva a revisión pendiente del cliente.
  • upload_media: solo archivos base64 pequeños. El MCP HTTP alojado es JSON en una ruta de Vercel con un cuerpo de solicitud de ~4MB.
  • upload_media_from_url / create_signed_upload: obtiene una URL pública (archivos pequeños) o genera una URL PUT firmada de almacenamiento de objetos para archivos grandes. El PUT a upload_url no alcanza el límite de 4MB de Vercel. Los límites de video por plan son Starter 500MB, Pro 750MB, Power 1GB, Agency 4GB. Usa create_signed_upload cuando el cliente pueda hacer PUT (Cursor, Claude Code, Codex).
  • create_media_drop / list_media: para archivos de ChatGPT web y Claude.ai laptop, llama a create_media_drop, envía al usuario https://www.poster.ly/drop/<token> y luego list_media. Los archivos adjuntos del chat nunca llegan al MCP. HEIC y PDF son rechazados. Mapa más largo: https://www.poster.ly/blog/solving-the-4mb-mcp-limit
  • find_available_slot: encuentra el próximo espacio de publicación libre respetando el intervalo de 1 hora y las horas preferidas.
  • generate_image: pone en cola un trabajo de Railway Nano Banana / Grok. La calidad de Gemini es model + resolution + thinking_level (quality: "high" activa el pensamiento). El pensamiento no cambia el precio en créditos. Pasa reference_image_urls para fijar un logotipo.
  • get_image_job: consulta un trabajo de imagen en cola o lista trabajos recientes hasta que urls estén listos.
  • get_video_options: inspecciona modelos de video Veo de solo lectura, modos de entrada, duraciones y estimaciones de costo en créditos.
  • run_video_function: estima y valida trabajos de video Veo antes de gastar créditos.
  • generate_video / get_video_job: pone en cola trabajos de video Veo con protección de costos y consulta el video_url final.
  • get_account_analytics: resúmenes de seguidores/alcance para plataformas sociales, además de métricas nativas del panel como Vistas de perfil GBP, Vistas de búsqueda, Vistas de mapas, Acciones de clientes y Publicaciones. Usa presentation: "compact" para viñetas de Telegram/móvil, "table" para clientes Markdown o "json" para renderizadores personalizados de gráficos/tarjetas.
  • get_post_analytics: me gusta, comentarios, alcance e impresiones por publicación. Admite los mismos modos de presentation.
  • get_performance_profile: lee el perfil de rendimiento de 90 días de una cuenta (formatos principales, tiempos, patrones de longitud de subtítulos, tendencia de tasa de interacción, resumen narrativo). Plan Pro o superior.
  • get_post_insights: lista información del bucle de retroalimentación por publicación (nivel de rendimiento, diagnóstico, próxima acción, métricas, línea base), filtrable por cuenta, publicación y punto de control. Plan Pro o superior.
  • list_post_suggestions: lista borradores semanales de publicaciones basados en evidencia en la voz aprendida de cada cuenta, cada uno con una justificación. Plan Pro o superior.
  • dismiss_suggestion: descarta una sugerencia de publicación tras confirmación; nunca toca una ya programada.
  • list_conversations: lista los DM de la bandeja de entrada de Instagram y Facebook Page. Threads no tiene DM. Requiere plan Pro o superior.
  • get_conversation: obtiene una conversación de la bandeja de entrada y sus mensajes.
  • send_message: envía una respuesta DM tras confirmación explícita. Respeta las ventanas de mensajería de 24 horas de Meta.
  • list_comments: lista los comentarios de la bandeja de entrada de Instagram, Facebook Page, Threads y LinkedIn Page.
  • get_comment: obtiene un comentario de la bandeja de entrada y sus respuestas.
  • reply_to_comment: responde a un comentario tras confirmación explícita. Facebook no tiene respuestas privadas a comentarios; Threads y LinkedIn son solo públicos.
  • update_comment: oculta/muestra un comentario o lo marca como leído. Ocultar es reversible y no elimina. Los comentarios de LinkedIn no se pueden ocultar.
  • delete_comment: elimina un comentario de la bandeja de entrada de Instagram o Facebook Page tras confirmación. Irreversible. Solo administradores. Las respuestas de Threads no se pueden eliminar; ocúltalos con update_comment. Los comentarios de LinkedIn no se pueden eliminar.
  • sync_inbox: extrae los datos más recientes de la bandeja de entrada para una cuenta de Instagram, Facebook, Threads o LinkedIn, con un período de reutilización de 30 segundos (60 segundos para LinkedIn). Threads y LinkedIn son solo comentarios (sin DM).
  • list_google_business_reviews: lista las reseñas de GBP para una ubicación o cada ubicación accesible. Devuelve cada reseña que Google tiene (pagina más allá del límite de 50 por página de Google), con el texto completo sin truncar y la fecha. Filtra por rating/unanswered, pagina con limit (predeterminado 200, máximo 1000) y offset, y lee el total_review_count, average_rating y error de cada ubicación.
  • get_google_business_review_link / audit_google_business_profile: genera enlaces públicos de reseñas y ejecuta auditorías de perfil local.
  • suggest_google_business_review_reply: redacta respuestas a reseñas GBP conscientes de la marca sin publicar.
  • reply_google_business_review / delete_google_business_review_reply: gestiona respuestas públicas a reseñas GBP tras confirmación explícita.
  • list_google_business_media: lista las fotos y videos en la galería del perfil GBP.
  • add_google_business_media / delete_google_business_media: agrega una foto/video a la galería del perfil desde una URL pública, o elimina uno, tras confirmación explícita.
  • list_activity: lee el feed de notificaciones del agente sobre actividad de publicaciones, intentos de publicación, fallos y reintentos.
  • get_updates: obtiene las últimas actualizaciones de producto y noticias de posterly desde el feed de actualizaciones. Requiere una suscripción activa a posterly.
  • list_webhooks: inspecciona las suscripciones de webhook y el estado de entrega.
  • create_webhook / update_webhook / delete_webhook / test_webhook: gestiona suscripciones de webhook firmadas tras confirmación explícita.
  • get_x_posting_quota: inspecciona la asignación gestionada de publicaciones en X y el estado de bloqueo de URL.

Precios

El acceso a API + MCP es un complemento que cuesta $3/mes en Starter/Pro, $5/mes en Power o $29/mes en Agency (los planes base comienzan en $7/mes). Los endpoints de creación de publicaciones permiten 100 solicitudes por hora por clave; las escrituras de medios y las llamadas de solo lectura tienen límites más altos separados. Esto no significa que solo puedas programar 100 publicaciones por hora: usa create_posts_batch para crear hasta 25 publicaciones en una solicitud confirmada. Los límites de clave API creadas por el usuario se basan en el nivel: Starter 1, Pro 2, Power 3, Agency 4.

Controles de programación específicos de la plataforma

Las herramientas MCP exponen los mismos controles disponibles en el compositor de posterly a través de platform_settings:

  • Feed, historias, carruseles, colaboradores, etiquetas de usuarios, primer comentario, texto alternativo, Reels de prueba, portadas de Reels, contenedor principal is_ai_generated y Reels con licencia audio_id de Instagram (solo cuentas vinculadas a Facebook Login / Meta)
  • Historias, reels, intención de foto de portada, fondos de texto de color y portadas de Reels de Facebook
  • Título, miniatura, estado de privacidad, hecho para niños, etiquetas, categoría, brandPartner opcional y lista de reproducción de YouTube (la inserción en listas de reproducción permanece desactivada a menos que ya esté habilitada)
  • Título y nombre de archivo del documento, menciones de organizaciones, miniatura de video, texto alternativo y etiquetas de llamada a la acción del contenido, incluidos BUY_NOW y SHOP_NOW de LinkedIn
  • Privacidad de publicación directa, alternancias de comentarios/duet/stitch, título, presentaciones de diapositivas de fotos y divulgación comercial de TikTok
  • Tablero, título, enlace de destino, etiquetas de producto opcionales y un cover_image_url JPEG/PNG almacenado obligatorio para Pines de video de Pinterest (máximo 20 MiB; alias video_cover_url y pinterest_cover_image_url). Los Pines de video usan carga registrada y un ID de medio, no una obtención pública de video_url.
  • Publicaciones estándar, de eventos y de ofertas de Google Business Profile con horario de eventos, detalles de ofertas, CTA y recurrencia de EVENTO/OFERTA
  • Configuración de respuestas, encuestas, asociación pagada y texto alternativo de medios de X
  • Controles de respuestas, adjuntos de texto, publicaciones fantasma, spoilers, aprobaciones de respuestas, adjuntos de GIPHY y texto alternativo de medios de Threads
  • Encuestas, modo de análisis, botones en línea, portada de video, marca de tiempo de inicio, fotos en vivo y controles de vista previa de enlaces de Telegram
  • Markdown de Block Kit y bloques personalizados de Slack
  • Visibilidad, advertencia de contenido, ID de cita, encuesta (medios más encuesta permitidos en 4.6+) y límites de texto, adjuntos y texto alternativo proporcionados por la instancia de Mastodon (1,500 caracteres es solo el respaldo de descubrimiento conservador para texto alternativo). Los subtítulos y las advertencias de contenido se validan en lugar de acortarse silenciosamente. Las respuestas ambiguas finales de creación o carga detienen los reintentos automáticos.
  • Idiomas, texto alternativo de medios, etiquetas de contenido, etiquetas ocultas, publicaciones de cita y controles de citas de Bluesky

Metadatos de autenticación para agentes

Comenzar

  1. Regístrate: https://www.poster.ly/signup
  2. Habilita el complemento de API en https://www.poster.ly/dashboard/api
  3. Genera una clave y pégala en la configuración de tu cliente
  4. Reinicia tu cliente de IA y comienza a publicar