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 todas tus redes sociales, y pedirle a nuestro planificador que escriba la semana entera. En Claude se conecta desde su directorio de conectores sin instalar nada; en cualquier otro cliente es un comando, con las credenciales de tu cuenta.

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

En Claude solo necesitas tu cuenta de PlanVortex. Para ejecutarlo en tu máquina 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.

En el directorio de conectores de Claude, y publicado en el registro oficial de MCP, en Glama y en Smithery.

Superficie

Qué puede hacer un agente con PlanVortex

Treinta y una herramientas, agrupadas por aquello sobre lo que actúan. Veintidós leen y nueve escriben. La trigésima segunda, 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_publicationlist_destinationscreate_publicationupdate_publicationretry_publication
Planificador de IAget_planner_templateslist_store_productslist_ai_plansget_ai_planget_ai_plan_results(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.

Redes disponibles

Facebook, Instagram, Threads, LinkedIn, TikTok, X, WhatsApp, YouTube, Bluesky, Discord, Telegram, Slack y Pinterest. Todas publican salvo WhatsApp, que es mensajería, así que ahí el agente lee, contesta y mide. Slack va justo al revés: publica y mide, pero no tiene comentarios ni mensajes directos, porque es un canal de equipo y no una audiencia. Pinterest publica y mide, pero tampoco tiene comentarios (su API no los da), y cada pin va a un tablero: el agente los lista con list_destinations y elige uno en cada publicación.

El diferencial

La llamada que escribe la semana

Casi cualquier servidor MCP de redes sociales deja que sea el modelo quien escriba los textos. Con este no hace falta: 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 solo 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 dos no gastan 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. Las que parten de tus propias fotos o de tu catálogo no gastan un solo crédito de imagen.

Instalación

Cómo se instala el servidor MCP

En Claude no hay nada que instalar. En tu máquina son tres pasos, y ninguno pasa por nosotros: el servidor se ejecuta allí, con tus credenciales.

En Claude, sin instalar nada

En el navegador, en la app de escritorio o en el móvil: abre PlanVortex en el directorio de conectores de Claude, pulsa Connect, inicia sesión con tu cuenta de PlanVortex y pulsa Allow. Sin Node, sin app y sin client_secret, y funciona en los cuatro planes. Claude te pide confirmación antes de publicar, contestar u ocultar algo.

En Claude Code es una línea, también sin credenciales. Después escribe /mcp, elige planvortex y pulsa Authenticate: el navegador abre el mismo inicio de sesión.

Claude Code · alojado
claude mcp add --transport http planvortex \
  https://mcp.planvortex.com/mcp

Claude actúa como tú, con lo que te dejan tus roles en el panel. Respecto al servidor local cambian tres cosas: las cuentas sociales se conectan en el panel, los planes de IA también se crean allí (Claude los lee) y upload_media toma una URL pública, porque el servidor no ve tu disco.

Abrir PlanVortex en el directorio de Claude →
  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_IDsíEl client_id de tu app. Todos los planes tienen apps.
PLANVORTEX_CLIENT_SECRETsíSu 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.

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.

Modo de solo lectura

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 veintidós que solo 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 solo en local y exige un token para atarse a cualquier otra cosa.

No lee tu disco

upload_media solo 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

Todo lo que hace el servidor MCP está también en la API pública, abierta en los cuatro planes, el gratuito incluido.

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 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 →

Un nodo para n8n

Si tu agente vive en un flujo de n8n, el nodo verificado de PlanVortex publica, sube ficheros y contesta comentarios sin escribir una sola petición. Usa las mismas credenciales de app.

Ver el nodo →

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 treinta y una herramientas para programar publicaciones, leer comentarios, contestar mensajes y consultar métricas en todas tus redes sociales. Se instala con npx y corre en tu máquina con las credenciales de una app, o, en Claude, se conecta desde el directorio de conectores con 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, 2 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.

¿En qué redes sociales puede publicar un agente?

En Facebook, Instagram, Threads, LinkedIn, TikTok, X, YouTube, Bluesky, Discord, Telegram, Slack y Pinterest. En WhatsApp no se publica: es mensajería, así que ahí el agente lee, contesta y mide.

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

No. Ninguna de las treinta y dos 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 solo 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í. En Claude (navegador, app de escritorio y móvil) está en el directorio de conectores: inicias sesión con tu cuenta de PlanVortex y no instalas nada. Claude Code se configura con un comando, y Cursor y VS Code con el mismo bloque de JSON en su fichero de servidores MCP.

¿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. Y si trabaja dentro de n8n, tiene un nodo verificado: n8n-nodes-planvortex.

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.