Ravenpost

Programa y publica publicaciones en Instagram, TikTok, X, LinkedIn, Facebook, Telegram, Threads, Bluesky y YouTube, previsualizando cada una exactamente como la red la mostrará.

Documentación

Servidor MCP de Ravenpost

Programa y publica publicaciones en redes sociales en Instagram, TikTok, X, LinkedIn, Threads, Bluesky, YouTube, Pinterest y Telegram desde Claude, ChatGPT, Cursor, Claude Code o cualquier otro cliente MCP.

Ravenpost es un programador de redes sociales multiplataforma que cubre esas nueve redes (Facebook Pages está construido pero no se ofrece en este momento — Meta permite que una aplicación tenga solo la familia de permisos de inicio de sesión de Instagram o la de Facebook, y Ravenpost eligió Instagram). Este repositorio documenta su servidor MCP alojado, que expone el mismo flujo de publicación a cualquier cliente MCP: lista las cuentas que has conectado, sube o reformatea medios, previsualiza una publicación exactamente como cada red la renderizará, y luego publícala ahora, prográmala o colócala en una cola de publicación semanal.

El servidor está alojado. No hay nada que instalar ni nada que ejecutar.

https://api.ravenpo.st/mcp

Transporte: HTTP Streamable. Entrada oficial en el registro: st.ravenpo/ravenpost.

Conexión

Dos formas, y la primera no requiere ningún manejo de credenciales.

OAuth (recomendado). Añade la URL anterior como conector personalizado e inicia sesión cuando tu cliente abra Ravenpost. El servidor es un servidor de recursos OAuth — /.well-known/oauth-protected-resource nombra el servidor de autorización y el 401 lleva el desafío — por lo que un cliente que hable autorización MCP ejecuta todo el flujo por sí mismo.

Token de acceso personal. Para clientes sin flujo de navegador. Genera uno en Ravenpost en Configuración → Tokens MCP (se muestra una vez, revocable en cualquier momento):

claude mcp add --transport http ravenpost https://api.ravenpo.st/mcp \
  --header "Authorization: Bearer rvp_your_token"

Los clientes que no pueden establecer cabeceras pueden pasarlo en la URL en su lugar — https://api.ravenpo.st/mcp?token=rvp_….

Necesitas una cuenta de Ravenpost con al menos una cuenta social conectada. El plan gratuito es suficiente para probarlo.

Herramientas

22 herramientas. Cada una declara un título y sugerencias de solo lectura / destructivas, para que tu cliente pueda decirte qué hará una llamada antes de que la permitas.

Cuentas

HerramientaQué hace
list_workspacesCada espacio de trabajo en el que la credencial puede actuar. Con más de uno, las otras herramientas requieren un workspaceId en lugar de adivinar qué cliente querías.
list_accountsCuentas conectadas con sus ids, plataformas y estado.

Publicaciones

HerramientaQué hace
list_postsLista publicaciones recientes, opcionalmente filtradas por estado.
get_postUna publicación con el estado y enlace permanente de cada destino.
preview_postRenderiza una publicación como cada plataforma la mostrará sin crear nada — una tarjeta interactiva en clientes que soporten MCP Apps, y recuentos de caracteres por plataforma en el resto.
create_postBorrador, publicar, programar o poner en cola una publicación en cualquier conjunto de cuentas.
update_postEdita un borrador o una publicación programada — la restablece a borrador, así que pasa una acción para reenviarla.
delete_postElimina la copia de Ravenpost y cancela una publicación pendiente. Nunca elimina una publicación en vivo de una red.
schedule_postMueve una publicación a una nueva hora.
publish_postPublica una publicación inmediatamente.

Medios

HerramientaQué hace
upload_mediaSube una imagen o video desde una URL, una ruta local (solo desarrollo) o base64; las imágenes se reformatean a la forma de plataforma que nombres.
create_media_uploadSubida directa prefirmada — para archivos grandes o de producción, para que los bytes nunca pasen por el contexto del modelo.
attach_mediaRegistra una subida directa como un activo, reformateando una imagen o grabando un video tal cual.
create_variantsCorta una imagen en varios lienzos de plataforma a la vez, recortando sobre el sujeto en lugar del centro.
list_mediaActivos de medios recientes, para reutilizar uno en lugar de volver a subirlo.
image_formatsLos formatos de imagen y dimensiones objetivo que upload_media acepta.

Analíticas

HerramientaQué hace
get_analyticsSeguidores por cuenta y participación en publicaciones recientes.
best_timesHoras de publicación recomendadas medidas a partir de las publicaciones propias de este espacio de trabajo — con una respuesta explícita de "aún no hay suficientes datos" en lugar de una suposición confiada.

Referencia

HerramientaQué hace
list_audioBusca en el catálogo de audio con licencia de Instagram una pista para reel.
list_queue_slotsEl horario de publicación semanal y el próximo espacio libre.
list_boardsLos tableros de Pinterest que posee cada cuenta conectada — un pin tiene que nombrar uno, y Pinterest no tiene predeterminado.
platform_limitsPresupuestos de subtítulos, reglas de medios y especificaciones recomendadas por plataforma.

Habilidades

Las herramientas son la capacidad; las habilidades son el criterio sobre cuándo recurrir a cuál. Este repositorio es también un plugin — cuatro habilidades que enseñan a un asistente el flujo de trabajo en el que se insertan las herramientas:

HabilidadQué enseña
publish-a-social-postResolver el espacio de trabajo, elegir las cuentas, recopilar lo que cada destino requiere, previsualizar antes de escribir, y la confirmación que una publicación necesita — porque publicar es el único paso que no se puede deshacer
manage-scheduled-postsEncontrar, editar, mover, cancelar y revisar publicaciones — incluyendo que editar restablece una publicación a borrador, y que eliminar quita nuestra copia en lugar de la publicada
prepare-post-mediaCómo introducir archivos, los cuatro lienzos, cortar una imagen para varias redes, y las reglas de medios con las que una publicación realmente falla
measure-and-time-postsLeer analíticas sin convertir "no recopilado" en un cero, y citar best_times solo cuando tiene una respuesta
plugin.json                 portable manifest (Agent Plugins 1.0.0)
.claude-plugin/plugin.json  the same, for clients that read this path
.mcp.json                   points at the hosted server above
skills/<name>/SKILL.md      one workflow each
skills/publish-a-social-post/references/
    tools.md                every tool, its arguments and what it returns
    platforms.md            caption budgets, media rules, per-platform limits

Ambos archivos de referencia están generados a partir de los propios registros de herramientas y del registro de plataformas del servidor, no transcritos — una habilidad que describe un argumento que el servidor ya no acepta es peor que una que no dice nada, porque el modelo la sigue y la llamada falla.

Dos cosas que vale la pena saber

Previsualiza antes de publicar. preview_post no escribe nada. Devuelve la publicación tal como cada destino la renderiza, junto con las advertencias que una imagen no puede transmitir: un subtítulo que supera el límite de la plataforma seleccionada más estricta, una red que requiere medios cuando no hay ninguno, un hilo dirigido a una plataforma sin modelo de hilos, audio fuera de un reel. Una previsualización que se ve bien y guarda silencio sobre un rechazo es peor que ninguna previsualización.

Se niega a adivinar tu espacio de trabajo. Una credencial actúa como un usuario, y un usuario puede ejecutar varios espacios de trabajo (uno por cliente, en el plan Agency). Pide a una herramienta con ámbito de espacio de trabajo con más de uno disponible y dará error, nombrándolos, en lugar de publicar el contenido de un cliente en las cuentas de otro.

Enlaces

Acerca de este repositorio

Documentación y el manifiesto de registro (server.json) para un servicio alojado. El código fuente propio de Ravenpost no es público. Los problemas sobre el servidor MCP son bienvenidos aquí; cualquier cosa específica de una cuenta debe ir al soporte.