Para agentes

Publicar en redes sociales desde tu agente de IA

PlanVortex es una plataforma de publicación en redes sociales con API pública y servidor MCP oficial. Un agente puede programar publicaciones, leer la bandeja de comentarios y contestar mensajes directos en trece redes, y pedirle a nuestro planificador que escriba la semana entera. Se instala con un comando y se autentica con las credenciales de tu cuenta.

npx -y planvortex-mcpEl servidor MCP oficial. No hay nada que instalar: lo arranca tu cliente de IA.

Necesitas una app de PlanVortex, y las hay en los cuatro planes: 1 en el gratuito, 2 en Basic, 5 en Pro y hasta 10 en Custom. No hace falta pagar para conectar un agente.

Publicado en el registro oficial de MCP, en Glama y en Smithery.

Superficie

Qué puede hacer un agente con PlanVortex

Veintiocho herramientas, agrupadas por aquello sobre lo que actúan. Diecinueve leen y nueve escriben. La vigésima novena, create_ai_plan, no está en la lista hasta que tú la enciendes, porque gasta créditos de IA de tu cuenta.

GrupoHerramientas
Contextolist_organizationslist_accountsget_plan_useget_unread_counts
Publicaciónlist_publicationsget_publicationcreate_publicationupdate_publicationretry_publication
Planificador de IAget_planner_templateslist_ai_plansget_ai_plan(create_ai_plan)
Mediosupload_media
Comentarioslist_commentsget_comment_threadreply_to_commenthide_commentmark_comment_read
Mensajeslist_conversationslist_messagessend_message
Númerosget_dashboard_summaryget_publication_statsget_top_publicationsget_account_metrics
Catálogoget_social_limitsget_social_capabilitiescreate_connect_link

Además: tres prompts listos para usar —weekly_plan, inbox_triage y publish_from_brief— y cuatro recursos con los límites de cada red, sus capacidades, la matriz de comentarios y tus organizaciones. Las diferencias entre redes viajan como datos, así que el modelo no tiene que adivinar qué deja hacer cada una.

Las trece redes

Facebook, Instagram, Threads, LinkedIn, TikTok, X, WhatsApp, YouTube, Google Business, Bluesky, Discord, Telegram y Slack. Once de ellas publican; WhatsApp y Google Business no tienen dónde —una es mensajería y la otra una ficha con reseñas—, así que en ésas el agente lee, contesta y mide. Slack va justo al revés y conviene decirlo: publica y mide, pero no tiene comentarios ni mensajes directos, porque es un canal de equipo y no una audiencia.

El diferencial

La llamada que escribe y publica a la vez

Casi cualquier servidor MCP de redes sociales deja que sea el modelo quien escriba los textos. Éste no hace falta que lo haga: PlanVortex tiene su propio planificador, y el agente puede pedirle una semana entera a partir de un tema, de tus fotos, de un artículo o del catálogo de tu tienda.

Conversación con el agente
> Preparame la semana para el horno: pan de masa madre,
  usa mis fotos de agosto y publicalo en Instagram y LinkedIn.

get_planner_templates()
  → from_images: 0 creditos de imagen · 7 publicaciones

create_ai_plan({ template: "from_images", accounts: [...] })
  → presupuesto: 350 creditos · estado: pending

get_ai_plan(plan)   // minutos despues
generated · 7 borradores con texto y foto
generated· siete borradores, ninguno publicado todavía

Generar tarda minutos y no es una sola llamada: create_ai_plan encola el plan y devuelve el presupuesto, get_ai_plan se sondea hasta que termina, y lo que sale son borradores. Programarlos sigue siendo una decisión tuya, de uno en uno.

El coste se sabe antes de generar

El servidor calcula lo que cuesta el plan y lo devuelve al encolarlo. Un plan que no cabe en tus créditos se rechaza entero en vez de generarse a medias, así que un agente en bucle no puede vaciarte la cuenta sin que lo veas.

Y lo enciendes tú, con una línea

create_ai_plan es la única herramienta que gasta dinero, así que sólo se registra con PLANVORTEX_MCP_ALLOW_AI=1 en tu configuración. Apagada no aparece siquiera en la lista de herramientas: no hay forma de llamarla. Lo escribe una persona, una vez, antes de que ningún agente arranque.

Cinco plantillas, y una no gasta imágenes

get_planner_templates publica las cinco con lo que cuesta cada una, así que el agente puede explicarte el precio antes de pedirte permiso. La que parte de tus propias fotos no gasta un solo crédito de imagen.

Instalación

Cómo se instala el servidor MCP

Tres pasos, y ninguno pasa por nosotros: el servidor se ejecuta en tu máquina, con tus credenciales.

  1. Crea una app en el panel

    En Ajustes → Apps. Te da un client_id y un client_secret. Las apps están en los cuatro planes, así que esto no cuesta nada en el gratuito.

  2. Añade el servidor a tu cliente de IA

    Un comando en Claude Code, o el bloque de JSON de aquí abajo en Claude Desktop, Cursor y VS Code. No hay que instalar nada: npx lo descarga al arrancar.

  3. Pídele algo

    «¿Qué tengo programado esta semana, y qué comentarios siguen sin leer?». Si contesta con tus cuentas de verdad, está funcionando.

Claude Code
claude mcp add planvortex \
  --env PLANVORTEX_CLIENT_ID=... \
  --env PLANVORTEX_CLIENT_SECRET=... \
  -- npx -y planvortex-mcp
Claude Desktop · Cursor · VS Code
{
  "mcpServers": {
    "planvortex": {
      "command": "npx",
      "args": ["-y", "planvortex-mcp"],
      "env": {
        "PLANVORTEX_CLIENT_ID": "...",
        "PLANVORTEX_CLIENT_SECRET": "...",
        "PLANVORTEX_ORGANIZATION_ID": "..."
      }
    }
  }
}

PLANVORTEX_ORGANIZATION_ID es opcional y merece la pena: sin él, el agente gasta una llamada por conversación en averiguar con qué organización trabajas.

¿Sin Node instalado? Cada versión publica también un paquete .mcpb que Claude Desktop instala de un doble clic.

Descargar el .mcpb de la última versión →

Todas las variables de entorno

Variable¿Obligatoria?Qué hace
PLANVORTEX_CLIENT_IDEl client_id de tu app. Todos los planes tienen apps.
PLANVORTEX_CLIENT_SECRETSu secreto. Nunca viaja como argumento de una herramienta.
PLANVORTEX_ORGANIZATION_IDnoOrganización por defecto. Ahorra una llamada de descubrimiento por conversación.
PLANVORTEX_BASE_URLnoApunta a otro despliegue de PlanVortex.
PLANVORTEX_MCP_UPLOAD_DIRSnoLas carpetas de las que upload_media puede leer. Vacía significa ninguna.
PLANVORTEX_MCP_AUTH_TOKENcon --http fuera de localEl token que exige el endpoint HTTP para atarse a algo que no sea local.
PLANVORTEX_MCP_READ_ONLYno1 quita de la lista las nueve herramientas que escriben.
PLANVORTEX_MCP_ALLOW_AIno1 añade create_ai_plan, que gasta créditos de IA.
PLANVORTEX_MCP_LOG_LEVELnodebug, info, warn, error o silent. Siempre a stderr.
Guía: publicar desde tu asistente de IA con MCP →
Límites

Qué no puede hacer, y cómo apagar lo que sí

Este servidor mete en el contexto del modelo texto que escribieron desconocidos —un comentario, una reseña, un mensaje directo— mientras ese mismo modelo tiene herramientas para publicar en tus cuentas. Los límites de abajo son la respuesta a eso, y el primero no es un ajuste.

No borra nada, y no se puede encender

Ninguna herramienta borra una publicación, una cuenta ni un comentario. No es una opción apagada por defecto: el código no existe. El peor caso posible tiene que ser algo que ves y deshaces.

Sólo lectura, de verdad

Con PLANVORTEX_MCP_READ_ONLY=1 las nueve herramientas que escriben no se registran, así que no salen en la lista y el modelo no puede intentar llamarlas. Quedan diecinueve que sólo leen.

Corre en tu máquina

El client_secret vive en el proceso que arranca tu cliente de IA, nunca en un servidor nuestro. Y si prefieres alojarlo tú, el modo --http trae su Dockerfile, escucha sólo en local y exige un token para atarse a cualquier otra cosa.

No lee tu disco

upload_media sólo abre ficheros dentro de las carpetas que declares en PLANVORTEX_MCP_UPLOAD_DIRS, y esa lista está vacía de fábrica. Sin configurarla, el agente no puede subir un fichero tuyo aunque el modelo lo pida.

Sin MCP

Si tu agente no habla MCP, habla HTTP

MCP es la puerta cómoda, no la única. Todo lo que hace el servidor está también en la API pública, que está abierta en los cuatro planes y no exige plan de pago para integrarse.

La API, 135 operaciones

OAuth 2.0 con client_credentials, JSON, y el mismo catálogo de errores numerado que usan las librerías. La documentación completa está publicada y es pública.

Ver la documentación →

Dos librerías oficiales

npm i planvortex y pip install planvortex. Las dos publican con provenance, traen el gestor de token, la subida de ficheros y los errores con tipo.

Para desarrolladores →

Y cuatro ficheros que puedes leer sin rastrear nada

Están en la raíz del sitio, son texto plano y no llevan JavaScript delante. Si eres un agente evaluando esta herramienta, empieza por aquí.

  • /llms.txtQué es PlanVortex, para quién, con los precios verificados
  • /llms-full.txtLa API entera en texto plano: las 135 operaciones con sus parámetros
  • /openapi.jsonEl OpenAPI completo, para generarte un cliente en cualquier lenguaje
  • /pricing.mdLa tarifa, en markdown y sin rellenar un formulario
Preguntas

Preguntas frecuentes

¿Qué es el servidor MCP de PlanVortex?

Es el servidor oficial de Model Context Protocol que conecta un asistente de IA con tus cuentas de redes sociales. Da veintiocho herramientas para programar publicaciones, leer comentarios, contestar mensajes y consultar métricas en trece redes. Se instala con npx, corre en tu máquina y usa las credenciales de una app de tu cuenta de PlanVortex.

¿Necesito un plan de pago para conectar un agente?

No. Las apps que dan las credenciales están en los cuatro planes, incluido el gratuito, que trae 1 app, 3 cuentas conectadas, publicaciones ilimitadas y 1 GB de espacio, sin tarjeta. Lo que cambia con el plan es cuántas apps separadas caben y el ritmo de llamadas, no si puedes integrarte.

¿En qué redes sociales puede publicar un agente?

En once: Facebook, Instagram, Threads, LinkedIn, TikTok, X, YouTube, Bluesky, Discord, Telegram y Slack. WhatsApp y Google Business completan las trece, pero en ellas no se publica: son mensajería y ficha de reseñas, así que ahí el agente lee, contesta y mide.

¿Puede un agente borrar una publicación o una cuenta?

No. Ninguna de las veintinueve herramientas borra una publicación, una cuenta ni un comentario, y no es una opción desactivada: ese código no existe en el servidor. Es la única garantía seria que se le puede dar a un modelo que lee texto de desconocidos mientras puede publicar en tu nombre.

¿Dónde acaba mi client_secret?

En el proceso que arranca tu cliente de IA, en tu máquina. No pasa por ningún servidor nuestro y nunca viaja como argumento de una herramienta, así que no acaba en el historial de la conversación ni en el contexto del modelo.

¿Puede el agente escribir el contenido, no sólo programarlo?

Sí, y no lo escribe el modelo: lo escribe el planificador de PlanVortex a partir de un tema, de tus fotos, de un artículo o del catálogo de tu tienda. Generar gasta créditos de IA, así que esa herramienta hay que encenderla a mano con PLANVORTEX_MCP_ALLOW_AI=1. Lo que sale son borradores.

¿Funciona con Claude Desktop, Cursor y VS Code?

Sí. Claude Code se configura con un comando y los otros tres con el mismo bloque de JSON en su fichero de servidores MCP. Si no tienes Node, cada versión publica además un paquete .mcpb que Claude Desktop instala de un doble clic.

¿Y si mi agente no usa MCP?

Entonces usa la API pública por HTTP: 135 operaciones con OAuth 2.0, abiertas en los cuatro planes. Hay librerías oficiales de Node y de Python, el OpenAPI completo publicado en la raíz del sitio y una versión de la documentación en texto plano pensada para que la lea un modelo.

Empezar

Un comando, y tu asistente publica

Crea una app en el plan gratuito, pega las dos credenciales en tu cliente de IA y pídele lo que tengas programado esta semana. No hace falta tarjeta.