spendmcp-x402.vercel.app

purchase_access

Buy access to a premium resource. Uses a stable idempotency key per resource for this session, so retrying a failed or uncertain call replays the same payment instead of double-charging — never invent a new paymentId on retry; omit it and this tool reuses the one already in flight for the resource. quoteId is best-effort: if missing, expired, or mismatched, the server transparently re-quotes at the current price. A human approval sheet may appear if the purchase needs confirmation under the current spending policy. On success, call query_premium_dataset to read the data.

Input schema

{
  "type": "object",
  "properties": {
    "resourceId": {
      "type": "string",
      "pattern": "^[a-z0-9-]{1,64}$"
    },
    "quoteId": {
      "type": "string",
      "pattern": "^q_[a-z0-9]+$"
    },
    "paymentId": {
      "type": "string",
      "pattern": "^pay_[a-zA-Z0-9_-]{8,128}$"
    }
  },
  "required": [
    "resourceId"
  ],
  "additionalProperties": false
}