Desenvolvedores · API · MCP

O teu agente de IA controla as tuas 12 redes. Nativamente.

Um token, 12 redes, 12 sistemas de autenticação que nunca terás de manter. API REST + servidor MCP nativo: diz ao Claude ou ao Cursor "prepara a minha semana" — feito. O Buffer e o Hootsuite não têm isto.

Ligar ao Claude / Cursor Ver a API REST

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

01 · Autenticação

Um token, duas interfaces.

O mesmo token Bearer abre a API REST e o servidor MCP. Cria-o em 30 segundos na tua conta, com os scopes que escolheres.

1. Abre app.purrplan.ai/app/mcp-integration
2. Cria um token: nome, validade (30/90/365 dias ou nunca) e os scopes que desejares.
3. Copia o token (é mostrado apenas uma vez) e passa-o no cabeçalho.

# Cabeçalho de autenticação (REST & MCP)

Authorization: Bearer $TOKEN

# URLs base

REST app.purrplan.ai/app/api

MCP app.purrplan.ai/api/mcp

Testar o servidor antes de iniciar sessão

O handshake MCP é aberto: initialize, ping e tools/list respondem sem token e devolvem todas as 18 ferramentas com os respetivos esquemas de entrada. Podes assim verificar exatamente o que a PurrPlan faz — no terminal ou no teu cliente MCP — antes mesmo de criar uma conta. Só a chamada de uma ferramenta (tools/call) exige um token.

# nenhum token necessário

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

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

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

Os clientes MCP compatíveis com OAuth também podem registar um cliente dinamicamente (DCR + PKCE) em /app/oauth.

Biblioteca MIT gratuita, sem SDK pago: github.com/sebastiendb/purrplan-mcp. Encapsula as 18 ferramentas abaixo contra /api/mcp. O token é fornecido por ti.

02 · API REST

Cria e agenda por HTTP.

Base https://app.purrplan.ai/app/api. O {workspace} é o uuid do teu workspace.

Método	Endpoint	Função
GET	/me	Utilizador atual
GET	/workspaces	Os teus workspaces
GET	/{workspace}/accounts	Contas sociais ligadas
GET	/{workspace}/posts	Listar publicações (paginado)
POST	/{workspace}/posts	Criar publicação (rascunho, agendada, na fila ou imediata)
POST	/{workspace}/posts/schedule/{post}	Agendar publicação existente
POST	/{workspace}/posts/add-to-queue/{post}	Adicionar à próxima vaga livre
GET	/{workspace}/media	Biblioteca de media
POST	/{workspace}/media	Carregar media
POST	/{workspace}/ai/text/generate	Gerar texto com IA

Exemplo — Criar e agendar uma publicação

# 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": "O nosso produto chegou 🎉" }] } ] }'

201 → a publicação (uuid, versions, scheduled_at)

account_id: 0 = versão "original" que se aplica a todos. Substitui schedule por queue: true (próxima vaga livre) ou schedule_now: true (publicar imediatamente). Sem data ou flag → rascunho.

03 · Servidor MCP

Liga o teu agente de IA.

Servidor MCP nativo (Model Context Protocol, spec 2025-06-18, JSON-RPC 2.0 via HTTP + SSE). Liga o Claude Desktop, o Cursor ou qualquer cliente MCP e deixa a tua IA agendar por ti — com permissões que controlas.

Configuração do cliente (URL + Bearer)

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

Só tens um cliente stdio? Usa uma ponte como mcp-remote.

18 ferramentas · scope necessário

list_workspaces read

Lista os teus workspaces.

—

list_accounts read

Contas sociais ligadas (id, provider…).

workspace_uuid

list_posts read

Lista de publicações (conteúdo, estado, data).

workspace_uuid, status?, limit?

get_post read

Detalhe de uma publicação (versões por rede).

workspace_uuid, post_uuid

generate_ai_text ai

Gera um texto de publicação (consome créditos).

workspace_uuid, prompt, tone?…

create_draft_post write

Cria uma publicação — rascunho, ou agendada se scheduled_at.

workspace_uuid, account_ids, content, scheduled_at?

create_stories write

Cria stories (Instagram, Facebook).

workspace_uuid, account_ids, media_ids

update_draft_post write

Edita um rascunho existente.

workspace_uuid, post_uuid, content?, scheduled_at?

delete_post write

Elimina uma publicação não publicada.

workspace_uuid, post_uuid

upload_media_from_url media

Importa um media a partir de um URL público.

workspace_uuid, url, type?

list_inbox inbox:read

Conversas e comentários recebidos.

workspace_uuid, status?, type?, limit?

get_inbox_thread inbox:read

Histórico completo de uma conversa.

workspace_uuid, message_id

manage_inbox_messages inbox:read

Marcar como lida, arquivar, atribuir.

workspace_uuid, message_ids, action

refresh_inbox inbox:read

Obtém novas mensagens das redes.

workspace_uuid, account_id?

reply_to_inbox_message inbox:reply

ENVIO REAL — responde em nome da conta. Confirmação obrigatória.

workspace_uuid, message_id, text, confirm

plan_my_week write + ai

Uma semana de conteúdo, gerado e colocado nas tuas vagas.

workspace_uuid, brief, count?, schedule?

get_analytics analytics:read

Seguidores, alcance, engagement, cliques + detalhe por rede.

workspace_uuid, days?

get_top_posts analytics:read

Melhores publicações do período e tendências.

workspace_uuid, days?, limit?

Scopes

Dá acesso apenas ao necessário.

read Leitura — Workspaces, contas, publicações

write Escrita — Criar / agendar publicações

ai IA — Geração de texto (consome créditos)

media Media — Upload, gestão da biblioteca

inbox:read Caixa de entrada — Ler mensagens e comentários

inbox:reply Caixa de entrada — Responder em teu nome (envio real)

analytics:read Análises — Audiência, alcance, engagement, cliques

Limites

Limites por defeito.

API REST & MCP 100 pedidos / min. / utilizador

Geração por IA 20 / min. / utilizador

Upload de media 30 / min. / utilizador

OAuth (token) 10 / min. / IP

Se excedido → 429.

Guias MCP

O servidor MCP da PurrPlan, explicado Tutorial: agendar publicações com o Claude Tutorial: agendar com o ChatGPT Tutorial: agendar com o Cursor Agendar em grupos do Facebook

Pronto para começar a construir?

Cria o teu token e faz a tua primeira chamada em poucos minutos. A partir de 9 €/mês, 7 dias de teste.

Oferta Lifetime 597 € — pagamento único

Paga uma vez, o teu agente publica para sempre: API + MCP, créditos de IA e quotas do plano Pro incluídos, sem subscrição. O único agendador social com uma opção lifetime para workflows controlados por agentes.

Começar gratuitamente Criar token