Purchase credits
Top up credits. Creates a Paddle one-time transaction and returns a checkout_url for the human to pay; the credits land AFTER transaction.completed (ASYNC: poll get_credit_balance or await the webhook). CREDITABLE + DESTRUCTIVE: charges the owner’s card / opens Paddle checkout; the real gate is the human confirming the amount in the Paddle overlay. On retry the agent MUST reuse the SAME request_id; a fresh key creates a second charge.
Contract:
- MCP tool
purchase_credits, registry packagemcp.id/credit_transactions, mountid.credits. - Operation
action, response envelopeaction_async. - Flags: dangerous: the MCP layer gates it behind a preview/commit token, and the effect cannot be undone through this API; creditable: the response carries a
creditsblock and the call can debit the team ledger.
Authorizations
Access token issued by gtm.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.
Team scope for tokens that do not carry one. Ignored when the token already names a team.
Body
Request body of purchase_credits.
Response
action_async success envelope.