Le serveur MCP Arcalotl
Arcalotl expose ses données d'abonnements, de membres, de droits d'accès et de statistiques aux agents IA via le Model Context Protocol, avec les mêmes clés d'API et les mêmes portées que l'API REST.
Arcalotl fait tourner un serveur Model Context Protocol sur https://api.arcalotl.com/mcp. Un client MCP comme Claude Code, Claude Desktop ou Cursor s'y connecte directement, pour qu'un assistant réponde à une question du type "quels abonnés sont en retard de paiement" ou crée un lien de paiement pour un palier, sans qu'il ait fallu écrire une intégration sur mesure.
Il y a onze outils de lecture et un outil d'écriture. L'outil d'écriture crée un lien de paiement. Les écritures destructrices ne sont volontairement pas exposées aux agents.
Chaque appel d'outil est limité à la communauté propriétaire de la clé d'API, et applique la même portée que son équivalent REST. Une clé à qui il manque la portée requise reçoit une erreur qui nomme la portée manquante, pas des données.
Un endpoint, une clé bearer
Le serveur vit sur https://api.arcalotl.com/mcp et parle le transport HTTP streamable. L'authentification se fait avec la même clé d'API bearer que l'API REST, envoyée dans un en-tête Authorization. Les clés se créent et se révoquent dans le tableau de bord, sous Développeurs puis Clés d'API.
Treize outils de lecture couvrent les données de la communauté
Un agent peut appeler 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 et list_webhook_deliveries. Les résultats sont les mêmes objets JSON publics que renvoient les endpoints REST.
Deux outils d'écriture : un lien de paiement et un changement de formule
create_checkout_link prend un tier_id et soit un platform et un platform_uid, soit votre namespace et un external_user_id, plus un plan_id quand le palier a plusieurs formules actives. Il renvoie l'URL d'une vraie page de paiement pour cet acheteur. switch_subscription fait passer un abonnement sur une formule issue de get_switch_options. Les deux exigent une portée d'écriture et aucun des deux n'est destructeur.
Il n'existe aucun outil destructeur
Le serveur n'expose aucun outil cancel_subscription. Les écritures destructrices pilotées par un agent sont hors périmètre, par choix. La résiliation reste possible en REST avec POST /v1/subscriptions/{id}/cancel, là où un humain ou un service détient la clé.
Les résultats sont limités à une communauté
Chaque résultat est limité à la communauté propriétaire de la clé d'API, donc un agent ne peut pas lire les abonnés ni les revenus d'une autre communauté. Un identifiant appartenant à une autre communauté est signalé comme introuvable plutôt que comme interdit.
Une portée manquante renvoie une erreur nommée
Quand il manque à une clé la portée exigée par un outil, l'appel renvoie une erreur de refus de portée qui la nomme, par exemple missing_scope: members:read. C'est le même résultat qu'un 403 missing_scope en REST, donc un agent peut indiquer exactement quelle permission ajouter.
Les outils de lecture sont annotés lecture seule
Chaque outil de lecture porte l'annotation readOnlyHint, pour que les clients MCP qui respectent les annotations puissent l'appeler sans demander confirmation. create_checkout_link et switch_subscription sont annotés comme non destructeurs.
Ajouter le serveur tient en une commande
Dans Claude Code, lancez claude mcp add --transport http arcalotl https://api.arcalotl.com/mcp avec un en-tête Authorization portant votre clé. Les clients qui utilisent un objet de configuration mcpServers acceptent le même serveur sous forme d'une url et d'une table headers.
MCP ne coûte rien de plus
Le serveur MCP fait partie du produit. Arcalotl facture $0/mois plus 2 % de chaque paiement réussi, sur le compte Stripe du créateur via les paiements directs Stripe Connect. Il n'y a pas de forfait API ni de forfait agent séparé.
Les outils exposés par le serveur MCP
| Outil | Entrée | Portée |
|---|---|---|
| list_subscriptions | status, plan_id, member_id, cursor, limit (tous facultatifs) | subscriptions:read |
| get_subscription | subscription_id | subscriptions:read |
| get_switch_options | subscription_id | subscriptions:read |
| list_plans | Aucune | plans:read |
| list_members | cursor, limit (facultatifs) | members:read |
| get_member_entitlements | member_id | members:read |
| check_entitlement | platform et platform_uid, ou namespace et external_user_id ; tier_id (facultatif) | members:read |
| list_purchases | cursor, limit (facultatifs) | purchases:read |
| get_analytics_summary | Aucune | analytics:read |
| list_events | types, after_id, limit (tous facultatifs) | events:read |
| list_webhook_endpoints | Aucune | webhooks:read |
| list_webhook_deliveries | endpoint_id, cursor (facultatif) | webhooks:read |
| create_checkout_link | tier_id, plan_id (facultatif), platform et platform_uid, ou namespace, external_user_id et return_url | checkout:write |
| switch_subscription | subscription_id, plan_id | subscriptions:write |
Un seul service derrière deux protocoles
Les outils MCP appellent le même service applicatif interne que les gestionnaires REST, dans le même processus, plutôt que d'appeler l'API REST publique en HTTP. Chaque ressource, chaque filtre et chaque vérification de portée se comportent à l'identique, que vous atteigniez Arcalotl avec curl ou via un agent.
Cela veut dire aussi qu'un correctif ou un nouveau champ arrive dans les deux surfaces en même temps. La liste des outils MCP suit l'API REST au lieu d'être à la traîne.
Comme les données sont les mêmes, un flux de travail agentique peut mélanger les deux. Un assistant peut lire les formules et les membres via MCP, puis remettre un lien de paiement à une personne, pendant qu'un service backend utilise l'API REST et les webhooks pour tout ce qui doit être durable.
Questions
À lire ensuite
Branchez votre agent sur vos propres données
Créez une clé d'API dans le tableau de bord, donnez-lui les portées que vous voulez confier à l'agent, et connectez-la à https://api.arcalotl.com/mcp.
Créer un compte