Sviluppatori · API · MCP

Il tuo agente IA gestisce i tuoi 12 network. Nativamente.

Un token, 12 network, 12 sistemi di autenticazione che non dovrai mai gestire. API REST + server MCP nativo: chiedi a Claude o Cursor "prepara la mia settimana" — fatto. Buffer e Hootsuite non lo fanno.

Connetti con Claude / Cursor Vedi l'API REST

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

01 · Autenticazione

Un token, due interfacce.

Lo stesso Bearer token apre l'API REST e il server MCP. Crealo in 30 secondi nel tuo account, con gli scope che scegli tu.

1. Apri app.purrplan.ai/app/mcp-integration
2. Crea un token: nome, scadenza (30/90/365 giorni o mai) e gli scope desiderati.
3. Copia il token (viene mostrato solo una volta) e passalo nell'header.

# Header di autenticazione (REST & MCP)

Authorization: Bearer $TOKEN

# URL di base

REST app.purrplan.ai/app/api

MCP app.purrplan.ai/api/mcp

Verifica il server prima di iscriverti

L'handshake MCP è aperto: initialize, ping e tools/list rispondono senza token e restituiscono tutti i 18 tool con i relativi schemi di input. Puoi quindi verificare esattamente cosa può fare PurrPlan — dal terminale o dal tuo client MCP — ancora prima di creare un account. Solo la chiamata a un tool (tools/call) richiede un token.

# nessun token richiesto

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

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

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

I client MCP compatibili con OAuth possono anche registrare dinamicamente un client (DCR + PKCE) su /app/oauth.

Libreria gratuita sotto licenza MIT, nessun SDK a pagamento: github.com/sebastiendb/purrplan-mcp. Racchiude i 18 tool qui sotto verso /api/mcp. Il token lo fornisci tu.

02 · API REST

Crea e pianifica via HTTP.

Base https://app.purrplan.ai/app/api. Il {workspace} è l'uuid del tuo workspace.

Metodo	Endpoint	Scopo
GET	/me	Utente attuale
GET	/workspaces	I tuoi workspace
GET	/{workspace}/accounts	Account social collegati
GET	/{workspace}/posts	Elenco dei post (paginato)
POST	/{workspace}/posts	Crea un post (bozza, pianificato, in coda o immediato)
POST	/{workspace}/posts/schedule/{post}	Pianifica un post esistente
POST	/{workspace}/posts/add-to-queue/{post}	Aggiungi al prossimo slot libero
GET	/{workspace}/media	Libreria media
POST	/{workspace}/media	Carica un media
POST	/{workspace}/ai/text/generate	Genera testo tramite IA

Esempio — Creare e pianificare 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": "Il nostro prodotto è arrivato 🎉" }] } ] }'

201 → il post (uuid, versions, scheduled_at)

account_id: 0 = versione "originale" valida per tutti. Sostituisci schedule con queue: true (prossimo slot libero) o schedule_now: true (pubblicazione immediata). Senza data né flag → bozza.

03 · Server MCP

Connetti il tuo agente IA.

Server MCP nativo (Model Context Protocol, specifica 2025-06-18, JSON-RPC 2.0 su HTTP + SSE). Connetti Claude Desktop, Cursor o qualsiasi client MCP e lascia che la tua IA pianifichi per te — con i permessi che controlli tu.

Configurazione client (URL + Bearer)

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

Solo un client stdio? Usa un bridge come mcp-remote.

18 tool · scope richiesto

list_workspaces read

Elenca i tuoi workspace.

—

list_accounts read

Account social collegati (id, provider…).

workspace_uuid

list_posts read

Elenco dei post (contenuto, stato, data).

workspace_uuid, status?, limit?

get_post read

Dettaglio di un post (versioni per rete).

workspace_uuid, post_uuid

generate_ai_text ai

Genera un testo per un post (consuma crediti).

workspace_uuid, prompt, tone?…

create_draft_post write

Crea un post — bozza, oppure pianificato se 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

Modifica una bozza esistente.

workspace_uuid, post_uuid, content?, scheduled_at?

delete_post write

Elimina un post non pubblicato.

workspace_uuid, post_uuid

upload_media_from_url media

Importa un media da un URL pubblico.

workspace_uuid, url, type?

list_inbox inbox:read

Conversazioni e commenti ricevuti.

workspace_uuid, status?, type?, limit?

get_inbox_thread inbox:read

Cronologia completa di una conversazione.

workspace_uuid, message_id

manage_inbox_messages inbox:read

Segna come letto, archivia, assegna.

workspace_uuid, message_ids, action

refresh_inbox inbox:read

Recupera i nuovi messaggi dai social network.

workspace_uuid, account_id?

reply_to_inbox_message inbox:reply

INVIO REALE — risponde per conto dell'account. Richiede conferma.

workspace_uuid, message_id, text, confirm

plan_my_week write + ai

Una settimana di contenuti, generata e inserita nei tuoi slot.

workspace_uuid, brief, count?, schedule?

get_analytics analytics:read

Follower, copertura, engagement, click + dettaglio per rete.

workspace_uuid, days?

get_top_posts analytics:read

Migliori post del periodo e tendenze.

workspace_uuid, days?, limit?

Scope

Concedi esattamente ciò che serve.

read Lettura — Workspace, account, post

write Scrittura — Creare / pianificare post

ai IA — Generazione di testo (consuma crediti)

media Media — Upload, gestione della libreria

inbox:read Posta in arrivo — Leggere messaggi e commenti

inbox:reply Posta in arrivo — Rispondere per tuo conto (invio reale)

analytics:read Analisi — Audience, copertura, engagement, click

Limiti

Limiti predefiniti.

API REST e MCP 100 richieste / min / utente

Generazione IA 20 / min / utente

Upload media 30 / min / utente

OAuth (token) 10 / min / IP

Superamento → 429.

Guide MCP

Il server MCP di PurrPlan, spiegato Tutorial: pianificare i post con Claude Tutorial: pianificare con ChatGPT Tutorial: pianificare con Cursor Pianificare i gruppi Facebook

Pronto a sviluppare?

Crea il tuo token e fai la tua prima chiamata in pochi minuti. A partire da 9 €/mese, 7 giorni di prova.

Offerta Lifetime 597 € — pagamento unico

Paghi una volta, il tuo agente pubblica per sempre: API + MCP, crediti IA e quote del piano Pro incluse, nessun abbonamento. L'unico pianificatore social con un'opzione lifetime per i workflow guidati da agenti.

Inizia gratis Crea un token