Billing
Every Billing tool, with the scope it needs, its arguments and the API operation it calls.
6 tools
List billing invoices
Read onlyatlas_billing_invoices_list
List recent invoices for the tenant (newest first). Defaults to 10; pass `limit` to widen up to 100. Member-readable.
- Scope
billing:read- Calls
- Example prompt
- Show me the last 20 invoices.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | No | Max invoices to return (1-100). Defaults to 10 server-side. |
Preview billing plan upgrades
Changes dataatlas_billing_plan_upgrades_preview
Compute the prorated charge + next-invoice total for switching to a higher plan, without committing. Use this to surface the exact $ amount before confirming an upgrade.
- Scope
billing:read- Calls
- Example prompt
- How much would it cost to move us to the Team plan today?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
toPlan | "free" | "starter" | "team" | "enterprise" | Yes | Target plan id. Must be a strict upgrade from the current plan; downgrades go through the Stripe customer portal. |
Upgrade billing plans
Destructiveatlas_billing_plans_upgrade
Change the workspace to a higher plan. The change is billed at once, prorated for the rest of the period, and cannot be undone from here. Only an owner or administrator may do it; preview the cost first with atlas_billing_plan_upgrades_preview.
- Scope
billing:write- Calls
- POST /v1/billing/subscription/change-plan
- Example prompt
- Upgrade us to the Team plan.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
toPlan | "free" | "starter" | "team" | "enterprise" | Yes | Target plan id. Must be a strict upgrade from the current plan; downgrades go through the Stripe customer portal. |
Create billing portal links
Changes dataatlas_billing_portal_links_create
Mint a single-use Stripe customer portal URL for the tenant. Owner/admin only. Downgrades + payment-method changes flow through this portal.
- Scope
billing:write- Calls
- Example prompt
- Open the Stripe customer portal for me.
Arguments
This tool takes no arguments.
Get billing subscription
Read onlyatlas_billing_subscription_get
Read the current subscription envelope: plan, status, seat count, renewal date, scheduled changes. Member-readable so any logged-in caller can render plan chrome.
- Scope
billing:read- Calls
- Example prompt
- What plan are we on and when does it renew?
Arguments
This tool takes no arguments.
List billing tax rates
Read onlyatlas_billing_tax_rates_list
Read the billing tax-rate library (rate id, jurisdiction, rate percent, inclusive flag). Member-readable; powers the invoice line preview.
- Scope
billing:read- Calls
- Example prompt
- What tax rates are configured for our invoices?
Arguments
This tool takes no arguments.