upgrade_plan

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

{
  "tool": "upgrade_plan",
  "arguments": {}
}

MCP

Organization tools

User tools

What it does

Inputs

Returns

Example call

​What it does

​Inputs

​Returns

​Example call

What it does

Inputs

Returns

Example call