x402 Pay — USDC API Payment Helper
Pay for APIs with USDC. Read-only x402 payment discovery, verification, evidence, and status.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~2,350Tokens (tool definitions)
~4.9 KBTypical response size
Moderate attention impact (1.84% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"x402-pay": {
"url": "https://squeezeos-api.onrender.com/mcp/x402-pay"
}
}
}Remote endpoints
https://squeezeos-api.onrender.com/mcp/x402-paystreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢payment_info
Read the documented SML x402 v2 Base/USDC configuration and receiver before selecting a paid route. Returns configuration and a read-only policy. Fresh resource requirements override these hints; this tool does not sign, spend or prove settlement.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"asset": {
"type": "string"
},
"asset_contract": {
"type": "string"
},
"network": {
"type": "string"
},
"pay_to": {
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
},
"policy": {
"type": "object"
},
"product": {
"type": "string"
},
"protocol": {
"type": "string"
}
},
"required": [
"product",
"protocol",
"network",
"asset",
"asset_contract",
"pay_to",
"policy"
],
"additionalProperties": true
}🟢list_paid_apis(limit)
List paid API operations declared by the live SqueezeOS OpenAPI document, bounded by limit. Returns method, path, job and advertised price. Use for route selection, then inspect that resource's fresh 402 challenge; listed prices do not authorize payment.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"default": 10,
"description": "Maximum number of declared paid operations to return; not an exhaustive catalog count.",
"maximum": 25,
"minimum": 1,
"type": "integer"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"count": {
"type": "integer"
},
"ok": {
"type": "boolean"
},
"operations": {
"items": {
"additionalProperties": true,
"properties": {
"advertised_price": {},
"job": {},
"method": {
"type": "string"
},
"path": {
"type": "string"
}
},
"required": [
"method",
"path",
"job",
"advertised_price"
],
"type": "object"
},
"type": "array"
},
"source": {
"type": "string"
}
},
"required": [
"ok",
"source",
"count",
"operations"
],
"additionalProperties": true
}🟢check_payment(url)
Inspect a public HTTPS URL for a fresh x402 v2 HTTP 402 challenge using an unsigned GET with a 10-second network timeout and no redirect following. Returns validated payTo, asset, network, atomic amount, resource and maxTimeoutSeconds; incomplete or non-x402 responses return challenge=null and a reason. Does not sign, settle or verify receipts. Fresh requirements override documented receiver hints; inspect canonical_receiver_match before choosing to pay.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "Full public HTTPS URL to inspect with an unsigned GET. No payment headers; redirects, credentials and private network targets are rejected.",
"format": "uri",
"maxLength": 2048,
"minLength": 8,
"pattern": "^https://",
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"canonical_receiver_match": {
"description": "Comparison with documented SML receiver; a mismatch never rewrites upstream requirements.",
"type": "boolean"
},
"challenge": {
"description": "Fresh validated requirements, or null. No synthetic defaults are inserted.",
"oneOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"pattern": "^[0-9]+$",
"type": "string"
},
"asset": {
"description": "Asset identifier from the fresh requirements; never replaced with a cached symbol.",
"minLength": 1,
"type": "string"
},
"maxTimeoutSeconds": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"network": {
"minLength": 1,
"type": "string"
},
"payTo": {
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
},
"resource": {
"description": "Exact resource URL or identifier advertised by the endpoint.",
"minLength": 1,
"type": "string"
},
"scheme": {
"description": "Payment scheme advertised by the fresh requirement.",
"minLength": 1,
"type": "string"
},
"x402Version": {
"const": 2
}
},
"required": [
"x402Version",
"scheme",
"payTo",
"asset",
"network",
"amount",
"resource",
"maxTimeoutSeconds"
],
"type": "object"
},
{
"type": "null"
}
]
},
"http_status": {
"description": "Observed HTTP status; zero means no HTTP response was received.",
"maximum": 599,
"minimum": 0,
"type": "integer"
},
"is_x402": {
"description": "True only for HTTP 402 with complete validated x402 v2 requirements.",
"type": "boolean"
},
"missing_fields": {
"items": {
"type": "string"
},
"type": "array"
},
"payment_sent": {
"const": false
},
"raw_headers": {
"additionalProperties": {
"type": "string"
},
"description": "Allowlisted response headers only; never cookies or authentication headers.",
"type": "object"
},
"reason": {
"type": "string"
}
},
"required": [
"is_x402",
"http_status",
"challenge",
"payment_sent"
],
"additionalProperties": true,
"allOf": [
{
"else": {
"properties": {
"challenge": {
"type": "null"
}
}
},
"if": {
"properties": {
"is_x402": {
"const": true
}
}
},
"then": {
"properties": {
"challenge": {
"additionalProperties": false,
"properties": {
"amount": {
"pattern": "^[0-9]+$",
"type": "string"
},
"asset": {
"description": "Asset identifier from the fresh requirements; never replaced with a cached symbol.",
"minLength": 1,
"type": "string"
},
"maxTimeoutSeconds": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"network": {
"minLength": 1,
"type": "string"
},
"payTo": {
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
},
"resource": {
"description": "Exact resource URL or identifier advertised by the endpoint.",
"minLength": 1,
"type": "string"
},
"scheme": {
"description": "Payment scheme advertised by the fresh requirement.",
"minLength": 1,
"type": "string"
},
"x402Version": {
"const": 2
}
},
"required": [
"x402Version",
"scheme",
"payTo",
"asset",
"network",
"amount",
"resource",
"maxTimeoutSeconds"
],
"type": "object"
},
"http_status": {
"const": 402
}
}
}
}
]
}🟢x402_inspect_challenge(url)
Inspect a fresh x402 v2 challenge without sending payment. Compatible alias of check_payment with the same schema, 10-second unsigned probe and result. Use before a paid resource call; do not use as a signer, receipt verifier or settlement proof. Non-402 and incomplete challenges remain null rather than receiving invented defaults.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "Full public HTTPS URL to inspect with an unsigned GET. No payment headers; redirects, credentials and private network targets are rejected.",
"format": "uri",
"maxLength": 2048,
"minLength": 8,
"pattern": "^https://",
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"canonical_receiver_match": {
"description": "Comparison with documented SML receiver; a mismatch never rewrites upstream requirements.",
"type": "boolean"
},
"challenge": {
"description": "Fresh validated requirements, or null. No synthetic defaults are inserted.",
"oneOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"pattern": "^[0-9]+$",
"type": "string"
},
"asset": {
"description": "Asset identifier from the fresh requirements; never replaced with a cached symbol.",
"minLength": 1,
"type": "string"
},
"maxTimeoutSeconds": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"network": {
"minLength": 1,
"type": "string"
},
"payTo": {
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
},
"resource": {
"description": "Exact resource URL or identifier advertised by the endpoint.",
"minLength": 1,
"type": "string"
},
"scheme": {
"description": "Payment scheme advertised by the fresh requirement.",
"minLength": 1,
"type": "string"
},
"x402Version": {
"const": 2
}
},
"required": [
"x402Version",
"scheme",
"payTo",
"asset",
"network",
"amount",
"resource",
"maxTimeoutSeconds"
],
"type": "object"
},
{
"type": "null"
}
]
},
"http_status": {
"description": "Observed HTTP status; zero means no HTTP response was received.",
"maximum": 599,
"minimum": 0,
"type": "integer"
},
"is_x402": {
"description": "True only for HTTP 402 with complete validated x402 v2 requirements.",
"type": "boolean"
},
"missing_fields": {
"items": {
"type": "string"
},
"type": "array"
},
"payment_sent": {
"const": false
},
"raw_headers": {
"additionalProperties": {
"type": "string"
},
"description": "Allowlisted response headers only; never cookies or authentication headers.",
"type": "object"
},
"reason": {
"type": "string"
}
},
"required": [
"is_x402",
"http_status",
"challenge",
"payment_sent"
],
"additionalProperties": true,
"allOf": [
{
"else": {
"properties": {
"challenge": {
"type": "null"
}
}
},
"if": {
"properties": {
"is_x402": {
"const": true
}
}
},
"then": {
"properties": {
"challenge": {
"additionalProperties": false,
"properties": {
"amount": {
"pattern": "^[0-9]+$",
"type": "string"
},
"asset": {
"description": "Asset identifier from the fresh requirements; never replaced with a cached symbol.",
"minLength": 1,
"type": "string"
},
"maxTimeoutSeconds": {
"maximum": 3600,
"minimum": 1,
"type": "integer"
},
"network": {
"minLength": 1,
"type": "string"
},
"payTo": {
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
},
"resource": {
"description": "Exact resource URL or identifier advertised by the endpoint.",
"minLength": 1,
"type": "string"
},
"scheme": {
"description": "Payment scheme advertised by the fresh requirement.",
"minLength": 1,
"type": "string"
},
"x402Version": {
"const": 2
}
},
"required": [
"x402Version",
"scheme",
"payTo",
"asset",
"network",
"amount",
"resource",
"maxTimeoutSeconds"
],
"type": "object"
},
"http_status": {
"const": 402
}
}
}
}
]
}🟢check_status
Read the current SqueezeOS backend status and payment-readiness evidence. Returns both upstream envelopes and autonomous_spend=false. Use to diagnose readiness before purchase; HTTP availability or readiness flags alone do not establish settled or accepted delivery.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"autonomous_spend": {
"const": false
},
"core": {
"additionalProperties": true,
"properties": {
"body": {
"description": "Exact upstream JSON or a bounded text excerpt; missing evidence is not filled in."
},
"ok": {
"description": "Whether the selected upstream returned HTTP 2xx; not settlement proof.",
"type": "boolean"
},
"payment_required": {
"type": "boolean"
},
"source": {
"description": "The queried local upstream path.",
"type": "string"
},
"status_code": {
"type": "integer"
}
},
"required": [
"ok",
"status_code",
"source",
"body",
"payment_required"
],
"type": "object"
},
"hosting": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"payment_readiness": {
"additionalProperties": true,
"properties": {
"body": {
"description": "Exact upstream JSON or a bounded text excerpt; missing evidence is not filled in."
},
"ok": {
"description": "Whether the selected upstream returned HTTP 2xx; not settlement proof.",
"type": "boolean"
},
"payment_required": {
"type": "boolean"
},
"source": {
"description": "The queried local upstream path.",
"type": "string"
},
"status_code": {
"type": "integer"
}
},
"required": [
"ok",
"status_code",
"source",
"body",
"payment_required"
],
"type": "object"
}
},
"required": [
"ok",
"hosting",
"core",
"payment_readiness",
"autonomous_spend"
],
"additionalProperties": true
}Community
Evidence
Recent observations
verifiedversion not recorded5 tools
verifiedversion not recorded5 tools
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools