Stripe-powered HTTP 402 agent payment hub: spend keys, subagent caps, approvals & 25+ paid tools.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional Stripe-funded master or delegated subagent spend key (sbk_*) for autonomous paid capability execution. Omit for free discovery, health, and quote tools.
Optional Stripe-standard idempotency key for safe retries on paid capability execution.
Optional single-use human escalation approval ticket (sba_*) for one-time over-cap delegated spends.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Probe live readiness of the Stripe X402 Agent Payment Hub and verify connectivity to its backing Stripe credit ledger. Use this before starting an autonomous workflow or when diagnosing 503 errors; do not use it to browse capability rates (use x402_list_capabilities) or read an account balance (use x402_get_account). Requires no authentication, incurs no charge, and returns ok=false (HTTP 503) if the backing credit ledger is unreachable.
This tool takes no arguments.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http x402-payment-hub https://x402.quantumatlas.xyz/x402/center/mcp
Headers
x-atlas-spend-key (optional, not in the config above): Optional Stripe-funded master or delegated subagent spend key (sbk_*) for autonomous paid capability execution. Omit for free discovery, health, and quote tools.Idempotency-Key (optional, not in the config above): Optional Stripe-standard idempotency key for safe retries on paid capability execution.x-atlas-approval-id (optional, not in the config above): Optional single-use human escalation approval ticket (sba_*) for one-time over-cap delegated spends.Probe live readiness of the Stripe X402 Agent Payment Hub and verify connectivity to its backing Stripe credit ledger. Use this before starting an autonomous workflow or when diagnosing 503 errors; do not use it to browse capability rates (use x402_list_capabilities) or read an account balance (use x402_get_account). Requires no authentication, incurs no charge, and returns ok=false (HTTP 503) if the backing credit ledger is unreachable.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}Create a hosted Stripe Checkout session ($10, $25, $100, $250, or $500 prepaid USD credit pack via card, Apple Pay, Google Pay, or Link — zero crypto required) to fund a new or existing master spend key. Use this when provisioning a brand-new account or topping up a low balance reported by x402_get_account or x402_quote_plan; do not use this to check balances (use x402_get_account) or mint child keys (use x402_issue_delegate_key). Opens an external Stripe Checkout URL without charging until a human completes payment. Omit spend_key to create a new master account, or pass a master sbk_* key to top up; delegated subagent keys are rejected with HTTP 403.
| Argument | Type | Description |
|---|---|---|
| spend_key | string | Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header. |
| amount_cents* | any | Prepaid Stripe credit pack size in USD cents: 1000 ($10), 2500 ($25), 10000 ($100), 25000 ($250), or 50000 ($500). |
| return_surface | string | Web console surface to redirect the operator to after Stripe Checkout finishes: "x402" (default, quantumatlas.xyz/x402/), "developers", or "app". |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"amount_cents"
],
"properties": {
"spend_key": {
"type": "string",
"pattern": "^sbk_[A-Za-z0-9_-]{32,96}$",
"description": "Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header."
},
"amount_cents": {
"anyOf": [
{
"type": "number",
"const": 1000
},
{
"type": "number",
"const": 2500
},
{
"type": "number",
"const": 10000
},
{
"type": "number",
"const": 25000
},
{
"type": "number",
"const": 50000
}
],
"description": "Prepaid Stripe credit pack size in USD cents: 1000 ($10), 2500 ($25), 10000 ($100), 25000 ($250), or 50000 ($500)."
},
"return_surface": {
"enum": [
"x402",
"developers",
"app"
],
"type": "string",
"description": "Web console surface to redirect the operator to after Stripe Checkout finishes: \"x402\" (default, quantumatlas.xyz/x402/), \"developers\", or \"app\"."
}
},
"additionalProperties": false
}Approve once (15-minute single-use redemption window) or deny a pending subagent spend escalation ticket (sba_*). Use this as the master account operator after reviewing pending tickets via x402_get_account; do not use this to open a new escalation ticket (use x402_request_approval) or permanently change a subagent policy (use x402_update_delegate_key). Requires a master sbk_* spend key (delegated keys receive HTTP 403). Approved tickets bind exact principal, route, and cent amount and are atomically consumed on first spend to prevent replay (returns 404/409/410 if missing, already decided, or expired).
| Argument | Type | Description |
|---|---|---|
| note | string | Optional operator audit note recorded with the approval or denial decision. |
| decision* | string | Operator decision: "approve" grants a single-use 15-minute execution pass; "deny" permanently rejects the escalation ticket. |
| spend_key | string | Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header. |
| approval_id* | string | Single-use human spend escalation approval ticket identifier returned by x402_request_approval (format: sba_<16 hex chars>, e.g. sba_aabbccddeeff0011). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"approval_id",
"decision"
],
"properties": {
"note": {
"type": "string",
"maxLength": 240,
"description": "Optional operator audit note recorded with the approval or denial decision."
},
"decision": {
"enum": [
"approve",
"deny"
],
"type": "string",
"description": "Operator decision: \"approve\" grants a single-use 15-minute execution pass; \"deny\" permanently rejects the escalation ticket."
},
"spend_key": {
"type": "string",
"pattern": "^sbk_[A-Za-z0-9_-]{32,96}$",
"description": "Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header."
},
"approval_id": {
"type": "string",
"pattern": "^sba_[a-f0-9]{16}$",
"description": "Single-use human spend escalation approval ticket identifier returned by x402_request_approval (format: sba_<16 hex chars>, e.g. sba_aabbccddeeff0011)."
}
},
"additionalProperties": false
}Execute one priced HTTP 402 capability through the Stripe X402 Hub, debiting exact USD cents from a prepaid spend key and returning the upstream payload, credit receipt, and Ed25519 cryptographic execution attestation. Use this only after confirming capability_id via x402_list_capabilities and verifying pricing via x402_quote_plan; do not use this for price quotes (use x402_quote_plan). Charges prepaid USD credit (pass max_spend_cents as a hard caller ceiling and idempotency_key for safe retries); failed upstream calls (HTTP >= 400) automatically refund credit and restore delegate budgets. Pass approval_id (sba_*) after x402_decide_approval approves an over-cap request. Returns 401/402/403 if the key is missing, underfunded, frozen, or over policy cap.
| Argument | Type | Description |
|---|---|---|
| arguments | object | JSON input arguments expected by the target capability (e.g. {"destination": "annapolis"} for reality_harbor_state or {"query": "city dock"} for kb_search). |
| spend_key | string | Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header. |
| approval_id | string | Single-use human spend escalation approval ticket identifier returned by x402_request_approval (format: sba_<16 hex chars>, e.g. sba_aabbccddeeff0011). |
| capability_id* | string | Priced capability identifier or route from x402_list_capabilities to execute (e.g. "reality_harbor_state", "kb_search", or "POST /switchboard/chunk"). |
| idempotency_key | string | Stripe-standard idempotency key (8-128 chars, e.g. "run-2026-11-22-harbor-01") ensuring retries reuse the exact original reservation without double-charging. |
Export a double-entry reconciled enterprise financial statement covering Stripe credit top-ups, capability spends, automatic upstream refunds, delegate attribution, and a tamper-evident SHA-256 checksum (statement_sha256). Use this for accounting audits, reconciliation checks, and per-subagent spend reporting; do not use this for a lightweight live balance or active-key lookup (use x402_get_account). Free and read-only; requires a valid sbk_* spend key (delegated keys receive only rows attributed to their own delegate_id). Subject to 120 req/min/IP rate limiting.
| Argument | Type | Description |
|---|---|---|
| end_date | string | UTC calendar date in ISO-8601 YYYY-MM-DD format (e.g. 2026-11-22). |
| spend_key | string | Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header. |
| start_date | string | UTC calendar date in ISO-8601 YYYY-MM-DD format (e.g. 2026-11-22). |
| delegate_id | string | Unique delegated subagent key identifier returned by x402_issue_delegate_key or x402_get_account (format: sbd_<16 hex chars>, e.g. sbd_1122334455667788). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "UTC calendar date in ISO-8601 YYYY-MM-DD format (e.g. 2026-11-22)."
},
"spend_key": {
"type": "string",
"pattern": "^sbk_[A-Za-z0-9_-]{32,96}$",
"description": "Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "UTC calendar date in ISO-8601 YYYY-MM-DD format (e.g. 2026-11-22)."
},
"delegate_id": {
"type": "string",
"pattern": "^sbd_[a-f0-9]{16}$",
"description": "Unique delegated subagent key identifier returned by x402_issue_delegate_key or x402_get_account (format: sbd_<16 hex chars>, e.g. sbd_1122334455667788)."
}
},
"additionalProperties": false
}Read current prepaid USD balance, key role (master vs delegate), emergency freeze status, active delegated subagent keys, pending escalation approvals, and recent spend orders. Use this for live operational status checks and to locate delegate_id (sbd_*) or pending approval_id (sba_*) records; do not use this for double-entry financial reconciliation or date-range exports (use x402_export_statement) or per-call policy preflight (use x402_quote_plan). Free and read-only; requires a valid master or delegated sbk_* spend key (returns HTTP 401 if missing, invalid, or revoked; 120 req/min/IP limit).
| Argument | Type | Description |
|---|---|---|
| spend_key | string | Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"spend_key": {
"type": "string",
"pattern": "^sbk_[A-Za-z0-9_-]{32,96}$",
"description": "Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header."
}
},
"additionalProperties": false
}Mint a new budget-capped, route-scoped, expiring delegated spend key (sbk_*) for a subagent or automated workflow backed by your master Stripe account. Use this to provision least-privilege spending credentials for a new subagent; do not use this to adjust limits on an existing key (use x402_update_delegate_key) or disable a key (use x402_revoke_delegate_key). Requires a master sbk_* spend key (delegated keys receive HTTP 403). Returns the secret child spend key exactly once — persist it in a secret store because later x402_get_account calls return only masked hints.
| Argument | Type | Description |
|---|---|---|
| label* | string | Human-readable label identifying the subagent or workflow (1-80 chars, e.g. "harbor-monitor-agent"). |
| agent_id | string | Optional stable machine agent identifier recorded on spend audit rows (e.g. "agent.cursor.prod-01"). |
| spend_key | string | Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header. |
| ttl_hours | integer | Key expiration window in hours from issuance (1 to 8760 hours = 1 year). Omit for non-expiring until revoked. |
| allowed_routes | array | Route allowlist patterns restricting which capabilities the delegated key may invoke (supports exact routes like "POST /kb/search" or prefix wildcards like "GET /reality/*"). Omit or pass [] to allow all hub capabilities. |
| max_order_cents |
List all priced HTTP 402 capabilities, exact USD rates, per-capability JSON input_schema, example_arguments, capability lanes, free discovery tools, and Stripe spend-key payment rules. Use this first to discover valid capability_id values and exact argument schemas before calling x402_quote_plan or x402_execute_capability (pass capability_id to inspect a single capability cleanly). Do not use this to verify live ledger availability (use x402_check_health) or compute multi-item totals (use x402_quote_plan). Requires no authentication, incurs no charge, and never mutates state.
| Argument | Type | Description |
|---|---|---|
| lane | string | Optional capability lane filter: live_data (maritime/harbor/parking oracles), studio_audio (GPU stem separation), switchboard (11-language voice/broadcast), member_tools (KB/co-creation), or live_broadcast. |
| capability_id | string | Optional specific capability_id or route key to inspect (e.g. "reality_harbor_state", "audio_visual_isolate", or "POST /switchboard/chunk") when retrieving its exact input_schema and example_arguments without loading all 25 capabilities. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"lane": {
"enum": [
"live_data",
"studio_audio",
"switchboard",
"member_tools",
"live_broadcast"
],
"type": "string",
"description": "Optional capability lane filter: live_data (maritime/harbor/parking oracles), studio_audio (GPU stem separation), switchboard (11-language voice/broadcast), member_tools (KB/co-creation), or live_broadcast."
},
"capability_id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Optional specific capability_id or route key to inspect (e.g. \"reality_harbor_state\", \"audio_visual_isolate\", or \"POST /switchboard/chunk\") when retrieving its exact input_schema and example_arguments without loading all 25 capabilities."
}
},
"additionalProperties": false
}Calculate 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.
| Argument | Type | Description |
|---|---|---|
| items* | array | Ordered list of 1 to 25 capability line items to price and policy-check together. |
| spend_key | string | Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"capability_id"
],
"properties": {
"order": {
"type": "object",
"description": "Optional request payload required only for dynamically quoted routes such as POST /switchboard/chunk (e.g. {\"text\": \"Hello harbor.\", \"languages\": [\"es-US\", \"ja-JP\"]}).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"quantity": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Integer number of calls to quote for this capability (1 to 1000; defaults to 1)."
},
"capability_id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Capability identifier or route key from x402_list_capabilities (e.g. \"reality_harbor_state\", \"audio_visual_isolate\", \"POST /switchboard/chunk\", or \"/kb/search\")."
}
},
"description": "One priced capability line item to include in the quote calculation.",
"additionalProperties": false
},
"maxItems": 25,
"minItems": 1,
"description": "Ordered list of 1 to 25 capability line items to price and policy-check together."
},
"spend_key": {
"type": "string",
"pattern": "^sbk_[A-Za-z0-9_-]{32,96}$",
"description": "Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header."
}
},
"additionalProperties": false
}Create a pending single-use human escalation ticket (sba_*) when a delegated subagent needs one-time permission to exceed its standing per-call cap, budget, or route allowlist. Use this after x402_quote_plan returns human_approval_required=true on a delegated key; do not use this to approve/deny tickets (use x402_decide_approval) or permanently raise standing caps (use x402_update_delegate_key). Free and non-charging; requires a valid sbk_* spend key. Once approved by the master operator via x402_decide_approval, pass the returned approval_id to x402_execute_capability within 15 minutes.
| Argument | Type | Description |
|---|---|---|
| cents | integer | Exact USD cent amount requested for approval (optional for fixed-SKU capabilities where the hub auto-resolves the exact price). |
| spend_key | string | Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header. |
| ttl_minutes | integer | Minutes the pending ticket remains open awaiting operator decision (1 to 1440; defaults to 60 minutes). |
| capability_id* | string | Target capability_id or route key requiring one-time over-cap execution (e.g. "audio_visual_isolate" or "POST /audio/visual-isolate"). |
| justification* | string | Concise human-readable reason explaining why this one-time spend exception is required (shown to the operator in the /x402/ approval queue). |
Permanently revoke one delegated subagent spend key by delegate_id (sbd_*), or revoke every active delegated key across the account when revoke_all=true. Use this immediately to disable a compromised, retired, or runaway subagent; do not use this for a temporary reversible pause across the whole account (use x402_set_account_freeze) or to adjust caps (use x402_update_delegate_key). Destructive and irreversible: revoked keys immediately fail with HTTP 401 and cannot be reactivated. Requires a master sbk_* spend key; provide either delegate_id (single key) or revoke_all=true (entire swarm).
| Argument | Type | Description |
|---|---|---|
| reason | string | Optional audit-log reason for revocation (e.g. "key_rotated" or "compromised_worker"). |
| spend_key | string | Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header. |
| revoke_all | boolean | Set true to execute the emergency swarm kill switch revoking EVERY active delegated subagent key on the account (omit delegate_id when true). |
| delegate_id | string | Unique delegated subagent key identifier returned by x402_issue_delegate_key or x402_get_account (format: sbd_<16 hex chars>, e.g. sbd_1122334455667788). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"reason": {
"type": "string",
"maxLength": 160,
"description": "Optional audit-log reason for revocation (e.g. \"key_rotated\" or \"compromised_worker\")."
},
"spend_key": {
"type": "string",
"pattern": "^sbk_[A-Za-z0-9_-]{32,96}$",
"description": "Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header."
},
"revoke_all": {
"type": "boolean",
"description": "Set true to execute the emergency swarm kill switch revoking EVERY active delegated subagent key on the account (omit delegate_id when true)."
},
"delegate_id": {
"type": "string",
"pattern": "^sbd_[a-f0-9]{16}$",
"description": "Unique delegated subagent key identifier returned by x402_issue_delegate_key or x402_get_account (format: sbd_<16 hex chars>, e.g. sbd_1122334455667788)."
}
},
"additionalProperties": false
}Emergency kill switch that immediately freezes (frozen=true) or unfreezes (frozen=false) all capability spends across the master account and every delegated subagent key. Use this to pause all spending immediately during an incident while preserving keys for later resumption; do not use this to permanently destroy individual subagent keys (use x402_revoke_delegate_key). High-impact and reversible: while frozen, every spend attempt fails closed with HTTP 403 account_frozen. Requires a master sbk_* spend key (delegated keys receive HTTP 403).
| Argument | Type | Description |
|---|---|---|
| frozen* | boolean | Set true to immediately halt all master and subagent spends across the account, or false to lift the freeze and resume spending. |
| reason | string | Optional incident or operator audit reason recorded on the account freeze state (e.g. "anomaly_investigation"). |
| spend_key | string | Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"frozen"
],
"properties": {
"frozen": {
"type": "boolean",
"description": "Set true to immediately halt all master and subagent spends across the account, or false to lift the freeze and resume spending."
},
"reason": {
"type": "string",
"maxLength": 160,
"description": "Optional incident or operator audit reason recorded on the account freeze state (e.g. \"anomaly_investigation\")."
},
"spend_key": {
"type": "string",
"pattern": "^sbk_[A-Za-z0-9_-]{32,96}$",
"description": "Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header."
}
},
"additionalProperties": false
}Modify standing spend limits, route allowlist, or label on an active delegated subagent key (sbd_*) live without rotating its secret. Use this to tighten or expand ongoing budgets for an existing subagent; do not use this to mint a new key (use x402_issue_delegate_key), grant a single-use exception (use x402_decide_approval), or permanently disable a key (use x402_revoke_delegate_key). Requires a master sbk_* spend key; idempotent for identical policy payloads. Returns HTTP 403 for delegated callers and HTTP 404 if delegate_id is unknown.
| Argument | Type | Description |
|---|---|---|
| label | string | Updated human-readable label for the delegated subagent key. |
| spend_key | string | Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header. |
| delegate_id* | string | Unique delegated subagent key identifier returned by x402_issue_delegate_key or x402_get_account (format: sbd_<16 hex chars>, e.g. sbd_1122334455667788). |
| allowed_routes | array | Route allowlist patterns restricting which capabilities the delegated key may invoke (supports exact routes like "POST /kb/search" or prefix wildcards like "GET /reality/*"). Omit or pass [] to allow all hub capabilities. |
| max_order_cents | any | Updated per-call spend cap in USD cents, or null to clear the per-call cap. |
| daily_budget_cents |
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.
What changed in this server's tools since we started watching, newest first. Each change is scanned again.
Export a double-entry reconciled enterprise financial statement (JSON with SHA-256 reconciliation checksum) covering Stripe top-ups, capability spends, automatic refunds, and delegate attribution.
Emergency kill switch: immediately freeze or unfreeze all spends across the master account and every delegated subagent key.
Approve or deny a pending single-use subagent spend approval ticket (sba_*) using the master Stripe account key.
Create a pending single-use human-in-the-loop spend escalation approval ticket (sba_*) when a delegated subagent needs one-time permission above its standing cap or route allowlist.
Immediately revoke a delegated child X402 spend key by its delegate_id (sbd_*).
Mint a budget-capped, route-scoped, time-boxed child X402 spend key (sbk_*) for a subagent or workflow from your master Stripe-funded account.
Create a hosted Stripe Checkout session ($10, $25, $100, $250, or $500 credit pack via Card, Apple Pay, Google Pay, or Link) to fund a new or existing master X402 spend key (sbk_*) with zero crypto required.
Inspect your Stripe X402 spend key balance, key role (master vs delegate), active policy limits, remaining daily/total budgets, delegated subagent keys, and recent receipts.
Preflight quote any single HTTP 402 capability or multi-step agent plan (items) and evaluate whether your Stripe spend key (or delegated subagent key) can auto-execute within balance, per-order cap, daily cap, total cap, and route allowlist.
Read the Stripe-Powered X402 Agent Payment Hub & Capability Payment Center catalog: priced capability lanes, exact USD rates, MCP tool bindings, free magnet tools, and zero-crypto Stripe spend-key rules.
Synthesize a detached Ed25519-signed two-tier physical reality corroboration envelope (atlas.reality.two_tier_corroboration.v1) combining Tier-1 passive camera-scout corridor observations with Tier-2 face-redacted human VisualEvidenceReceipts and automatic bounty escalation guidance.
Create an A2A Eyes-on-Street / Eyes-on-Venue optical verification bounty settled on Base Mainnet USDC (payment_proof_token) or authorized sovereign grant.
Retrieve an A2A optical verification bounty record and its detached Ed25519 VisualEvidenceReceipt by bounty_id.
Free, zero-auth catalog of Optical Network / Smart-Glasses platform monetization wedges and destination walking loops.
Free, zero-auth list of open LiveLens Eyes-as-a-Service (EaaS) optical verification bounties.
Free, zero-auth price quote for any Agent Bazaar skill with optional holder wallet discount preview.
Free, zero-auth NFT holder discount & entitlement tier breakdown for Bazaar skills.
Free, zero-auth Agent Bazaar pricing tier table.
Free, zero-auth Agent Bazaar summary broken down by pricing tier and sovereign agent.
Free, zero-auth Agent Bazaar catalog of every priced Quantum Atlas skill and pricing tier.
| max_spend_cents | integer | Hard client-side spend ceiling in USD cents (e.g. 50 = $0.50). If the live capability price exceeds this value, execution aborts with HTTP 403 before any debit occurs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"capability_id"
],
"properties": {
"arguments": {
"type": "object",
"description": "JSON input arguments expected by the target capability (e.g. {\"destination\": \"annapolis\"} for reality_harbor_state or {\"query\": \"city dock\"} for kb_search).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"spend_key": {
"type": "string",
"pattern": "^sbk_[A-Za-z0-9_-]{32,96}$",
"description": "Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header."
},
"approval_id": {
"type": "string",
"pattern": "^sba_[a-f0-9]{16}$",
"description": "Single-use human spend escalation approval ticket identifier returned by x402_request_approval (format: sba_<16 hex chars>, e.g. sba_aabbccddeeff0011)."
},
"capability_id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Priced capability identifier or route from x402_list_capabilities to execute (e.g. \"reality_harbor_state\", \"kb_search\", or \"POST /switchboard/chunk\")."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"description": "Stripe-standard idempotency key (8-128 chars, e.g. \"run-2026-11-22-harbor-01\") ensuring retries reuse the exact original reservation without double-charging."
},
"max_spend_cents": {
"type": "integer",
"maximum": 100000000,
"minimum": 1,
"description": "Hard client-side spend ceiling in USD cents (e.g. 50 = $0.50). If the live capability price exceeds this value, execution aborts with HTTP 403 before any debit occurs."
}
},
"additionalProperties": false
}| integer |
| Maximum USD cents allowed on any single capability call (e.g. 50 = $0.50). Omit for no per-call limit. |
| daily_budget_cents | integer | Rolling UTC-day spend cap in USD cents (e.g. 500 = $5.00/day). Omit for no daily cap. |
| total_budget_cents | integer | Lifetime cumulative spend cap in USD cents across the key lifespan (e.g. 2500 = $25.00 total). Omit for no lifetime cap. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Human-readable label identifying the subagent or workflow (1-80 chars, e.g. \"harbor-monitor-agent\")."
},
"agent_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Optional stable machine agent identifier recorded on spend audit rows (e.g. \"agent.cursor.prod-01\")."
},
"spend_key": {
"type": "string",
"pattern": "^sbk_[A-Za-z0-9_-]{32,96}$",
"description": "Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header."
},
"ttl_hours": {
"type": "integer",
"maximum": 8760,
"minimum": 1,
"description": "Key expiration window in hours from issuance (1 to 8760 hours = 1 year). Omit for non-expiring until revoked."
},
"allowed_routes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"maxItems": 64,
"description": "Route allowlist patterns restricting which capabilities the delegated key may invoke (supports exact routes like \"POST /kb/search\" or prefix wildcards like \"GET /reality/*\"). Omit or pass [] to allow all hub capabilities."
},
"max_order_cents": {
"type": "integer",
"maximum": 100000000,
"minimum": 1,
"description": "Maximum USD cents allowed on any single capability call (e.g. 50 = $0.50). Omit for no per-call limit."
},
"daily_budget_cents": {
"type": "integer",
"maximum": 100000000,
"minimum": 1,
"description": "Rolling UTC-day spend cap in USD cents (e.g. 500 = $5.00/day). Omit for no daily cap."
},
"total_budget_cents": {
"type": "integer",
"maximum": 100000000,
"minimum": 1,
"description": "Lifetime cumulative spend cap in USD cents across the key lifespan (e.g. 2500 = $25.00 total). Omit for no lifetime cap."
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"capability_id",
"justification"
],
"properties": {
"cents": {
"type": "integer",
"maximum": 100000000,
"minimum": 1,
"description": "Exact USD cent amount requested for approval (optional for fixed-SKU capabilities where the hub auto-resolves the exact price)."
},
"spend_key": {
"type": "string",
"pattern": "^sbk_[A-Za-z0-9_-]{32,96}$",
"description": "Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header."
},
"ttl_minutes": {
"type": "integer",
"maximum": 1440,
"minimum": 1,
"description": "Minutes the pending ticket remains open awaiting operator decision (1 to 1440; defaults to 60 minutes)."
},
"capability_id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Target capability_id or route key requiring one-time over-cap execution (e.g. \"audio_visual_isolate\" or \"POST /audio/visual-isolate\")."
},
"justification": {
"type": "string",
"maxLength": 280,
"minLength": 1,
"description": "Concise human-readable reason explaining why this one-time spend exception is required (shown to the operator in the /x402/ approval queue)."
}
},
"additionalProperties": false
}| any |
| Updated UTC daily budget cap in USD cents, or null to clear the daily cap. |
| total_budget_cents | any | Updated lifetime cumulative cap in USD cents, or null to clear the lifetime cap. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"delegate_id"
],
"properties": {
"label": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Updated human-readable label for the delegated subagent key."
},
"spend_key": {
"type": "string",
"pattern": "^sbk_[A-Za-z0-9_-]{32,96}$",
"description": "Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header."
},
"delegate_id": {
"type": "string",
"pattern": "^sbd_[a-f0-9]{16}$",
"description": "Unique delegated subagent key identifier returned by x402_issue_delegate_key or x402_get_account (format: sbd_<16 hex chars>, e.g. sbd_1122334455667788)."
},
"allowed_routes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"maxItems": 64,
"description": "Route allowlist patterns restricting which capabilities the delegated key may invoke (supports exact routes like \"POST /kb/search\" or prefix wildcards like \"GET /reality/*\"). Omit or pass [] to allow all hub capabilities."
},
"max_order_cents": {
"anyOf": [
{
"type": "integer",
"maximum": 100000000,
"minimum": 1
},
{
"type": "null"
}
],
"description": "Updated per-call spend cap in USD cents, or null to clear the per-call cap."
},
"daily_budget_cents": {
"anyOf": [
{
"type": "integer",
"maximum": 100000000,
"minimum": 1
},
{
"type": "null"
}
],
"description": "Updated UTC daily budget cap in USD cents, or null to clear the daily cap."
},
"total_budget_cents": {
"anyOf": [
{
"type": "integer",
"maximum": 100000000,
"minimum": 1
},
{
"type": "null"
}
],
"description": "Updated lifetime cumulative cap in USD cents, or null to clear the lifetime cap."
}
},
"additionalProperties": false
}