get_plan

Connect to https://mcp.agentcard.sh/mcp with the user’s connection token (or a buy_token for org-owned accounts). Behavior: read-only, idempotent.

What it does

Show the user’s current subscription plan, card limits, and this month’s usage. Call this before create_card when you need the per-card amount cap or remaining monthly quota, or whenever the user asks about their plan, limits, billing, or upgrading. To cancel a paid plan, the gated tool cancel_plan also exists; call it by name even though it isn’t in the tools list.

Inputs

None.

Returns

Field	Type	Description
`message` (required)	string	Human-readable plan + usage summary.
`plan`	string	Raw plan id, e.g. ‘free’, ‘basic’, or ‘pro’.
`planName`	string	Display label of the plan, e.g. “Basic ($15/mo)”.
`cardsThisMonth`	number	Number of cards created this month.
`maxCardsPerMonth`	number/null	Max cards allowed per month; null means unlimited (connections through a company OAuth client or organization have no card limits).
`cardsRemaining`	number/null	Cards remaining this month; null means unlimited.
`maxCardAmountCents`	number/null	Maximum funding per card, in cents; null means no per-card cap.
`maxCardAmountDollars`	string/null	Maximum funding per card, formatted as USD dollars, e.g. “500.00”; null means no per-card cap.
`ordersPlaced`	number	Orders placed (counts toward the free-order quota on Free).
`maxLifetimeOrders`	number/null	Lifetime free-order quota; null means unlimited (paid plans).
`subscriptionStatus`	string/null	Stripe subscription status (e.g. ‘active’, ‘past_due’), or null on Free / when unavailable.
`cancelAtPeriodEnd`	boolean	Whether the subscription cancels at the end of the current billing period.
`currentPeriodEnd`	string/null	ISO date the current billing period ends, or null.

Example call

{
  "tool": "get_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