> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# upgrade_plan

> Start a paid-plan upgrade.

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

## What it does

Start a paid-plan upgrade. Choose the target plan: 'basic' (\$15/mo — 15 cards/month, up to \$500 per card) or 'pro' (\$100/mo — 50 cards/month, up to \$1,000 per card). Defaults to 'basic' if omitted. Returns a Stripe Checkout URL the user must open in their browser to complete payment. After they finish checkout, the plan updates automatically; verify with get\_plan. Use only when the user explicitly wants to upgrade. To cancel a paid plan instead, the gated tool cancel\_plan also exists; call it by name even though it isn't in the tools list.

## Inputs

| Field  | Type                    | Description                                    |
| ------ | ----------------------- | ---------------------------------------------- |
| `plan` | string: `basic` · `pro` | Which plan to upgrade to. Defaults to 'basic'. |

## Returns

| Field                  | Type                                                                                                           | Description                                                                                                 |
| ---------------------- | -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `message` *(required)* | string                                                                                                         | Human-readable summary of the upgrade outcome.                                                              |
| `status`               | string: `swapped` · `checkout_required` · `already_on_plan` · `waitlisted` · `unavailable` · `checkout_failed` | Discriminator for the outcome branch.                                                                       |
| `plan`                 | string                                                                                                         | Display label of the target plan, e.g. 'Basic' or 'Pro'. Present when the requested plan is known.          |
| `checkoutUrl`          | string                                                                                                         | Stripe Checkout URL the user must open to complete payment. Present only when status is checkout\_required. |

## Example call

```json theme={null}
{
  "tool": "upgrade_plan",
  "arguments": {}
}
```