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.
getSubscription
Read the current subscription (Stripe IDs stripped).
listInvoices
List invoices for the org.
listPaymentMethods
List masked payment methods.
getCreditBalance
Current credit balance for the org.
getCreditPackages
Available credit packages.
listCreditPurchases
Past credit purchases.
getPriceForTier
Get pricing info for a tier (Enterprise stripped for non-admins).
previewSubscriptionChange
Preview a tier or seat change. Returns confirmation token + AUD totals.
applySubscriptionChange
Apply a previewed change. Same-tier seat = in-place; cross-tier = Checkout.
previewSubscriptionCancellation
Preview cancellation impact (remaining credits, prepaid days, feature loss).
cancelSubscription
Soft-cancel (cancel_at_period_end). Never immediate.
reactivateSubscription
Reactivate a soft-cancelled subscription.
updateBillingEmail
Update the billing contact email.
quoteCreditPackage
Quote a credit-package purchase. Returns quote token.
purchaseCreditPackage
Apply the quote and get a Checkout URL.
getCustomerPortalLink
Returns a Stripe Customer Portal link for self-serve billing.