MCP tools/Billing
Billing & subscription
Every money-spending operation goes through a two-call contract: `previewX(payload)` returns a `confirmation_token` and a human-readable summary; `applyX({confirmation_token})` executes. Tokens are single-use, atomic-consume, 10-minute TTL. Stripe calls use the token as `idempotency_key` so retries are safe. Soft-cancel only, never immediate. Enterprise pricing is not visible to non-admin callers (Phase 1b lockdown).
Live discovery
searchTools with category: "billing" to fetch this list at runtime, complete with full input schemas. The page below is the human-readable mirror.16 tools
Every tool below honours the credential’s permission scope and the user’s org role. Agents see only what they’re authorised to call.
applySubscriptionChange
Apply a previewed change. Same-tier seat = in-place; cross-tier = Checkout.
cancelSubscription
Soft-cancel (cancel_at_period_end). Never immediate.
getCreditBalance
Current credit balance for the org.
getCreditPackages
Available credit packages.
getCustomerPortalLink
Returns a Stripe Customer Portal link for self-serve billing.
getPriceForTier
Get pricing info for a tier (Enterprise stripped for non-admins).
getSubscription
Read the current subscription (Stripe IDs stripped).
listCreditPurchases
Past credit purchases.
listInvoices
List invoices for the org.
listPaymentMethods
List masked payment methods.
previewSubscriptionCancellation
Preview cancellation impact (remaining credits, prepaid days, feature loss).
previewSubscriptionChange
Preview a tier or seat change. Returns confirmation token + AUD totals.
purchaseCreditPackage
Apply the quote and get a Checkout URL.
quoteCreditPackage
Quote a credit-package purchase. Returns quote token.
reactivateSubscription
Reactivate a soft-cancelled subscription.
updateBillingEmail
Update the billing contact email.