Desarrolladores · API · MCP

Tu agente de IA controla tus 12 redes. De forma nativa.

Un token, 12 redes, 12 sistemas de autenticación que nunca tendrás que mantener. API REST + servidor MCP nativo: dile a Claude o a Cursor "prepara mi semana" — hecho. Buffer y Hootsuite no tienen esto.

Conectar con Claude / Cursor Ver la API REST

REST · /app/api MCP · /api/mcp JSON-RPC 2.0 · 2025-06-18

01 · Autenticación

Un token, dos interfaces.

El mismo token Bearer abre la API REST y el servidor MCP. Créalo en 30 segundos desde tu cuenta, con los scopes que elijas.

1. Abre app.purrplan.ai/app/mcp-integration
2. Crea un token: nombre, caducidad (30/90/365 días o nunca) y los scopes que necesites.
3. Copia el token (se muestra solo una vez) y pásalo en la cabecera.

# Cabecera de autenticación (REST y MCP)

Authorization: Bearer $TOKEN

# URLs base

REST app.purrplan.ai/app/api

MCP app.purrplan.ai/api/mcp

Comprueba el servidor antes de registrarte

El handshake MCP es abierto: initialize, ping y tools/list responden sin token y devuelven las 18 herramientas con sus esquemas de entrada. Así puedes comprobar exactamente lo que hace PurrPlan —desde el terminal o tu cliente MCP— incluso antes de crear una cuenta. Solo llamar a una herramienta (tools/call) requiere un token.

# no se requiere token

curl -s -X POST https://app.purrplan.ai/api/mcp \

-H 'Content-Type: application/json' \

-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Los clientes MCP compatibles con OAuth también pueden registrar un cliente dinámicamente (DCR + PKCE) en /app/oauth.

Biblioteca MIT gratuita, sin SDK de pago: github.com/sebastiendb/purrplan-mcp. Encapsula las 18 herramientas de abajo sobre /api/mcp. El token lo aportas tú.

02 · API REST

Crea y programa por HTTP.

Base https://app.purrplan.ai/app/api. El {workspace} es el uuid de tu espacio de trabajo.

Método	Endpoint	Propósito
GET	/me	Usuario actual
GET	/workspaces	Tus espacios de trabajo
GET	/{workspace}/accounts	Cuentas sociales conectadas
GET	/{workspace}/posts	Listar posts (paginado)
POST	/{workspace}/posts	Crear post (borrador, programado, en cola o inmediato)
POST	/{workspace}/posts/schedule/{post}	Programar un post existente
POST	/{workspace}/posts/add-to-queue/{post}	Añadir al siguiente hueco libre
GET	/{workspace}/media	Biblioteca de medios
POST	/{workspace}/media	Subir un medio
POST	/{workspace}/ai/text/generate	Generar texto con IA

Ejemplo — crear y programar un post

# POST /app/api/{workspace}/posts curl -X POST https://app.purrplan.ai/app/api/$WS/posts \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "accounts": [12, 18], "date": "2026-07-25", "time": "09:30", "timezone": "Europe/Paris", "schedule": true, "versions": [ { "account_id": 0, "is_original": true, "content": [{ "body": "¡Nuestro producto ya está aquí! 🎉" }] } ] }'

201 → el post (uuid, versions, scheduled_at)

account_id: 0 = versión "original" que aplica a todas las cuentas. Sustituye schedule por queue: true (siguiente hueco libre) o schedule_now: true (publicar de inmediato). Sin fecha ni flag → borrador.

03 · Servidor MCP

Conecta tu agente de IA.

Servidor MCP nativo (Model Context Protocol, especificación 2025-06-18, JSON-RPC 2.0 sobre HTTP + SSE). Conecta Claude Desktop, Cursor o cualquier cliente MCP y deja que tu IA programe por ti — con permisos que tú controlas.

Configuración del cliente (URL + Bearer)

{ "mcpServers": { "purrplan": { "url": "https://app.purrplan.ai/api/mcp", "headers": { "Authorization": "Bearer $TOKEN" } } } }

¿Solo tienes un cliente stdio? Usa un puente como mcp-remote.

18 herramientas · scope requerido

list_workspaces read

Lista tus espacios de trabajo.

—

list_accounts read

Cuentas sociales conectadas (id, provider…).

workspace_uuid

list_posts read

Lista de posts (contenido, estado, fecha).

workspace_uuid, status?, limit?

get_post read

Detalle de un post (versiones por red).

workspace_uuid, post_uuid

generate_ai_text ai

Genera un texto de post (consume créditos).

workspace_uuid, prompt, tone?…

create_draft_post write

Crea un post — borrador, o programado si se indica scheduled_at.

workspace_uuid, account_ids, content, scheduled_at?

create_stories write

Crea Stories (Instagram, Facebook).

workspace_uuid, account_ids, media_ids

update_draft_post write

Edita un borrador existente.

workspace_uuid, post_uuid, content?, scheduled_at?

delete_post write

Elimina un post no publicado.

workspace_uuid, post_uuid

upload_media_from_url media

Importa un medio desde una URL pública.

workspace_uuid, url, type?

list_inbox inbox:read

Conversaciones y comentarios recibidos.

workspace_uuid, status?, type?, limit?

get_inbox_thread inbox:read

Historial completo de una conversación.

workspace_uuid, message_id

manage_inbox_messages inbox:read

Marcar como leído, archivar, asignar.

workspace_uuid, message_ids, action

refresh_inbox inbox:read

Obtiene nuevos mensajes de las redes.

workspace_uuid, account_id?

reply_to_inbox_message inbox:reply

ENVÍO REAL — responde en nombre de la cuenta. Requiere confirmación.

workspace_uuid, message_id, text, confirm

plan_my_week write + ai

Una semana de contenido, generado y colocado en tus huecos.

workspace_uuid, brief, count?, schedule?

get_analytics analytics:read

Seguidores, alcance, interacción, clics + desglose por red.

workspace_uuid, days?

get_top_posts analytics:read

Mejores publicaciones del período y tendencias.

workspace_uuid, days?, limit?

Scopes

Concede solo lo necesario.

read Lectura — espacios de trabajo, cuentas, posts

write Escritura — crear / programar posts

ai IA — generación de texto (consume créditos)

media Medios — subida, gestión de la biblioteca

inbox:read Bandeja de entrada — leer mensajes y comentarios

inbox:reply Bandeja de entrada — responder en tu nombre (envío real)

analytics:read Analítica — audiencia, alcance, interacción, clics

Límites

Límites estándar.

API REST y MCP 100 solicitudes / min / usuario

Generación con IA 20 / min / usuario

Subida de medios 30 / min / usuario

OAuth (token) 10 / min / IP

Al superarlo → 429.

Guías MCP

El servidor MCP de PurrPlan, explicado Tutorial: programar publicaciones con Claude Tutorial: programar con ChatGPT Tutorial: programar con Cursor Programar grupos de Facebook

¿Listo para empezar a construir?

Crea tu token y haz tu primera llamada en pocos minutos. Desde 9 €/mes, prueba de 7 días.

Oferta de por vida 597 € — pago único

Paga una vez y tu agente publica para siempre: API + MCP, créditos de IA y cuotas del plan Pro incluidos, sin suscripción. El único planificador social con una opción de por vida para flujos de trabajo gestionados por agentes.

Empezar gratis Crear token