Upgrade or change plan
spur_change_planMoves the user to another Spur plan (ids from spur_show_billing_options; usually team or brokerage).
No paid subscription yet: returns a Stripe checkout link. No confirmation needed.
Already subscribed: switches the plan immediately and charges or credits the prorated difference to the saved card. Call once without confirm to get the exact change, ask the user to approve it, then call again with confirm=true.
Moving to the Free plan returns a billing-portal link where the user cancels the paid subscription.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"plan_id": "<plan_id>"
},
"name": "spur_change_plan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | Only for users who already have a paid subscription: true ONLY after they approved the switch and the prorated charge in the conversation. | |
| plan_id | Yes | Target plan id, e.g. team or brokerage | |
| action_tier | No | Monthly Actions from the plan catalog; omit to preserve the current tier on the same plan | |
| billing_interval | No | Omit to preserve the current interval for this plan | |
| data_credit_tier | No | Monthly Data Credits from the plan catalog; omit to preserve the current tier on the same plan |