{ "openapi": "3.1.0", "info": { "title": "Nuri public website", "version": "2026-08-29", "description": "Public website discovery plus agent-ready x402 and MPP postcard payment services. Version 1 is the current public discovery contract. Retiring routes are marked deprecated: true in this document and signalled with RFC 9745 Deprecation and RFC 8594 Sunset response headers before removal. No sunset is currently scheduled.", "contact": { "email": "support@nuri.com" }, "x-deprecation-policy": { "url": "https://nuri.com/docs#versions", "summary": "Version 1 is the current public discovery contract. Retiring routes are marked deprecated: true in this document and signalled with RFC 9745 Deprecation and RFC 8594 Sunset response headers before removal. No sunset is currently scheduled." }, "x-guidance": "Send one 4x6 physical postcard through POST /api/x402/postcards or POST /api/mpp/postcards. Supply a public HTTPS front_image_url, message, and recipient with name, address, city, province, postal_code, and two-letter country; seller and idempotency are automatic. x402 v2 upto authorizes at most 3.50 USDC and settles the thanks.io cost plus 21%. Native MPP charges a fixed all-in 3.50 USDC on Base. Pay the runtime 402 challenge and retry the identical body. A paid 200 returns the privacy-safe order identifier as id (the challenge calls it public_order_id); poll GET /api/x402/orders/{publicOrderId}. Use the preview endpoint before purchase; preview never mails a postcard." }, "externalDocs": { "description": "Postcard API usage, payment lifecycle, examples, status model, and operational constraints", "url": "https://nuri.com/docs/x402-username-marketplace" }, "servers": [ { "url": "https://nuri.com" } ], "x-service-info": { "categories": [ "website", "finance", "developer-tools", "commerce" ], "docs": { "homepage": "https://nuri.com", "llms": "https://nuri.com/llms.txt", "mcp": "https://nuri.com/.well-known/mcp/server-card.json", "x402": "https://nuri.com/docs/x402-username-marketplace" } }, "paths": { "/openapi.json": { "get": { "operationId": "getOpenApiDocument", "summary": "Read the public API contract", "description": "Returns this OpenAPI 3.1 document with deployment-dependent MPP discovery. Public discovery accepts X-Nuri-API-Version: 1 (the default when omitted). A different value returns 400. GET/HEAD on /openapi.json, /shop/feed.json, /api, /api/x402 and /mcp, plus POST /mcp, share 600 requests per 60 seconds per runtime instance. This is not a distributed or per-user allowance and does not apply to payment, order-status or seller-resolution routes. Exhaustion takes precedence over version validation; respect Retry-After on 429. HEAD responses have no body.", "responses": { "200": { "description": "OpenAPI document", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenApiDocument" } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "400": { "description": "Unsupported public discovery API version, or endpoint-specific invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DiscoveryVersionError" } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "429": { "description": "Shared public discovery quota exhausted; retry after the indicated delay", "headers": { "Retry-After": { "schema": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "description": "Seconds until this runtime window resets." }, "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DiscoveryRateLimitError" } } } } }, "parameters": [ { "name": "X-Nuri-API-Version", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "1" ], "default": "1" } } ] } }, "/": { "get": { "operationId": "getEnglishLandingPage", "summary": "Read the English Nuri landing page", "description": "Read the English Nuri landing page. Returns the published HTML document; Accept: text/markdown requests its agent-readable representation.", "responses": { "200": { "description": "HTML page", "content": { "text/html": { "schema": { "type": "string" } }, "text/markdown": { "schema": { "type": "string" } } } } } } }, "/bitcoin-deutschland/": { "get": { "operationId": "getGermanCanonicalLandingPage", "summary": "Read the canonical German Nuri landing page", "description": "Read the canonical German Nuri landing page. Returns the published HTML document; Accept: text/markdown requests its agent-readable representation.", "responses": { "200": { "description": "HTML page", "content": { "text/html": { "schema": { "type": "string" } }, "text/markdown": { "schema": { "type": "string" } } } } } } }, "/de/": { "get": { "operationId": "getGermanShortLandingPage", "summary": "Read the short German landing page alias", "description": "Read the short German landing page alias. Returns the published HTML document; Accept: text/markdown requests its agent-readable representation.", "responses": { "200": { "description": "HTML page", "content": { "text/html": { "schema": { "type": "string" } }, "text/markdown": { "schema": { "type": "string" } } } } } } }, "/bitcoin-espana/": { "get": { "operationId": "getSpanishCanonicalLandingPage", "summary": "Read the canonical Spanish Nuri landing page", "description": "Read the canonical Spanish Nuri landing page. Returns the published HTML document; Accept: text/markdown requests its agent-readable representation.", "responses": { "200": { "description": "HTML page", "content": { "text/html": { "schema": { "type": "string" } }, "text/markdown": { "schema": { "type": "string" } } } } } } }, "/es/": { "get": { "operationId": "getSpanishShortLandingPage", "summary": "Read the short Spanish landing page alias", "description": "Read the short Spanish landing page alias. Returns the published HTML document; Accept: text/markdown requests its agent-readable representation.", "responses": { "200": { "description": "HTML page", "content": { "text/html": { "schema": { "type": "string" } }, "text/markdown": { "schema": { "type": "string" } } } } } } }, "/bitcoin-italia/": { "get": { "operationId": "getItalianCanonicalLandingPage", "summary": "Read the canonical Italian Nuri landing page", "description": "Read the canonical Italian Nuri landing page. Returns the published HTML document; Accept: text/markdown requests its agent-readable representation.", "responses": { "200": { "description": "HTML page", "content": { "text/html": { "schema": { "type": "string" } }, "text/markdown": { "schema": { "type": "string" } } } } } } }, "/it/": { "get": { "operationId": "getItalianShortLandingPage", "summary": "Read the short Italian landing page alias", "description": "Read the short Italian landing page alias. Returns the published HTML document; Accept: text/markdown requests its agent-readable representation.", "responses": { "200": { "description": "HTML page", "content": { "text/html": { "schema": { "type": "string" } }, "text/markdown": { "schema": { "type": "string" } } } } } } }, "/privacy-policy": { "get": { "operationId": "getPrivacyPolicy", "summary": "Read the Nuri Privacy Policy", "description": "Read the Nuri Privacy Policy. Returns the published HTML document; Accept: text/markdown requests its agent-readable representation.", "responses": { "200": { "description": "HTML page", "content": { "text/html": { "schema": { "type": "string" } }, "text/markdown": { "schema": { "type": "string" } } } } } } }, "/invest": { "get": { "operationId": "getInvestorBriefing", "summary": "Read the Nuri investor briefing", "description": "Read the Nuri investor briefing. Returns the published HTML document; Accept: text/markdown requests its agent-readable representation.", "responses": { "200": { "description": "HTML page", "content": { "text/html": { "schema": { "type": "string" } }, "text/markdown": { "schema": { "type": "string" } } } } } } }, "/invest/index.md": { "get": { "operationId": "getInvestorBriefingMarkdown", "summary": "Read the investor briefing as Markdown", "description": "Read the investor briefing as Markdown. Returns the complete published text without a JSON envelope.", "responses": { "200": { "description": "Read the investor briefing as Markdown", "content": { "text/markdown": { "schema": { "type": "string" } } } } } } }, "/invest/index.json": { "get": { "operationId": "getInvestorBriefingJson", "summary": "Read the structured investor briefing", "description": "Read the structured investor briefing. Returns the public InvestorBriefing representation; no private account data or payment is requested.", "responses": { "200": { "description": "Read the structured investor briefing", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvestorBriefing" } } } } } } }, "/terms-of-service": { "get": { "operationId": "getTermsOfService", "summary": "Read the Nuri Terms of Service", "description": "Read the Nuri Terms of Service. Returns the published HTML document; Accept: text/markdown requests its agent-readable representation.", "responses": { "200": { "description": "HTML page", "content": { "text/html": { "schema": { "type": "string" } }, "text/markdown": { "schema": { "type": "string" } } } } } } }, "/docs/x402-username-marketplace": { "get": { "operationId": "getX402PostcardDocumentation", "summary": "Read the agent-ready x402 postcard documentation", "description": "Read the agent-ready x402 postcard documentation. Returns the published HTML document; Accept: text/markdown requests its agent-readable representation.", "responses": { "200": { "description": "HTML page", "content": { "text/html": { "schema": { "type": "string" } }, "text/markdown": { "schema": { "type": "string" } } } } } } }, "/docs/x402-username-marketplace/index.md": { "get": { "operationId": "getX402PostcardDocumentationMarkdown", "summary": "Read the x402 service documentation as Markdown", "description": "Read the x402 service documentation as Markdown. Returns the complete published text without a JSON envelope.", "responses": { "200": { "description": "Read the x402 service documentation as Markdown", "content": { "text/markdown": { "schema": { "type": "string" } } } } } } }, "/llms.txt": { "get": { "operationId": "getLlmsTxt", "summary": "Read the concise agent context", "description": "Read the concise agent context. Returns the complete published text without a JSON envelope.", "responses": { "200": { "description": "Read the concise agent context", "content": { "text/markdown": { "schema": { "type": "string" } } } } } } }, "/llms-full.txt": { "get": { "operationId": "getLlmsFullTxt", "summary": "Read the full agent context", "description": "Read the full agent context. Returns the complete published text without a JSON envelope.", "responses": { "200": { "description": "Read the full agent context", "content": { "text/plain": { "schema": { "type": "string" } } } } } } }, "/.well-known/api-catalog": { "get": { "operationId": "getApiCatalog", "summary": "Read the API catalog linkset", "description": "Read the API catalog linkset. Returns the public ApiCatalog representation; no private account data or payment is requested.", "responses": { "200": { "description": "Read the API catalog linkset", "content": { "application/linkset+json": { "schema": { "$ref": "#/components/schemas/ApiCatalog" } } } } } } }, "/.well-known/agent-card.json": { "get": { "operationId": "getAgentCard", "summary": "Read the public site agent card", "description": "Read the public site agent card. Returns the public AgentCard representation; no private account data or payment is requested.", "responses": { "200": { "description": "Read the public site agent card", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentCard" } } } } } } }, "/.well-known/mcp/server-card.json": { "get": { "operationId": "getMcpServerCard", "summary": "Read the MCP server card", "description": "Read the MCP server card. Returns the public McpServerCard representation; no private account data or payment is requested.", "responses": { "200": { "description": "Read the MCP server card", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/McpServerCard" } } } } } } }, "/mcp": { "post": { "operationId": "callMcp", "summary": "Call the read-only public website MCP server", "description": "Send one JSON-RPC 2.0 message, not a batch. Node uses stateless Streamable HTTP: send Content-Type: application/json and Accept: application/json, text/event-stream. Requests return JSON; notifications return an empty 202 on Node and a JSON result on Worker. tools/call arguments and structured results describe the nine public read-only tools. Resource templates and completion are supported on Node; Worker returns a JSON-RPC method-not-found error for those methods. Neither runtime exposes private accounts or payment tools. Public discovery accepts X-Nuri-API-Version: 1 (the default when omitted). A different value returns 400. GET/HEAD on /openapi.json, /shop/feed.json, /api, /api/x402 and /mcp, plus POST /mcp, share 600 requests per 60 seconds per runtime instance. This is not a distributed or per-user allowance and does not apply to payment, order-status or seller-resolution routes. Exhaustion takes precedence over version validation; respect Retry-After on 429. HEAD responses have no body.", "parameters": [ { "name": "MCP-Protocol-Version", "in": "header", "required": false, "description": "MCP transport version, independent of X-Nuri-API-Version. Node rejects unsupported versions with HTTP 400.", "schema": { "type": "string" }, "example": "2025-11-05" }, { "name": "X-Nuri-API-Version", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "1" ], "default": "1" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/McpRequest" } } } }, "responses": { "200": { "description": "JSON-RPC result or application error (inspect error and tool isError)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/McpResponse" } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "202": { "description": "Node accepted a notification; no response body", "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "400": { "description": "Unsupported public discovery API version, or endpoint-specific invalid request", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/McpError" }, { "$ref": "#/components/schemas/DiscoveryVersionError" } ] } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "406": { "description": "Node requires Accept to include application/json and text/event-stream", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/McpError" } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "415": { "description": "Node requires Content-Type: application/json", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/McpError" } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "429": { "description": "Shared public discovery quota exhausted; retry after the indicated delay", "headers": { "Retry-After": { "schema": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "description": "Seconds until this runtime window resets." }, "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DiscoveryRateLimitError" } } } }, "500": { "description": "MCP transport internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/McpError" } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } } } } }, "/api": { "get": { "operationId": "getX402DiscoveryChallenge", "summary": "Read the root API x402 discovery challenge", "description": "GET /api returns the preview-only x402 challenge for the Bitcoin shop discovery product. It advertises the supported payment rails (x402/USDC, Lightning and on-chain Bitcoin) and captures no funds; live settlement completes in the Nuri app or via the linked partner. Public discovery accepts X-Nuri-API-Version: 1 (the default when omitted). A different value returns 400. GET/HEAD on /openapi.json, /shop/feed.json, /api, /api/x402 and /mcp, plus POST /mcp, share 600 requests per 60 seconds per runtime instance. This is not a distributed or per-user allowance and does not apply to payment, order-status or seller-resolution routes. Exhaustion takes precedence over version validation; respect Retry-After on 429. HEAD responses have no body.", "responses": { "400": { "description": "Unsupported public discovery API version, or endpoint-specific invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DiscoveryVersionError" } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "402": { "description": "x402 discovery challenge; preview-only, no funds captured", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 x402 v2 preview quote for the fixed-price discovery product.", "schema": { "type": "string" } }, "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckoutQuote" } } } }, "429": { "description": "Shared public discovery quota exhausted; retry after the indicated delay", "headers": { "Retry-After": { "schema": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "description": "Seconds until this runtime window resets." }, "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DiscoveryRateLimitError" } } } } }, "parameters": [ { "name": "X-Nuri-API-Version", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "1" ], "default": "1" } } ] } }, "/api/x402": { "get": { "operationId": "getX402ServiceCatalog", "summary": "Read Nuri paid-service discovery and adapter metadata", "description": "Read Nuri paid-service discovery and adapter metadata. Returns the public X402Catalog representation; no private account data or payment is requested. Public discovery accepts X-Nuri-API-Version: 1 (the default when omitted). A different value returns 400. GET/HEAD on /openapi.json, /shop/feed.json, /api, /api/x402 and /mcp, plus POST /mcp, share 600 requests per 60 seconds per runtime instance. This is not a distributed or per-user allowance and does not apply to payment, order-status or seller-resolution routes. Exhaustion takes precedence over version validation; respect Retry-After on 429. HEAD responses have no body.", "responses": { "200": { "description": "Read Nuri paid-service discovery and adapter metadata", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Catalog" } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "400": { "description": "Unsupported public discovery API version, or endpoint-specific invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DiscoveryVersionError" } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "429": { "description": "Shared public discovery quota exhausted; retry after the indicated delay", "headers": { "Retry-After": { "schema": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "description": "Seconds until this runtime window resets." }, "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DiscoveryRateLimitError" } } } } }, "parameters": [ { "name": "X-Nuri-API-Version", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "1" ], "default": "1" } } ] } }, "/api/x402/resolve/{username}": { "get": { "operationId": "resolveNuriSeller", "summary": "Resolve a Nuri username to its ENS payout address", "description": "Normalizes a short username, @username or username.nuri.eth and resolves its Ethereum payout address with timestamped ENS evidence. Does not initiate payment.", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string" }, "example": "emino.nuri.eth" } ], "responses": { "200": { "description": "ENS resolution evidence", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnsResolution" } } } }, "400": { "description": "Invalid seller name", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Username has no resolvable EVM address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Internal resolution error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/x402/postcards/preview": { "post": { "operationId": "previewX402Postcard", "summary": "Preview one physical postcard without mailing it", "description": "Calls thanks.io with preview=true. No mailpiece is created.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402PostcardRequest" } } } }, "responses": { "200": { "description": "Preview URLs; no postcard mailed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PostcardPreview" } } } }, "400": { "description": "Invalid postcard request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Seller is not enabled", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Seller ENS resolution failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Internal error or malformed JSON", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Provider error or missing preview URLs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Postcard preview is not configured", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/x402/postcards": { "post": { "operationId": "sendX402Postcard", "summary": "Pay for and send one physical postcard", "description": "x402 v2 upto in USDC. The exact thanks.io cost plus 21% settles directly to the ENS-resolved seller.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402PostcardRequest" } } } }, "responses": { "200": { "description": "Payment settled and postcard submitted, or cached identical operation. The public order identifier is id.", "headers": { "PAYMENT-RESPONSE": { "description": "Base64 settlement response on a newly settled request; not repeated for a cached result.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PostcardSendResult" } } } }, "400": { "description": "Invalid postcard fields or payment identifier", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "402": { "description": "Unpaid requests return order context. Invalid credentials and settlement failures can return {}: inspect PAYMENT-REQUIRED or PAYMENT-RESPONSE. Browser requests may return an HTML paywall.", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 x402 v2 challenge. Retry the identical body with PAYMENT-SIGNATURE.", "schema": { "type": "string", "contentEncoding": "base64", "contentMediaType": "application/json", "contentSchema": { "$ref": "#/components/schemas/X402PaymentRequiredHeader" } } }, "PAYMENT-RESPONSE": { "description": "Settlement failure evidence when settlement was attempted.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/PostcardPaymentRequired" }, { "$ref": "#/components/schemas/EmptyObject" } ] } }, "text/html": { "schema": { "type": "string" } } } }, "403": { "description": "Seller is not enabled for this fulfillment adapter", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Seller ENS resolution failed or operation does not exist", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Idempotency, payment identifier, state, reconciliation or price conflict; inspect the order before retrying", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "410": { "description": "Explicit operation ID has expired; use a new operation ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "412": { "description": "Permit2 allowance required; inspect PAYMENT-REQUIRED before retrying", "headers": { "PAYMENT-REQUIRED": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyObject" } }, "text/html": { "schema": { "type": "string" } } } }, "500": { "description": "Internal error, including malformed JSON or oversized request body in the Node runtime", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Invalid provider response or unconfirmed x402 settlement response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Service not configured, storage busy, or submission outcome requires reconciliation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "Base64 x402 v2 payment payload after receiving the runtime challenge. X-Payment is also accepted for compatibility.", "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "maximum", "amount": "3.50", "currency": "USDC" }, "protocols": [ { "x402": { "version": 2, "scheme": "upto" } } ], "accepts": [ { "protocol": "x402", "scheme": "upto", "network": "eip155:8453", "currency": "USDC" }, { "protocol": "x402", "scheme": "upto", "network": "eip155:137", "currency": "USDC" }, { "protocol": "x402", "scheme": "upto", "network": "eip155:42161", "currency": "USDC" } ], "description": "Maximum authorization is 3.50 USDC; settlement charges the thanks.io authorization total plus 21%." } } }, "/api/mpp/postcards": { "post": { "operationId": "sendMppPostcard", "parameters": [ { "name": "Authorization", "in": "header", "required": false, "description": "Payment credential for the runtime MPP challenge (Payment scheme). Payment-Authorization and Payment-Signature are compatibility alternatives.", "schema": { "type": "string" } } ], "summary": "Pay with native MPP and send one physical postcard", "description": "Native MPP EVM charge on Base. Fixed all-in price 3.50 USDC. Seller and operation ID are automatic.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402PostcardRequest" } } } }, "x-payment-info": { "amount": "3500000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "One 4x6 physical postcard through thanks.io; fixed all-in MPP price. Amount is in Base-USDC atomic units.", "intent": "charge", "method": "evm" }, "responses": { "200": { "description": "MPP payment settled; inspect status for submitted versus fulfillment reconciliation. Cached retries preserve the receipt. Public identifier: id.", "headers": { "Payment-Receipt": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PostcardSendResult" } } } }, "400": { "description": "Invalid postcard fields or payment identifier", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "402": { "description": "Native MPP challenge or rejected credential. Pay WWW-Authenticate and retry the identical body with Authorization: Payment. Problem details describe recovery.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/MppProblem" } } } }, "403": { "description": "Seller is not enabled for this fulfillment adapter", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Seller ENS resolution failed or operation does not exist", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "405": { "description": "MPP postcard endpoint requires POST", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "Idempotency, payment identifier, state, reconciliation or price conflict; inspect the order before retrying", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "410": { "description": "Explicit operation ID has expired; use a new operation ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Internal error, including malformed JSON or oversized request body in the Node runtime", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "502": { "description": "Invalid provider response or unconfirmed x402 settlement response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Service not configured, storage busy, or submission outcome requires reconciliation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/x402/orders/{publicOrderId}": { "get": { "operationId": "getX402PostcardOrder", "summary": "Read privacy-safe payment and postcard delivery status", "description": "Poll using public_order_id from a challenge, or id from a paid response. Unpaid orders omit pricing/payment/delivery until evidence exists; recipient addresses and messages are never returned.", "parameters": [ { "name": "publicOrderId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{32}$" } } ], "responses": { "200": { "description": "Payment and delivery status without recipient PII", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PostcardOrder" } } } }, "400": { "description": "Invalid public order ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Order not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Internal order-storage error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/shop/feed.json": { "get": { "operationId": "getShopProductFeed", "summary": "Read the machine-readable Bitcoin shop product feed", "description": "Read the machine-readable Bitcoin shop product feed. Returns the public ProductFeed representation; no private account data or payment is requested. Public discovery accepts X-Nuri-API-Version: 1 (the default when omitted). A different value returns 400. GET/HEAD on /openapi.json, /shop/feed.json, /api, /api/x402 and /mcp, plus POST /mcp, share 600 requests per 60 seconds per runtime instance. This is not a distributed or per-user allowance and does not apply to payment, order-status or seller-resolution routes. Exhaustion takes precedence over version validation; respect Retry-After on 429. HEAD responses have no body.", "responses": { "200": { "description": "Read the machine-readable Bitcoin shop product feed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductFeed" } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "400": { "description": "Unsupported public discovery API version, or endpoint-specific invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DiscoveryVersionError" } } }, "headers": { "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } } }, "429": { "description": "Shared public discovery quota exhausted; retry after the indicated delay", "headers": { "Retry-After": { "schema": { "type": "string", "pattern": "^[1-9][0-9]*$" }, "description": "Seconds until this runtime window resets." }, "X-Nuri-API-Version": { "description": "Selected public discovery version.", "schema": { "type": "string", "const": "1" } }, "RateLimit-Policy": { "description": "One quota shared globally by requests reaching this runtime instance, not per user or per endpoint.", "schema": { "type": "string", "const": "\"public-discovery\";q=600;w=60" } }, "RateLimit": { "description": "Remaining requests (r) and seconds until this instance window resets (t).", "schema": { "type": "string", "pattern": "^\"public-discovery\";r=[0-9]+;t=[0-9]+$" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DiscoveryRateLimitError" } } } } }, "parameters": [ { "name": "X-Nuri-API-Version", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "1" ], "default": "1" } } ] } }, "/shop/checkout": { "get": { "operationId": "quoteShopCheckout", "summary": "Request a Bitcoin shop checkout quote", "description": "Returns a preview-only quote for a shop SKU. No funds are captured; this is not the paid postcard service.", "parameters": [ { "name": "sku", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "400": { "description": "Missing or unknown SKU; discover valid products in the feed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckoutError" } } } }, "402": { "description": "Dynamic quote preview; no funds captured", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 x402 v2 preview quote for fixed-price products; absent for open amounts.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckoutQuote" } } } } } } } }, "components": { "schemas": { "JsonValue": { "anyOf": [ { "type": [ "string", "number", "boolean", "null" ] }, { "type": "array", "items": { "$ref": "#/components/schemas/JsonValue" } }, { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } ] }, "EmptyObject": { "type": "object", "properties": {}, "required": [], "additionalProperties": false, "description": "An actual empty SDK result/body, not an unspecified object." }, "DiscoveryVersionError": { "type": "object", "properties": { "error": { "type": "string", "const": "unsupported_api_version" }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false }, "DiscoveryRateLimitError": { "type": "object", "properties": { "error": { "type": "string", "const": "rate_limited" }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false }, "OpenApiDocument": { "type": "object", "properties": { "openapi": { "type": "string", "const": "3.1.0" }, "info": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "string" }, "description": { "type": "string" }, "contact": { "type": "object", "properties": { "email": { "type": "string" } }, "required": [ "email" ], "additionalProperties": false }, "x-guidance": { "type": "string" }, "x-deprecation-policy": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "summary": { "type": "string" } }, "required": [ "url", "summary" ], "additionalProperties": false } }, "required": [ "title", "version", "description", "contact", "x-guidance", "x-deprecation-policy" ], "additionalProperties": false }, "externalDocs": { "type": "object", "properties": { "description": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "description", "url" ], "additionalProperties": false }, "servers": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ], "additionalProperties": false } }, "x-service-info": { "type": "object", "properties": { "categories": { "type": "array", "items": { "type": "string" } }, "docs": { "type": "object", "properties": { "homepage": { "type": "string", "format": "uri" }, "llms": { "type": "string", "format": "uri" }, "mcp": { "type": "string", "format": "uri" }, "x402": { "type": "string", "format": "uri" } }, "required": [ "homepage", "llms", "mcp", "x402" ], "additionalProperties": false } }, "required": [ "categories", "docs" ], "additionalProperties": false }, "paths": { "type": "object", "additionalProperties": { "type": "object", "properties": { "get": { "$ref": "#/components/schemas/OpenApiOperation" }, "post": { "$ref": "#/components/schemas/OpenApiOperation" }, "head": { "$ref": "#/components/schemas/OpenApiOperation" } }, "required": [], "additionalProperties": false } }, "components": { "type": "object", "properties": { "schemas": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } } }, "required": [ "schemas" ], "additionalProperties": false } }, "required": [ "openapi", "info", "externalDocs", "servers", "x-service-info", "paths", "components" ], "additionalProperties": false }, "OpenApiOperation": { "type": "object", "properties": { "operationId": { "type": "string" }, "summary": { "type": "string" }, "description": { "type": "string" }, "parameters": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "in": { "type": "string", "enum": [ "path", "query", "header" ] }, "required": { "type": "boolean" }, "schema": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } }, "description": { "type": "string" }, "example": { "$ref": "#/components/schemas/JsonValue" } }, "required": [ "name", "in", "required", "schema" ], "additionalProperties": false } }, "requestBody": { "type": "object", "properties": { "required": { "type": "boolean" }, "content": { "$ref": "#/components/schemas/OpenApiContent" } }, "required": [ "required", "content" ], "additionalProperties": false }, "responses": { "type": "object", "additionalProperties": { "type": "object", "properties": { "description": { "type": "string" }, "content": { "$ref": "#/components/schemas/OpenApiContent" }, "headers": { "type": "object", "additionalProperties": { "type": "object", "properties": { "description": { "type": "string" }, "schema": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "schema" ], "additionalProperties": false } } }, "required": [ "description" ], "additionalProperties": false } }, "x-payment-info": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "operationId", "summary", "description", "responses" ], "additionalProperties": false }, "OpenApiContent": { "type": "object", "additionalProperties": { "type": "object", "properties": { "schema": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "schema" ], "additionalProperties": false } }, "ApiError": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" }, "details": { "anyOf": [ { "type": "string" }, { "$ref": "#/components/schemas/ErrorDetails" } ] } }, "required": [ "error", "message" ], "additionalProperties": false }, "ErrorDetails": { "type": "object", "properties": { "diagnostics": { "$ref": "#/components/schemas/PostcardDiagnostics" }, "cause": { "type": "string" } }, "required": [], "additionalProperties": true }, "PostcardDiagnostics": { "type": "object", "properties": { "checked": { "type": "array", "items": { "type": "string" } }, "missing": { "type": "array", "items": { "type": "object", "properties": { "variable": { "type": "string" }, "required": { "type": "boolean" }, "remediation": { "type": "string" } }, "required": [ "variable", "required", "remediation" ], "additionalProperties": false } }, "ready": { "type": "boolean" } }, "required": [ "checked", "missing", "ready" ], "additionalProperties": false }, "ApiCatalog": { "type": "object", "properties": { "linkset": { "type": "array", "items": { "type": "object", "properties": { "anchor": { "type": "string", "format": "uri" }, "item": { "type": "array", "items": { "type": "object", "properties": { "href": { "type": "string", "format": "uri" }, "rel": { "type": "string" }, "type": { "type": "string" }, "title": { "type": "string" } }, "required": [ "href", "rel", "type", "title" ], "additionalProperties": false } } }, "required": [ "anchor", "item" ], "additionalProperties": false } } }, "required": [ "linkset" ], "additionalProperties": false }, "AgentCard": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "version": { "type": "string" }, "provider": { "type": "object", "properties": { "organization": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "organization", "url" ], "additionalProperties": false }, "documentationUrl": { "type": "string", "format": "uri" }, "supportedInterfaces": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "protocolBinding": { "type": "string", "format": "uri" }, "protocolVersion": { "type": "string" } }, "required": [ "url", "protocolBinding", "protocolVersion" ], "additionalProperties": false } }, "defaultInputModes": { "type": "array", "items": { "type": "string" } }, "defaultOutputModes": { "type": "array", "items": { "type": "string" } }, "skills": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "name", "description", "tags" ], "additionalProperties": false } }, "capabilities": { "type": "object", "properties": { "streaming": { "type": "boolean" }, "pushNotifications": { "type": "boolean" }, "stateTransitionHistory": { "type": "boolean" }, "extensions": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string", "format": "uri" }, "description": { "type": "string" }, "required": { "type": "boolean" } }, "required": [ "uri", "description", "required" ], "additionalProperties": false } } }, "required": [ "streaming", "pushNotifications", "stateTransitionHistory", "extensions" ], "additionalProperties": false }, "authentication": { "type": "object", "properties": { "schemes": { "type": "array", "items": { "type": "string" } } }, "required": [ "schemes" ], "additionalProperties": false } }, "required": [ "name", "description", "url", "version", "provider", "documentationUrl", "supportedInterfaces", "defaultInputModes", "defaultOutputModes", "skills", "capabilities", "authentication" ], "additionalProperties": false }, "McpServerCard": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "version": { "type": "string" }, "serverInfo": { "type": "object", "properties": { "name": { "type": "string" }, "version": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "websiteUrl": { "type": "string", "format": "uri" } }, "required": [ "name", "version" ], "additionalProperties": true }, "documentationUrl": { "type": "string", "format": "uri" }, "serverUrl": { "type": "string", "format": "uri" }, "transport": { "type": "object", "properties": { "type": { "type": "string", "const": "streamable-http" }, "url": { "type": "string", "format": "uri" } }, "required": [ "type", "url" ], "additionalProperties": false }, "capabilities": { "type": "object", "properties": { "tools": { "type": "boolean" }, "resources": { "type": "boolean" }, "prompts": { "type": "boolean" } }, "required": [ "tools", "resources", "prompts" ], "additionalProperties": false }, "tools": { "type": "array", "items": { "type": "string" } }, "resources": { "type": "array", "items": { "type": "string" } }, "prompts": { "type": "array", "items": { "type": "string" } } }, "required": [ "name", "description", "version", "serverInfo", "documentationUrl", "serverUrl", "transport", "capabilities", "tools", "resources", "prompts" ], "additionalProperties": false }, "InvestorBriefing": { "type": "object", "properties": { "updated": { "type": "string", "format": "date" }, "audience": { "type": "string" }, "title": { "type": "string" }, "thesis": { "type": "string" }, "oneLiner": { "type": "string" }, "founderCredentials": { "type": "array", "items": { "type": "string" } }, "comparison": { "type": "object", "properties": { "headline": { "type": "string" }, "claim": { "type": "string" }, "natural": { "type": "string" } }, "required": [ "headline", "claim", "natural" ], "additionalProperties": false }, "pillars": { "type": "array", "items": { "type": "object", "properties": { "number": { "type": "string" }, "title": { "type": "string" }, "body": { "type": "string" } }, "required": [ "number", "title", "body" ], "additionalProperties": false } }, "liveServices": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "tools": { "type": "integer", "minimum": 0 }, "role": { "type": "string" } }, "required": [ "name", "url", "tools", "role" ], "additionalProperties": false } }, "proof": { "type": "object", "properties": { "tools": { "type": "integer", "minimum": 0 }, "mcps": { "type": "integer", "minimum": 0 }, "verified": { "type": "string", "format": "date" }, "voice": { "type": "string" }, "solver": { "type": "string" } }, "required": [ "tools", "mcps", "verified", "voice", "solver" ], "additionalProperties": false }, "raise": { "type": "object", "properties": { "runway": { "type": "string" }, "next": { "type": "string" }, "uses": { "type": "array", "items": { "type": "string" } } }, "required": [ "runway", "next", "uses" ], "additionalProperties": false }, "marketModel": { "type": "object", "properties": { "addressableWallets": { "type": "string" }, "targetShare": { "type": "string" }, "activeWallets": { "type": "string" }, "monthlyVolumePerWallet": { "type": "string" }, "annualVolume": { "type": "string" }, "takeRate": { "type": "string" }, "annualRevenue": { "type": "string" } }, "required": [ "addressableWallets", "targetShare", "activeWallets", "monthlyVolumePerWallet", "annualVolume", "takeRate", "annualRevenue" ], "additionalProperties": false }, "fiveYearVision": { "type": "string" }, "projectionCaveat": { "type": "string" }, "sources": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "label", "url" ], "additionalProperties": false } } }, "required": [ "updated", "audience", "title", "thesis", "oneLiner", "founderCredentials", "comparison", "pillars", "liveServices", "proof", "raise", "marketModel", "fiveYearVision", "projectionCaveat", "sources" ], "additionalProperties": false }, "ShopProduct": { "type": "object", "properties": { "id": { "type": "string" }, "sku": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "brand": { "type": "string" }, "category": { "type": "string" }, "google_product_category": { "type": "string" }, "price": { "anyOf": [ { "type": "object", "properties": { "value": { "type": "number" }, "currency": { "type": "string", "const": "USD" } }, "required": [ "value", "currency" ], "additionalProperties": false }, { "type": "null" } ] }, "price_display": { "type": "string" }, "availability": { "type": "string" }, "condition": { "type": "string", "const": "new" }, "image_link": { "type": "string", "format": "uri" }, "link": { "type": "string", "format": "uri" }, "markdown": { "type": "string", "format": "uri" }, "checkout": { "type": "string", "format": "uri" }, "payment_methods": { "type": "array", "items": { "type": "string" } }, "review": { "type": "object", "properties": { "rating": { "type": "number" }, "best_rating": { "type": "number" }, "url": { "type": "string", "format": "uri" }, "verdict": { "type": "string" } }, "required": [ "rating", "best_rating", "url", "verdict" ], "additionalProperties": false } }, "required": [ "id", "sku", "title", "description", "brand", "category", "google_product_category", "price", "price_display", "availability", "condition", "image_link", "link", "markdown", "checkout", "payment_methods" ], "additionalProperties": false }, "ProductFeed": { "type": "object", "properties": { "version": { "type": "string" }, "protocols": { "type": "array", "items": { "type": "string" } }, "merchant": { "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "name", "url" ], "additionalProperties": false }, "currency": { "type": "string", "const": "USD" }, "payment_methods": { "type": "array", "items": { "type": "string" } }, "checkout_endpoint": { "type": "string", "format": "uri" }, "count": { "type": "integer", "minimum": 0 }, "products": { "type": "array", "items": { "$ref": "#/components/schemas/ShopProduct" } } }, "required": [ "version", "protocols", "merchant", "currency", "payment_methods", "checkout_endpoint", "count", "products" ], "additionalProperties": false }, "CheckoutQuote": { "type": "object", "properties": { "x402Version": { "type": "number", "const": 1 }, "error": { "type": "string", "const": "payment_required" }, "resource": { "type": "string", "format": "uri" }, "accepts": { "type": "array", "items": { "type": "object", "properties": { "scheme": { "type": "string", "enum": [ "exact", "lightning", "onchain" ] }, "network": { "type": "string" }, "asset": { "type": "string" }, "maxAmountRequired": { "type": "string" }, "payTo": { "type": "string" }, "resource": { "type": "string", "format": "uri" }, "description": { "type": "string" }, "mimeType": { "type": "string" }, "maxTimeoutSeconds": { "type": "integer", "minimum": 0 }, "extra": { "type": "object", "properties": { "name": { "type": "string" }, "sku": { "type": "string" } }, "required": [ "name", "sku" ], "additionalProperties": false } }, "required": [ "scheme", "network", "asset", "maxAmountRequired", "payTo", "resource", "description" ], "additionalProperties": false } }, "product": { "type": "object", "properties": { "sku": { "type": "string" }, "name": { "type": "string" }, "priceUsd": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "currency": { "type": "string", "const": "USD" }, "category": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "sku", "name", "priceUsd", "currency", "category", "url" ], "additionalProperties": false }, "settlement": { "type": "string", "const": "preview" }, "note": { "type": "string" } }, "required": [ "x402Version", "error", "resource", "accepts", "product", "settlement", "note" ], "additionalProperties": false }, "CheckoutError": { "type": "object", "properties": { "error": { "type": "string", "const": "unknown_sku" }, "message": { "type": "string" }, "feed": { "type": "string", "format": "uri" } }, "required": [ "error", "message", "feed" ], "additionalProperties": false }, "X402Catalog": { "type": "object", "properties": { "name": { "type": "string" }, "protocol": { "type": "object", "properties": { "name": { "type": "string", "const": "x402" }, "version": { "type": "number", "const": 2 }, "network": { "type": "string", "pattern": "^eip155:[0-9]+$" }, "networks": { "type": "array", "items": { "type": "string", "pattern": "^eip155:[0-9]+$" } }, "asset": { "type": "string", "const": "USDC" } }, "required": [ "name", "version", "network", "networks", "asset" ], "additionalProperties": false }, "payment_recipient": { "type": "object", "properties": { "configured_seller": { "type": "string" }, "caller_input_required": { "type": "boolean", "const": false }, "result": { "type": "string" }, "example": { "type": "string", "format": "uri" } }, "required": [ "configured_seller", "caller_input_required", "result", "example" ], "additionalProperties": false }, "services": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "status": { "type": "string", "enum": [ "available", "not_configured" ] }, "diagnostics": { "anyOf": [ { "$ref": "#/components/schemas/PostcardDiagnostics" }, { "type": "null" } ] }, "description": { "type": "string" }, "default_seller": { "type": "string" }, "required_input": { "type": "array", "items": { "type": "string" } }, "optional_input": { "type": "array", "items": { "type": "string" } }, "agent_flow": { "type": "string" }, "preview": { "type": "string", "format": "uri" }, "paid_endpoint": { "type": "string", "format": "uri" }, "mpp_paid_endpoint": { "type": "string", "format": "uri" }, "status_template": { "type": "string" }, "payment": { "type": "object", "properties": { "scheme": { "type": "string", "const": "upto" }, "maximum": { "type": "string", "pattern": "^\\$[0-9]+\\.[0-9]{2}$" }, "actual": { "type": "string" }, "currency": { "type": "string", "const": "USDC" }, "networks": { "type": "array", "items": { "type": "string", "pattern": "^eip155:[0-9]+$" } }, "alternatives": { "type": "array", "items": { "type": "object", "properties": { "protocol": { "type": "string", "const": "mpp" }, "method": { "type": "string", "const": "evm" }, "intent": { "type": "string", "const": "charge" }, "price": { "type": "string" }, "currency": { "type": "string", "const": "USDC" }, "network": { "type": "string", "pattern": "^eip155:[0-9]+$" } }, "required": [ "protocol", "method", "intent", "price", "currency", "network" ], "additionalProperties": false } } }, "required": [ "scheme", "maximum", "actual", "currency", "networks" ], "additionalProperties": false }, "docsUrl": { "type": "string", "format": "uri" } }, "required": [ "id", "status", "diagnostics", "description", "default_seller", "required_input", "optional_input", "agent_flow", "preview", "paid_endpoint", "status_template", "payment", "docsUrl" ], "additionalProperties": false } }, "adapter_contract": { "type": "object", "properties": { "status": { "type": "string" }, "seller_activation": { "type": "string" }, "reused_by_future_services": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string" } }, "required": [ "status", "seller_activation", "reused_by_future_services", "note" ], "additionalProperties": false }, "openapi": { "type": "string", "format": "uri" }, "documentation": { "type": "string", "format": "uri" } }, "required": [ "name", "protocol", "payment_recipient", "services", "adapter_contract", "openapi", "documentation" ], "additionalProperties": false }, "EnsResolution": { "type": "object", "properties": { "input": { "type": "string" }, "name": { "type": "string" }, "address": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "network": { "type": "string", "const": "eip155:1" }, "resolver": { "type": "string" }, "resolved_at": { "type": "string", "format": "date-time" } }, "required": [ "input", "name", "address", "network", "resolver", "resolved_at" ], "additionalProperties": false }, "PostcardPreview": { "type": "object", "properties": { "service": { "type": "string", "const": "thanks-postcard-v1" }, "seller": { "type": "string" }, "pay_to": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "size": { "type": "string", "const": "4x6" }, "previews": { "type": "array", "items": { "type": "string", "format": "uri" }, "minItems": 1 }, "mails_postcard": { "type": "boolean", "const": false }, "maximum_charge": { "type": "string", "pattern": "^\\$[0-9]+\\.[0-9]{2}$" }, "pricing": { "type": "string" } }, "required": [ "service", "seller", "pay_to", "size", "previews", "mails_postcard", "maximum_charge", "pricing" ], "additionalProperties": false }, "PostcardPaymentRequired": { "type": "object", "properties": { "error": { "type": "string", "const": "payment_required" }, "service": { "type": "string", "const": "thanks-postcard-v1" }, "operation_id": { "type": "string", "minLength": 16, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$" }, "public_order_id": { "type": "string", "pattern": "^[a-f0-9]{32}$" }, "seller": { "type": "string" }, "pay_to": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "maximum_charge": { "type": "string", "pattern": "^\\$[0-9]+\\.[0-9]{2}$" }, "actual_charge": { "type": "string" }, "next": { "type": "string" } }, "required": [ "error", "service", "operation_id", "public_order_id", "seller", "pay_to", "maximum_charge", "actual_charge", "next" ], "additionalProperties": false }, "X402PaymentRequiredHeader": { "type": "object", "properties": { "x402Version": { "type": "number", "const": 2 }, "error": { "type": "string" }, "resource": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "description": { "type": "string" }, "mimeType": { "type": "string" }, "serviceName": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "iconUrl": { "type": "string", "format": "uri" } }, "required": [ "url" ], "additionalProperties": true }, "accepts": { "type": "array", "items": { "type": "object", "properties": { "scheme": { "type": "string", "const": "upto" }, "network": { "type": "string", "pattern": "^eip155:[0-9]+$" }, "amount": { "type": "string", "pattern": "^[0-9]+$" }, "asset": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "payTo": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "maxTimeoutSeconds": { "type": "integer", "minimum": 0 }, "extra": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "scheme", "network", "amount", "asset", "payTo", "maxTimeoutSeconds" ], "additionalProperties": false } }, "extensions": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "x402Version", "resource", "accepts" ], "additionalProperties": true }, "MppProblem": { "type": "object", "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "status": { "type": "integer", "minimum": 400, "maximum": 599 }, "detail": { "type": "string" }, "details": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } }, "hint": { "type": "string" }, "challengeId": { "type": "string" } }, "required": [ "type", "title", "status", "detail" ], "additionalProperties": false }, "PostcardOrder": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-f0-9]{32}$" }, "service": { "type": "string", "const": "thanks-postcard-v1" }, "status": { "type": "string", "enum": [ "awaiting_payment", "payment_submission_pending", "payment_submission_unconfirmed", "payment_settled_fulfillment_pending", "provider_submission_pending", "provider_submission_unconfirmed", "provider_order_created", "paid_and_submitted", "provider_canceled_price_exceeded", "provider_canceled_invalid_provider_price", "provider_canceled_settlement_failed", "manual_reconciliation_required", "settlement_pending_reconciliation" ] }, "seller": { "type": "string" }, "pay_to": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "provider_order_id": { "type": "integer", "minimum": 1 }, "provider_status": { "type": "string" }, "pricing": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "provider_cost_plus_markup" }, "provider_cost": { "type": "string", "pattern": "^\\$[0-9]+\\.[0-9]{2}$" }, "markup_percent": { "type": "number", "const": 21 }, "charged": { "type": "string", "pattern": "^\\$[0-9]+\\.[0-9]{2}$" } }, "required": [ "mode", "provider_cost", "markup_percent", "charged" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "fixed" }, "provider_cost": { "type": "string", "pattern": "^\\$[0-9]+\\.[0-9]{2}$" }, "charged": { "type": "string", "pattern": "^\\$[0-9]+\\.[0-9]{2}$" } }, "required": [ "mode", "provider_cost", "charged" ], "additionalProperties": false } ] }, "payment": { "type": "object", "properties": { "rail": { "type": "string", "enum": [ "x402", "mpp" ] }, "network": { "type": "string", "pattern": "^eip155:[0-9]+$" }, "transaction": { "type": "string" }, "payer": { "type": "string" }, "amount_atomic": { "type": "string", "pattern": "^[0-9]+$" } }, "required": [ "rail", "transaction" ], "additionalProperties": false }, "delivery": { "type": "object", "properties": { "stats": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" }, "description": "Provider counters passing the runtime finite-number-coercion filter; original JSON values are retained." }, "error_count": { "type": "integer", "minimum": 0 }, "returned_count": { "type": "integer", "minimum": 0 } }, "required": [ "stats", "error_count", "returned_count" ], "additionalProperties": false }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "service", "status", "seller", "pay_to", "created_at" ], "additionalProperties": false }, "McpRequest": { "oneOf": [ { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "type": [ "string", "integer" ] }, "method": { "type": "string", "const": "initialize" }, "params": { "type": "object", "properties": { "protocolVersion": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } }, "clientInfo": { "type": "object", "properties": { "name": { "type": "string" }, "version": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "websiteUrl": { "type": "string", "format": "uri" } }, "required": [ "name", "version" ], "additionalProperties": true } }, "required": [ "protocolVersion", "capabilities", "clientInfo" ], "additionalProperties": true } }, "required": [ "jsonrpc", "id", "method", "params" ], "additionalProperties": false }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "type": [ "string", "integer" ] }, "method": { "type": "string", "const": "ping" }, "params": { "type": "object", "properties": { "cursor": { "type": "string" }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [], "additionalProperties": true } }, "required": [ "jsonrpc", "id", "method" ], "additionalProperties": false }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "type": [ "string", "integer" ] }, "method": { "type": "string", "const": "tools/list" }, "params": { "type": "object", "properties": { "cursor": { "type": "string" }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [], "additionalProperties": true } }, "required": [ "jsonrpc", "id", "method" ], "additionalProperties": false }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "type": [ "string", "integer" ] }, "method": { "type": "string", "const": "resources/list" }, "params": { "type": "object", "properties": { "cursor": { "type": "string" }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [], "additionalProperties": true } }, "required": [ "jsonrpc", "id", "method" ], "additionalProperties": false }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "type": [ "string", "integer" ] }, "method": { "type": "string", "const": "prompts/list" }, "params": { "type": "object", "properties": { "cursor": { "type": "string" }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [], "additionalProperties": true } }, "required": [ "jsonrpc", "id", "method" ], "additionalProperties": false }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "type": [ "string", "integer" ] }, "method": { "type": "string", "const": "resources/templates/list" }, "params": { "type": "object", "properties": { "cursor": { "type": "string" }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [], "additionalProperties": true } }, "required": [ "jsonrpc", "id", "method" ], "additionalProperties": false }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "type": [ "string", "integer" ] }, "method": { "type": "string", "const": "tools/call" }, "params": { "oneOf": [ { "type": "object", "properties": { "name": { "type": "string", "const": "list_public_pages" }, "arguments": { "type": "object", "properties": {}, "required": [], "additionalProperties": false }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "name" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string", "const": "get_site_summary" }, "arguments": { "type": "object", "properties": { "lang": { "type": "string", "enum": [ "en", "de", "es", "it" ] } }, "required": [], "additionalProperties": false }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "name" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string", "const": "get_app_download_links" }, "arguments": { "type": "object", "properties": {}, "required": [], "additionalProperties": false }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "name" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string", "const": "read_public_page_markdown" }, "arguments": { "type": "object", "properties": { "path": { "type": "string", "enum": [ "/", "/bitcoin-deutschland/", "/bitcoin-espana/", "/bitcoin-italia/", "/de/", "/es/", "/it/", "/invest", "/about", "/contact", "/developers", "/docs", "/docs/x402-username-marketplace", "/privacy-policy", "/terms-of-service" ] } }, "required": [ "path" ], "additionalProperties": false }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "name", "arguments" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string", "const": "list_shop_products" }, "arguments": { "type": "object", "properties": { "category": { "type": "string", "enum": [ "hardware-wallets", "miners", "node-hardware", "steel-backups", "accessories", "wearables", "apparel", "books", "gift-cards" ] } }, "required": [], "additionalProperties": false }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "name" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string", "const": "get_product" }, "arguments": { "type": "object", "properties": { "slug": { "type": "string", "enum": [ "ledger-nano-s-plus", "ledger-nano-x", "ledger-flex", "ledger-stax", "trezor-safe-3", "trezor-safe-5", "bitbox02-bitcoin-only", "bitbox02-multi", "blockstream-jade", "blockstream-jade-plus", "foundation-passport-core", "foundation-passport-prime", "keystone-3-pro", "tangem-wallet", "cypherock-x1", "ellipal-titan-2", "safepal-s1", "onekey-pro", "bitkey", "ngrave-zero", "seedsigner", "tapsigner", "bitaxe-gamma", "bitaxe-supra", "bitaxe-gamma-turbo", "nerdqaxe-plus-plus", "avalon-nano-3", "avalon-nano-3s", "antminer-s21", "futurebit-apollo-ii", "heatbit-trio", "lucky-miner-lv07", "umbrel-home", "umbrel-pro", "start9-server-one", "mynode-two", "cryptosteel-capsule", "blockplate", "stamp-seed-kit", "seedplate-24", "keystone-tablet-plus", "blockclock-mini", "blockclock-micro", "opendime-3pack", "satscard", "faraday-bag", "starmoon-gen2-ring", "pago-ring", "ceramic-standard-ring", "kinetic-orbit-ring", "paycelet-bracelet", "book-broken-money", "book-bitcoin-standard", "book-mastering-bitcoin", "book-internet-of-money", "book-programming-bitcoin", "book-grokking-bitcoin", "book-layered-money", "book-blocksize-war", "book-21-lessons", "book-inventing-bitcoin", "book-financial-privilege", "book-bitcoin-money-kids", "bitrefill-gift-card", "nuri-orange-pill-set", "lightning-gift-card", "onekey-classic-1s", "onekey-classic-1s-pure", "safepal-s1-pro", "safepal-x1", "dcent-biometric", "arculus-wallet", "gridplus-lattice1", "ellipal-titan-mini", "krux-diy", "bitaxe-ultra", "nerdminer-v2", "nerdoctaxe-gamma", "gekkoscience-compac-f", "antminer-s19-xp", "billfodl", "tiny-seed", "coldbit-steel", "usb-data-blocker", "seedsigner-case", "tee-bitcoin-orange", "hoodie-satoshi", "cap-21m", "socks-sats", "book-price-of-tomorrow", "book-gradually-then-suddenly", "book-genesis-book", "book-digital-gold", "book-sovereign-individual", "adornpay-keyfob", "architect-watch" ] } }, "required": [ "slug" ], "additionalProperties": false }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "name", "arguments" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string", "const": "list_support_topics" }, "arguments": { "type": "object", "properties": {}, "required": [], "additionalProperties": false }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "name" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string", "const": "search_support_faq" }, "arguments": { "type": "object", "properties": { "query": { "type": "string" } }, "required": [ "query" ], "additionalProperties": false }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "name", "arguments" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string", "const": "get_support_answer" }, "arguments": { "type": "object", "properties": { "id": { "type": "string", "enum": [ "why-declined", "decline-message-meanings", "insufficient-funds-but-have-money", "card-blocked-wrong-pin", "money-missing-not-spent", "car-rental-hold", "fuel-hold", "negative-balance-force-debit", "refund-failed-transaction", "how-to-dispute", "chargeback-timeline", "chargeback-fee", "debited-again-after-chargeback", "spending-limits", "atm-limits", "sepa-limits", "merchant-blocked", "restricted-countries-currencies", "exchange-rate-different", "cancel-subscription", "transaction-statement", "check-remaining-limit", "withdraw-after-closure", "increase-limit", "limit-increase-documents", "limit-increase-timeline", "wallet-wont-add-card", "token-statuses", "apple-pay-red-path", "sepa-countries", "ach-countries", "check-account-availability" ] } }, "required": [ "id" ], "additionalProperties": false }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "name", "arguments" ], "additionalProperties": false } ] } }, "required": [ "jsonrpc", "id", "method", "params" ], "additionalProperties": false }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "type": [ "string", "integer" ] }, "method": { "type": "string", "const": "resources/read" }, "params": { "type": "object", "properties": { "uri": { "type": "string", "format": "uri" }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "uri" ], "additionalProperties": false } }, "required": [ "jsonrpc", "id", "method", "params" ], "additionalProperties": false }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "type": [ "string", "integer" ] }, "method": { "type": "string", "const": "prompts/get" }, "params": { "type": "object", "properties": { "name": { "type": "string", "const": "nuri_public_site_answer" }, "arguments": { "type": "object", "properties": { "question": { "type": "string", "minLength": 3 }, "lang": { "type": "string", "enum": [ "de", "en" ] } }, "required": [ "question" ], "additionalProperties": false }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "name", "arguments" ], "additionalProperties": false } }, "required": [ "jsonrpc", "id", "method", "params" ], "additionalProperties": false }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "type": [ "string", "integer" ] }, "method": { "type": "string", "const": "completion/complete" }, "params": { "type": "object", "properties": { "ref": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "ref/resource" }, "uri": { "type": "string", "format": "uri-template" } }, "required": [ "type", "uri" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "ref/prompt" }, "name": { "type": "string" } }, "required": [ "type", "name" ], "additionalProperties": false } ] }, "argument": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "additionalProperties": false }, "context": { "type": "object", "properties": { "arguments": { "type": "object", "additionalProperties": { "type": "string" } } }, "required": [ "arguments" ], "additionalProperties": false } }, "required": [ "ref", "argument" ], "additionalProperties": false } }, "required": [ "jsonrpc", "id", "method", "params" ], "additionalProperties": false }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "method": { "type": "string", "const": "notifications/initialized" }, "params": { "type": "object", "properties": { "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [], "additionalProperties": false } }, "required": [ "jsonrpc", "method" ], "additionalProperties": false } ] }, "McpError": { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "anyOf": [ { "type": [ "string", "integer" ] }, { "type": "null" } ] }, "error": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": { "$ref": "#/components/schemas/JsonValue" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "jsonrpc", "id", "error" ], "additionalProperties": false }, "McpResult": { "type": "object", "properties": { "jsonrpc": { "type": "string", "const": "2.0" }, "id": { "anyOf": [ { "type": [ "string", "integer" ] }, { "type": "null" } ] }, "result": { "anyOf": [ { "$ref": "#/components/schemas/McpInitializeResult" }, { "$ref": "#/components/schemas/McpToolsResult" }, { "$ref": "#/components/schemas/McpToolResult" }, { "$ref": "#/components/schemas/McpResourcesResult" }, { "$ref": "#/components/schemas/McpResourceReadResult" }, { "$ref": "#/components/schemas/McpPromptsResult" }, { "$ref": "#/components/schemas/McpPromptResult" }, { "$ref": "#/components/schemas/McpTemplatesResult" }, { "$ref": "#/components/schemas/McpCompletionResult" }, { "$ref": "#/components/schemas/EmptyObject" } ] } }, "required": [ "jsonrpc", "id", "result" ], "additionalProperties": false }, "McpResponse": { "oneOf": [ { "$ref": "#/components/schemas/McpResult" }, { "$ref": "#/components/schemas/McpError" } ] }, "McpInitializeResult": { "type": "object", "properties": { "protocolVersion": { "type": "string" }, "capabilities": { "type": "object", "properties": { "tools": { "type": "object", "properties": { "listChanged": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "resources": { "type": "object", "properties": { "subscribe": { "type": "boolean" }, "listChanged": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "prompts": { "type": "object", "properties": { "listChanged": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "completions": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } }, "required": [ "tools", "resources", "prompts" ], "additionalProperties": true }, "serverInfo": { "type": "object", "properties": { "name": { "type": "string" }, "version": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "websiteUrl": { "type": "string", "format": "uri" } }, "required": [ "name", "version" ], "additionalProperties": true }, "instructions": { "type": "string" } }, "required": [ "protocolVersion", "capabilities", "serverInfo" ], "additionalProperties": false }, "McpToolsResult": { "type": "object", "properties": { "tools": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "inputSchema": { "type": "object", "properties": { "type": { "type": "string", "const": "object" }, "properties": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } }, "required": { "type": "array", "items": { "type": "string" } }, "additionalProperties": { "type": "boolean" }, "$schema": { "type": "string", "format": "uri" } }, "required": [ "type" ], "additionalProperties": true }, "annotations": { "type": "object", "properties": { "readOnlyHint": { "type": "boolean" }, "idempotentHint": { "type": "boolean" } }, "required": [], "additionalProperties": true } }, "required": [ "name", "inputSchema" ], "additionalProperties": true } }, "nextCursor": { "type": "string" } }, "required": [ "tools" ], "additionalProperties": false }, "McpToolResult": { "type": "object", "properties": { "content": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "const": "text" }, "text": { "type": "string" } }, "required": [ "type", "text" ], "additionalProperties": true } }, "structuredContent": { "anyOf": [ { "type": "object", "properties": { "pages": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "lang": { "type": "string", "enum": [ "en", "de", "es", "it" ] }, "title": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "path", "lang", "title", "url" ], "additionalProperties": false } } }, "required": [ "pages" ], "additionalProperties": false }, { "type": "object", "properties": { "lang": { "type": "string", "enum": [ "en", "de", "es", "it" ] }, "title": { "type": "string" }, "headline": { "type": "string" }, "summary": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "downloadLinks": { "type": "object", "properties": { "appStore": { "type": "string", "format": "uri" }, "googlePlay": { "type": "string", "format": "uri" }, "androidIntent": { "type": "string", "format": "uri" } }, "required": [ "appStore", "googlePlay", "androidIntent" ], "additionalProperties": false }, "publicPages": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "lang": { "type": "string", "enum": [ "en", "de", "es", "it" ] }, "title": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "path", "lang", "title", "url" ], "additionalProperties": false } } }, "required": [ "lang", "title", "headline", "summary", "url", "downloadLinks", "publicPages" ], "additionalProperties": false }, { "type": "object", "properties": { "appStore": { "type": "string", "format": "uri" }, "googlePlay": { "type": "string", "format": "uri" }, "androidIntent": { "type": "string", "format": "uri" } }, "required": [ "appStore", "googlePlay", "androidIntent" ], "additionalProperties": false }, { "type": "object", "properties": { "path": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "path", "url" ], "additionalProperties": false }, { "type": "object", "properties": { "count": { "type": "integer", "minimum": 0 }, "feed": { "type": "string", "format": "uri" }, "products": { "type": "array", "items": { "type": "object", "properties": { "slug": { "type": "string" }, "name": { "type": "string" }, "maker": { "type": "string" }, "category": { "type": "string" }, "price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "priceCurrency": { "type": "string", "const": "USD" }, "priceDisplay": { "type": "string" }, "availability": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "checkout": { "type": "string", "format": "uri" }, "paymentMethods": { "type": "array", "items": { "type": "string" } }, "rating": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "reviewUrl": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] } }, "required": [ "slug", "name", "maker", "category", "price", "priceCurrency", "priceDisplay", "availability", "url", "checkout", "paymentMethods", "rating", "reviewUrl" ], "additionalProperties": false } } }, "required": [ "count", "feed", "products" ], "additionalProperties": false }, { "type": "object", "properties": { "slug": { "type": "string" }, "name": { "type": "string" }, "maker": { "type": "string" }, "category": { "type": "string" }, "price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "priceCurrency": { "type": "string", "const": "USD" }, "priceDisplay": { "type": "string" }, "availability": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "checkout": { "type": "string", "format": "uri" }, "paymentMethods": { "type": "array", "items": { "type": "string" } }, "rating": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "reviewUrl": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] } }, "required": [ "slug", "name", "maker", "category", "price", "priceCurrency", "priceDisplay", "availability", "url", "checkout", "paymentMethods", "rating", "reviewUrl" ], "additionalProperties": false }, { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "categories": { "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string" }, "title": { "type": "string" }, "items": { "type": "array", "items": { "type": "object", "properties": { "n": { "type": "integer", "minimum": 0 }, "id": { "type": "string" }, "question": { "type": "string" } }, "required": [ "n", "id", "question" ], "additionalProperties": false } } }, "required": [ "category", "title", "items" ], "additionalProperties": false } } }, "required": [ "url", "categories" ], "additionalProperties": false }, { "type": "object", "properties": { "query": { "type": "string" }, "count": { "type": "integer", "minimum": 0 }, "results": { "type": "array", "items": { "type": "object", "properties": { "n": { "type": "integer", "minimum": 0 }, "id": { "type": "string" }, "category": { "type": "string" }, "categoryTitle": { "type": "string" }, "question": { "type": "string" }, "answerMarkdown": { "type": "string" }, "answerText": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string", "format": "uri" } }, "required": [ "n", "id", "category", "categoryTitle", "question", "answerMarkdown", "answerText", "tags", "source", "url" ], "additionalProperties": false } } }, "required": [ "query", "count", "results" ], "additionalProperties": false }, { "type": "object", "properties": { "n": { "type": "integer", "minimum": 0 }, "id": { "type": "string" }, "category": { "type": "string" }, "categoryTitle": { "type": "string" }, "question": { "type": "string" }, "answerMarkdown": { "type": "string" }, "answerText": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string", "format": "uri" } }, "required": [ "n", "id", "category", "categoryTitle", "question", "answerMarkdown", "answerText", "tags", "source", "url" ], "additionalProperties": false } ] }, "isError": { "type": "boolean" }, "_meta": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" } } }, "required": [ "content" ], "additionalProperties": false }, "McpResourcesResult": { "type": "object", "properties": { "resources": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string", "format": "uri" }, "name": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "uri", "name" ], "additionalProperties": true } }, "nextCursor": { "type": "string" } }, "required": [ "resources" ], "additionalProperties": false }, "McpResourceReadResult": { "type": "object", "properties": { "contents": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string", "format": "uri" }, "mimeType": { "type": "string" }, "text": { "type": "string" } }, "required": [ "uri", "text" ], "additionalProperties": true } } }, "required": [ "contents" ], "additionalProperties": false }, "McpPromptsResult": { "type": "object", "properties": { "prompts": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "arguments": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "required": { "type": "boolean" } }, "required": [ "name" ], "additionalProperties": true } } }, "required": [ "name" ], "additionalProperties": true } }, "nextCursor": { "type": "string" } }, "required": [ "prompts" ], "additionalProperties": false }, "McpPromptResult": { "type": "object", "properties": { "description": { "type": "string" }, "messages": { "type": "array", "items": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "user", "assistant" ] }, "content": { "type": "object", "properties": { "type": { "type": "string", "const": "text" }, "text": { "type": "string" } }, "required": [ "type", "text" ], "additionalProperties": true } }, "required": [ "role", "content" ], "additionalProperties": false } } }, "required": [ "messages" ], "additionalProperties": false }, "McpTemplatesResult": { "type": "object", "properties": { "resourceTemplates": { "type": "array", "items": { "type": "object", "properties": { "uriTemplate": { "type": "string" }, "name": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "mimeType": { "type": "string" } }, "required": [ "uriTemplate", "name" ], "additionalProperties": true } } }, "required": [ "resourceTemplates" ], "additionalProperties": false }, "McpCompletionResult": { "type": "object", "properties": { "completion": { "type": "object", "properties": { "values": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" } }, "required": [ "values" ], "additionalProperties": false } }, "required": [ "completion" ], "additionalProperties": false }, "PostcardSendResult": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-f0-9]{32}$" }, "service": { "type": "string", "const": "thanks-postcard-v1" }, "status": { "type": "string", "enum": [ "awaiting_payment", "payment_submission_pending", "payment_submission_unconfirmed", "payment_settled_fulfillment_pending", "provider_submission_pending", "provider_submission_unconfirmed", "provider_order_created", "paid_and_submitted", "provider_canceled_price_exceeded", "provider_canceled_invalid_provider_price", "provider_canceled_settlement_failed", "manual_reconciliation_required", "settlement_pending_reconciliation" ] }, "seller": { "type": "string" }, "pay_to": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "provider_order_id": { "type": "integer", "minimum": 1 }, "provider_status": { "type": "string" }, "pricing": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "provider_cost_plus_markup" }, "provider_cost": { "type": "string", "pattern": "^\\$[0-9]+\\.[0-9]{2}$" }, "markup_percent": { "type": "number", "const": 21 }, "charged": { "type": "string", "pattern": "^\\$[0-9]+\\.[0-9]{2}$" } }, "required": [ "mode", "provider_cost", "markup_percent", "charged" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "fixed" }, "provider_cost": { "type": "string", "pattern": "^\\$[0-9]+\\.[0-9]{2}$" }, "charged": { "type": "string", "pattern": "^\\$[0-9]+\\.[0-9]{2}$" } }, "required": [ "mode", "provider_cost", "charged" ], "additionalProperties": false } ] }, "payment": { "type": "object", "properties": { "rail": { "type": "string", "enum": [ "x402", "mpp" ] }, "network": { "type": "string", "pattern": "^eip155:[0-9]+$" }, "transaction": { "type": "string" }, "payer": { "type": "string" }, "amount_atomic": { "type": "string", "pattern": "^[0-9]+$" } }, "required": [ "rail", "transaction" ], "additionalProperties": false }, "delivery": { "type": "object", "properties": { "stats": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/JsonValue" }, "description": "Provider counters passing the runtime finite-number-coercion filter; original JSON values are retained." }, "error_count": { "type": "integer", "minimum": 0 }, "returned_count": { "type": "integer", "minimum": 0 } }, "required": [ "stats", "error_count", "returned_count" ], "additionalProperties": false }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "message": { "type": "string" }, "cached": { "type": "boolean", "const": true } }, "required": [ "id", "service", "status", "seller", "pay_to", "created_at" ], "additionalProperties": false, "anyOf": [ { "required": [ "message" ] }, { "required": [ "cached" ] } ] }, "X402PostcardRequest": { "type": "object", "additionalProperties": false, "description": "Canonical typed client input. Runtime trims strings, normalizes seller/country, accepts some coercible legacy values, and ignores unrecognized fields. Those compatibility coercions are not recommended client input. Whitespace-only required values and private/local image hosts are rejected.", "required": [ "front_image_url", "message", "recipient" ], "properties": { "operation_id": { "type": "string", "minLength": 16, "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$", "description": "Optional advanced idempotency override. Omit for automatic deterministic idempotency." }, "seller": { "type": "string", "default": "emino.nuri.eth", "description": "Optional seller override. Normal postcard buyers omit this field." }, "front_image_url": { "type": "string", "format": "uri", "pattern": "^https://", "maxLength": 2048, "description": "Public HTTPS image; local/private hosts are rejected by runtime validation." }, "message": { "type": "string", "minLength": 1, "maxLength": 1200 }, "handwriting_style_id": { "type": "integer", "minimum": 1, "maximum": 10, "default": 4 }, "size": { "type": "string", "enum": [ "4x6" ], "default": "4x6" }, "recipient": { "type": "object", "required": [ "name", "address", "city", "province", "postal_code", "country" ], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "address": { "type": "string", "minLength": 1, "maxLength": 160 }, "address2": { "type": "string", "maxLength": 160 }, "city": { "type": "string", "minLength": 1, "maxLength": 120 }, "province": { "type": "string", "minLength": 1, "maxLength": 80 }, "postal_code": { "type": "string", "minLength": 1, "maxLength": 32 }, "country": { "type": "string", "pattern": "^[A-Za-z]{2}$", "minLength": 2, "maxLength": 2 } } } } } } } }