Upgrade plan
upgrade_planList available plans and manage plan changes. New subscribers receive a Stripe checkout URL; existing plan changes or downgrades require action in app billing. Members see an 'ask admin' message.
Instructions
Change this account's SUBSCRIPTION plan (admin only). Call with no argument to list the plans (id · monthly price · monthly credits); call again with plan set to a plan id. A NEW subscriber gets a ready-to-pay Stripe Checkout URL to hand your human — THEY pay on Stripe (agents never spend money directly). If the account already has a paid plan, or you're DOWNGRADING, the change is made by a person in the app (Settings → Billing) and the tool returns exactly what to do. Members (read-only billing) get an honest 'ask an admin' message. Nothing is charged until your human pays.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| plan | No | the plan id to move to (e.g. pro) — omit to list the available plans first | |
| period | No | billing cadence — monthly (default) or yearly (2 months free) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | the ready-to-pay Stripe Checkout URL (checkout mode) | |
| mode | No | 'checkout' (a Stripe URL was minted) or 'in_app' (a person makes the change in the app) | |
| plan | No | the target plan id | |
| plans | No | available paid plans ({id, name, priceUsd, credits}) when listing | |
| action | No | the in-app action required ('upgrade' or 'downgrade') | |
| period | No | billing cadence of the link — 'mo' or 'yr' | |
| guidance | No | exact instructions when the change must be made in the app | |
| chargeUsd | No | the actual charge amount (yearly billing charges the annual total) | |
| planLabel | No | the target plan display name | |
| monthlyUsd | No | the plan’s monthly price in USD |