Entwickler · API · MCP

Dein KI-Agent steuert deine 12 Netzwerke. Nativ.

Ein Token, 12 Netzwerke, 12 Auth-Systeme, die du nie pflegen musst. REST-API + nativer MCP-Server: Sag Claude oder Cursor „bereite meine Woche vor“ — erledigt. Buffer und Hootsuite haben das nicht.

Mit Claude / Cursor verbinden REST-API ansehen

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

01 · Authentifizierung

Ein Token, zwei Oberflächen.

Derselbe Bearer-Token öffnet die REST-API und den MCP-Server. Erstelle ihn in 30 Sekunden in deinem Konto, mit den Scopes, die du wählst.

1. Öffne app.purrplan.ai/app/mcp-integration
2. Erstelle einen Token: Name, Ablauf (30/90/365 Tage oder nie) und die gewünschten Scopes.
3. Kopiere den Token (wird nur einmal angezeigt) und übergib ihn im Header.

# Auth-Header (REST & MCP)

Authorization: Bearer $TOKEN

# Basis-URLs

REST app.purrplan.ai/app/api

MCP app.purrplan.ai/api/mcp

OAuth-kompatible MCP-Clients können auch einen Client dynamisch registrieren (DCR + PKCE) unter /app/oauth.

02 · REST-API

Erstelle und plane per HTTP.

Basis https://app.purrplan.ai/app/api. Das {workspace} ist die uuid deines Workspaces.

Methode	Endpoint	Zweck
GET	/me	Aktueller Nutzer
GET	/workspaces	Deine Workspaces
GET	/{workspace}/accounts	Verbundene Social-Konten
GET	/{workspace}/posts	Posts auflisten (paginiert)
POST	/{workspace}/posts	Post erstellen (Entwurf, geplant, Warteschlange oder sofort)
POST	/{workspace}/posts/schedule/{post}	Bestehenden Post planen
POST	/{workspace}/posts/add-to-queue/{post}	Zum nächsten freien Slot hinzufügen
GET	/{workspace}/media	Medienbibliothek
POST	/{workspace}/media	Medium hochladen
POST	/{workspace}/ai/text/generate	Text per KI generieren

Beispiel — Post erstellen & planen

# 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": "Unser Produkt ist da 🎉" }] } ] }'

201 → der Post (uuid, versions, scheduled_at)

account_id: 0 = „originale“ Version, die für alle gilt. Ersetze schedule durch queue: true (nächster freier Slot) oder schedule_now: true (sofort veröffentlichen). Ohne Datum oder Flag → Entwurf.

03 · MCP-Server

Verbinde deinen KI-Agenten.

Nativer MCP-Server (Model Context Protocol, Spec 2025-06-18, JSON-RPC 2.0 über HTTP + SSE). Verbinde Claude Desktop, Cursor oder jeden MCP-Client und lass deine KI für dich planen — mit Berechtigungen, die du kontrollierst.

Client-Config (URL + Bearer)

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

Nur ein stdio-Client? Nutze eine Bridge wie mcp-remote.

18 Tools · erforderlicher Scope

list_workspaces read

Listet deine Workspaces auf.

—

list_accounts read

Verbundene Social-Konten (id, provider…).

workspace_uuid

list_posts read

Liste der Posts (Inhalt, Status, Datum).

workspace_uuid, status?, limit?

get_post read

Detail eines Posts (Versionen pro Netzwerk).

workspace_uuid, post_uuid

generate_ai_text ai

Generiert einen Post-Text (verbraucht Credits).

workspace_uuid, prompt, tone?…

create_draft_post write

Erstellt einen Post — Entwurf, oder geplant bei scheduled_at.

workspace_uuid, account_ids, content, scheduled_at?

create_stories write

Erstellt Stories (Instagram, Facebook).

workspace_uuid, account_ids, media_ids

update_draft_post write

Bearbeitet einen vorhandenen Entwurf.

workspace_uuid, post_uuid, content?, scheduled_at?

delete_post write

Löscht einen unveröffentlichten Post.

workspace_uuid, post_uuid

upload_media_from_url media

Importiert ein Medium von einer öffentlichen URL.

workspace_uuid, url, type?

list_inbox inbox:read

Empfangene Konversationen und Kommentare.

workspace_uuid, status?, type?, limit?

get_inbox_thread inbox:read

Vollständiger Verlauf einer Konversation.

workspace_uuid, message_id

manage_inbox_messages inbox:read

Als gelesen markieren, archivieren, zuweisen.

workspace_uuid, message_ids, action

refresh_inbox inbox:read

Holt neue Nachrichten von den Netzwerken.

workspace_uuid, account_id?

reply_to_inbox_message inbox:reply

ECHTER VERSAND — antwortet im Namen des Kontos. Bestätigung erforderlich.

workspace_uuid, message_id, text, confirm

plan_my_week write + ai

Eine Woche Content, generiert und auf deine Slots gelegt.

workspace_uuid, brief, count?, schedule?

get_analytics analytics:read

Follower, Reichweite, Engagement, Klicks + Aufschlüsselung pro Netzwerk.

workspace_uuid, days?

get_top_posts analytics:read

Beste Beiträge des Zeitraums und Trends.

workspace_uuid, days?, limit?

Scopes

Gib genau das Nötige frei.

read Lesen — Workspaces, Konten, Posts

write Schreiben — Posts erstellen / planen

ai KI — Textgenerierung (verbraucht Credits)

media Medien — Upload, Verwaltung der Bibliothek

inbox:read Posteingang — Nachrichten und Kommentare lesen

inbox:reply Posteingang — in deinem Namen antworten (echter Versand)

analytics:read Analyse — Audience, Reichweite, Engagement, Klicks

Limits

Standard-Limits.

REST- & MCP-API 100 Anfragen / Min. / Nutzer

KI-Generierung 20 / Min. / Nutzer

Medien-Upload 30 / Min. / Nutzer

OAuth (Token) 10 / Min. / IP

Überschreitung → 429.

Bereit zu bauen?

Erstelle deinen Token und mach deinen ersten Aufruf in wenigen Minuten. Ab 9 €/Monat, 7 Tage Testphase.

Lifetime-Angebot 597 € — einmal zahlen

Einmal zahlen, dein Agent postet für immer: API + MCP, KI-Guthaben und Pro-Plan-Kontingente inklusive, kein Abo. Der einzige Social-Planer mit einer Lifetime-Option für agentengesteuerte Workflows.

Kostenlos starten Token erstellen