Quote X402 Capability Plan
x402_quote_planCalculate exact USD cost for 1 to 25 HTTP 402 capabilities and evaluate whether a Stripe spend key can auto-execute within balance, per-call caps, daily/total budgets, and route allowlists. Use this before x402_execute_capability to verify total cost and detect when x402_request_approval or x402_create_checkout is needed; do not use this to browse available tools (use x402_list_capabilities) or run a paid capability (use x402_execute_capability). Free and read-only (never charges credit); returns payment_assistant.human_approval_required=true and recommended Stripe pack amounts when funds or policy caps block execution. Subject to 120 req/min/IP rate limiting.
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": {
"items": "<items>"
},
"name": "x402_quote_plan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Ordered list of 1 to 25 capability line items to price and policy-check together. | |
| spend_key | No | Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when all items were quoted successfully. | |
| charged | No | Always false because quoting never debits funds. | |
| total_usd | No | Formatted total combined cost in USD (e.g. "0.40"). | |
| total_cents | No | Total combined cost in USD cents across all quoted items. | |
| payment_assistant | No |