Der Arcalotl-MCP-Server
Arcalotl stellt seine Daten zu Abos, Mitgliedern, Zugängen und Auswertungen über das Model Context Protocol für KI-Agenten bereit, mit denselben API-Keys und denselben Scopes wie die REST-API.
Arcalotl betreibt einen Server für das Model Context Protocol unter https://api.arcalotl.com/mcp. Ein MCP-Client wie Claude Code, Claude Desktop oder Cursor verbindet sich direkt damit. Ein Assistent kann also eine Frage wie "welche Abonnenten sind überfällig" beantworten oder einen Zahlungslink für einen Plan erstellen, ohne dass vorher jemand eine eigene Integration schreibt.
Es gibt elf Lese-Tools und ein Schreib-Tool. Das Schreib-Tool erstellt einen Zahlungslink. Destruktive Schreibzugriffe sind Agenten bewusst nicht zugänglich.
Jeder Tool-Aufruf ist auf die Community begrenzt, der auch der API-Key gehört, und erzwingt denselben Scope wie sein Gegenstück in der REST-API. Ein Key ohne den nötigen Scope bekommt einen benannten Scope-Fehler statt Daten.
Ein Endpunkt, ein Bearer-Key
Der Server liegt unter https://api.arcalotl.com/mcp und spricht den Streamable-HTTP-Transport. Authentifiziert wird mit demselben Bearer-API-Key wie in der REST-API, gesendet als Authorization-Header. Keys legen Sie im Dashboard unter Developers und dann API Keys an und widerrufen sie dort.
Dreizehn Lese-Tools decken die Daten der Community ab
Ein Agent kann list_subscriptions, get_subscription, get_switch_options, list_plans, list_members, get_member_entitlements, check_entitlement, list_purchases, get_analytics_summary, list_discounts, list_events, list_webhook_endpoints und list_webhook_deliveries aufrufen. Die Ergebnisse sind dieselben öffentlichen JSON-Objekte, die auch die REST-Endpunkte liefern.
Zwei Schreib-Tools: ein Zahlungslink und ein Planwechsel
create_checkout_link nimmt eine tier_id und entweder eine Plattform samt platform_uid oder Ihren eigenen Namespace samt external_user_id entgegen, dazu eine plan_id, wenn ein Plan mehr als einen aktiven Abrechnungsplan hat. Zurück kommt die URL einer echten Kassenseite für diesen Käufer. switch_subscription wechselt ein Abo auf einen Plan aus get_switch_options. Beide verlangen einen Schreib-Scope und keines der beiden ist destruktiv.
Es gibt kein destruktives Tool
Der Server bietet kein Tool cancel_subscription an. Destruktive Schreibzugriffe durch einen Agenten sind bewusst nicht vorgesehen. Kündigen funktioniert weiterhin über REST mit POST /v1/subscriptions/{id}/cancel, wo ein Mensch oder ein Dienst den Key hält.
Ergebnisse gehören zu einer Community
Jedes Ergebnis ist auf die Community begrenzt, der auch der API-Key gehört. Ein Agent kann also weder die Abonnenten noch die Umsätze einer anderen Community lesen. Eine ID aus einer anderen Community wird als nicht gefunden gemeldet, nicht als verboten.
Ein fehlender Scope gibt einen benannten Fehler zurück
Fehlt einem Key der Scope, den ein Tool braucht, liefert der Tool-Aufruf einen Scope-Fehler, der den Scope nennt, etwa missing_scope: members:read. Das ist dasselbe Ergebnis wie eine 403 missing_scope über REST, ein Agent kann also genau sagen, welche Berechtigung fehlt.
Lese-Tools sind als read-only gekennzeichnet
Jedes Lese-Tool trägt die Annotation readOnlyHint. MCP-Clients, die Annotationen beachten, können es also aufrufen, ohne beim Nutzer nachzufragen. create_checkout_link und switch_subscription sind als nicht destruktiv gekennzeichnet.
Ein Befehl, um den Server hinzuzufügen
In Claude Code führen Sie claude mcp add --transport http arcalotl https://api.arcalotl.com/mcp aus, mit einem Authorization-Header, der Ihren Key trägt. Clients mit einem Konfigurationsobjekt mcpServers nehmen denselben Server als url plus headers-Map entgegen.
MCP kostet nichts extra
Der MCP-Server gehört zum Produkt. Arcalotl berechnet $0/Monat plus 2 % jeder erfolgreichen Zahlung, auf dem eigenen Stripe-Konto des Creators über Stripe Connect Direct Charges. Einen eigenen API- oder Agenten-Tarif gibt es nicht.
Tools, die der MCP-Server anbietet
| Tool | Eingabe | Scope |
|---|---|---|
| list_subscriptions | status, plan_id, member_id, cursor, limit (alle optional) | subscriptions:read |
| get_subscription | subscription_id | subscriptions:read |
| get_switch_options | subscription_id | subscriptions:read |
| list_plans | Keine | plans:read |
| list_members | cursor, limit (optional) | members:read |
| get_member_entitlements | member_id | members:read |
| check_entitlement | platform und platform_uid, oder namespace und external_user_id; tier_id (optional) | members:read |
| list_purchases | cursor, limit (optional) | purchases:read |
| get_analytics_summary | Keine | analytics:read |
| list_events | types, after_id, limit (alle optional) | events:read |
| list_webhook_endpoints | Keine | webhooks:read |
| list_webhook_deliveries | endpoint_id, cursor (optional) | webhooks:read |
| create_checkout_link | tier_id, plan_id (optional), platform und platform_uid, oder namespace, external_user_id und return_url | checkout:write |
| switch_subscription | subscription_id, plan_id | subscriptions:write |
Ein Dienst hinter zwei Protokollen
Die MCP-Tools rufen denselben internen Anwendungsdienst auf wie die REST-Handler, und zwar im selben Prozess statt über die öffentliche REST-API per HTTP. Jede Ressource, jeder Filter und jede Scope-Prüfung verhält sich identisch, ob Sie Arcalotl mit curl erreichen oder über einen Agenten.
Das heißt auch: Eine Korrektur oder ein neues Feld landet in beiden Oberflächen gleichzeitig. Die Tool-Liste von MCP folgt der REST-API, statt ihr hinterherzuhinken.
Weil die Daten dieselben sind, kann ein Agenten-Workflow beides mischen. Ein Assistent liest Pläne und Mitglieder über MCP und reicht einem Menschen einen Zahlungslink, während ein Backend-Dienst die REST-API und Webhooks für die Teile nutzt, die dauerhaft sein müssen.
Fragen
Weiterlesen
Richten Sie Ihren Agenten auf Ihre eigenen Community-Daten
Legen Sie im Dashboard einen API-Key an, geben Sie ihm die Scopes, die der Agent haben soll, und verbinden Sie ihn mit https://api.arcalotl.com/mcp.
Konto anlegen