Billing & Usage

Browse MCP domains.

Tools

ToolDescription
List budgetsList the budgets the caller may manage with their usage this month, for one project or narrowed to a member or API key.
List credit packagesList the credit packages an account can buy and their prices before starting a credit checkout; returns the whole catalogue as one page.
List credit transactionsList the credit grants, purchases, refunds and charges of an account, newest first unless sorted otherwise; returns one page of credit transactions.
List invoicesList the issued invoices of an account, or with kind upcoming the previews and drafts of what it will be charged next; returns one page of invoices with amounts in minor currency units.
List payment methodsList the cards saved for an account and which one is the default; returns one page of payment methods, which are changed in the billing portal.
List paymentsList the payments an account has made, with their receipt links; returns one page of payments with amounts in minor currency units.
Get available seatsGet available seats.
Get billing detailsRead the name, email, phone, address and tax IDs that appear on the invoices of an account; returns empty details and customer_available false before the account has a billing customer.
Get budgetGet a budget and its usage for the current month.
Get conversation analyticsSummarize the conversation activity and model use in the projects of an account, optionally for one project or label; returns totals, configurable time buckets and recent conversations, with private titles limited to participants.
Get credit balanceRead how many credits an account has left in its monthly and purchased pools, with its monthly allocation and top-up price; returns the balance.
Get credit usageBreak the credit spend of an account down by day, project and model, optionally for one project; returns the series with token counts per model.
Get subscriptionRead the plan, billing cycle, seats and add-ons of an account before changing or cancelling its subscription; returns the subscription with its seat usage.
Get usageRead what an account has used of each plan quota in the current billing period, with its tier, project count, credits spent and warnings; returns usage where a total of -1 means unlimited.
Get usage seriesChart one usage metric of an account by day, optionally for one project; returns the daily series with a total and a per-project breakdown.
Create billing portal sessionOpen a Stripe billing portal session where a person changes payment methods, tax details or the renewal of an account; returns the portal URL.
Create budgetCreate a monthly AI spending limit for a project, a member on a project, an API key, or a combination of these.
Create credit checkoutStart a Stripe checkout to buy a credit package for an account, or for the account that owns a project; returns the checkout URL.
Update billing detailsChange the name, email, phone or address on the invoices of an account, where an omitted field keeps its value and null clears it; returns the updated billing details.
Update budgetChange the monthly limit of a budget, keeping its scope and this month’s usage.
Update subscriptionChange the plan, billing cycle, seats or add-ons of an account; returns what changed, or a checkout URL when the change needs payment.
Delete budgetDelete budget.
Cancel subscriptionSchedule the paid subscription of an account to end with its current billing period; returns the canceled subscription.
Check feature gateCheck whether a plan allows a feature before offering it, for the caller or for the owner of a project; returns allowed with the required tier, limit and current count, and a denied gate is a result, not an error.
Redeem credit couponRedeem a coupon code for credits on an account; returns the credits granted and the new balance, or already_redeemed for a code the account used before.