{"api_name":"Sponge Wallet","docs_url":"https://docs.paysponge.com/wallet/sdk","domain":"docs.paysponge.com","generated_at":"2026-10-25T23:19:34.507310+00:00","agent_readiness_score":65,"certification_level":"Agent-Compatible With Gaps","agent_commerce_score":35,"agent_commerce_level":"Agent Commerce Emerging","agent_commerce":{"generated_at":"2026-10-25T23:19:34.487234+00:00","agent_commerce_score":35,"agent_commerce_level":"Agent Commerce Emerging","payment_protocol_detected":true,"machine_payment_capable":false,"payment_interface_evidence":"static_documentation_only","payment_settlement_verified":false,"verified_unpaid_402_challenges":0,"detected_protocols":["x402","MCP"],"category_scores":{"mcp_support":10,"agent_identity_auth":5,"machine_payments":10,"machine_pricing":0,"budget_controls":0,"agent_rate_controls":0,"deterministic_errors":0,"auditability":0,"agent_security":5,"agent_observability":5},"strengths":["MCP support","Machine-native payments"],"gaps":["Machine-readable consumption pricing","Budget / spend controls","Agent rate and quota controls","Deterministic machine-readable errors","Auditability / receipts / traceability"],"matched_signals":{"mcp_support":{"score":10,"matched_terms":["mcp server","mcp url:","mcp tools","mcp"]},"agent_identity_auth":{"score":5,"matched_terms":["oauth","authorization"]},"machine_payments":{"score":10,"matched_terms":["x402","402 payment required","payment required"]},"machine_pricing":{"score":0,"matched_terms":[]},"budget_controls":{"score":0,"matched_terms":["spending limit","spend","limit"],"lexical_score_before_guardrails":10,"guardrail_note":"No affirmative agent/API-key spending cap in reviewed pages; keyword matches such as pagination 'limit' or 'spend' warnings do not establish budget controls."},"agent_rate_controls":{"score":0,"matched_terms":["limits"]},"deterministic_errors":{"score":0,"matched_terms":["retry"]},"auditability":{"score":0,"matched_terms":["history"]},"agent_security":{"score":5,"matched_terms":["security","permissions"]},"agent_observability":{"score":5,"matched_terms":["usage","dashboard"]}},"evidence_signals":{"mcp_support":[{"source_url":"https://docs.paysponge.com/wallet/sdk","matched_terms":["mcp"],"snippet":"n npm install @paysponge/sdk pip install paysponge Connect a wallet Use an agent key for wallet actions: balances, transfers, swaps, payments, cards, MCP, and trading tools. TypeScript Python import from \"@paysponge/sdk\" ; // Connect as one agent with its scoped API key. const wallet = await SpongeWallet . connect (..."},{"source_url":"https://docs.paysponge.com/wallet/mcp","matched_terms":["mcp server","mcp url:","mcp tools","mcp"],"snippet":"let tools to an agent framework through MCP. Copy page Copy page Sign up at wallet.paysponge.com to set up your wallet first. Then connect the Sponge MCP server to your agent framework. Connect an MCP client Use an agent API key ( sponge_live_... ) for CLI-based clients. For app connectors that support OAuth, connect..."}],"agent_identity_auth":[{"source_url":"https://docs.paysponge.com/wallet/authentication","matched_terms":["oauth"],"snippet":"page Copy page Auth methods The SDK supports three ways to authenticate: 1. Device flow (interactive) On first use, SpongeWallet.connect() starts the OAuth Device Flow: 1 SDK requests a device code A code like ABCD-1234 is displayed in your terminal and copied to clipboard. 2 Browser opens You’re taken to the approval..."},{"source_url":"https://docs.paysponge.com/wallet/mcp","matched_terms":["oauth","authorization"],"snippet":"server to your agent framework. Connect an MCP client Use an agent API key ( sponge_live_... ) for CLI-based clients. For app connectors that support OAuth, connect the remote MCP URL and authorize in the browser. MCP URL: https://api.wallet.paysponge.com/mcp Trading-only MCP URL:..."}],"machine_payments":[{"source_url":"https://docs.paysponge.com/wallet/sdk","matched_terms":["x402"],"snippet":"aps, and transaction history Platform SDK : agent management, master keys, spending limits, and bank accounts Payments and cards SDK : paid requests, x402, MPP, Link, virtual cards, and Sponge Card SDK tools and helpers : MCP config, direct tools, HttpClient , and PublicToolsApi TypeScript examples and Python examples..."},{"source_url":"https://docs.paysponge.com/api-reference/public-openapi.json","matched_terms":["x402"],"snippet":"sactionsBridge\", \"tags\": [ \"Transfers\" ], \"summary\": \"Bridge across chains\", \"description\": \"Bridge across chains via POST.\", \"responses\": } }, \"/api/x402/fetch\": { \"post\": { \"requestBody\": { \"required\": true, \"content\": { \"application/json\": { \"schema\": { \"type\": \"object\", \"required\": [ \"url\" ], \"properties\": {..."}],"agent_security":[{"source_url":"https://docs.paysponge.com/wallet/authentication","matched_terms":["permissions"],"snippet":"key User-level, can create agents API Credential storage After device flow auth, credentials are saved to ~/.spongewallet/credentials.json with 0600 permissions (owner read/write only). Managing credentials Credential helper functions are currently TypeScript-only. import from \"@paysponge/sdk\" ; // Check if (..."},{"source_url":"https://docs.paysponge.com/api-reference/public-openapi.json","matched_terms":["security"],"snippet":"e\": \"object\", \"required\": [ \"amount\" ], \"properties\": }, \"AgentKeyRequest\": { \"type\": \"object\", \"required\": [ \"service\", \"key\" ], \"properties\": } }, \"securitySchemes\": }, \"security\": [ ], \"paths\": { \"/api/agents/me\": { \"get\": { \"operationId\": \"getApiAgentsMe\", \"tags\": [ \"Agents\" ], \"summary\": \"Get current agent\",..."}],"agent_observability":[{"source_url":"https://docs.paysponge.com/api-reference/public-openapi.json","matched_terms":["usage","dashboard"],"snippet":"e\": , \"merchant_url\": , \"merchant_country_code\": , \"description\": , \"products\": , \"shipping_address\": , \"enrollment_id\": , \"agentId\": } }, \"ReportCardUsageRequest\": { \"type\": \"object\", \"required\": [ \"payment_method_id\", \"status\" ], \"properties\": }, \"SpongeCardOnboardRequest\": { \"type\": \"object\", \"properties\": },..."}]},"category_review_notes":{"budget_controls":"No affirmative agent/API-key spending cap in reviewed pages; keyword matches such as pagination 'limit' or 'spend' warnings do not establish budget controls."},"claim_limitations":[],"scoring_signals":{"docs_fetched":true,"pages_fetched":6,"candidate_pages":6,"fetched_urls":["https://docs.paysponge.com/wallet/authentication","https://docs.paysponge.com/wallet/sdk","https://docs.paysponge.com/api-reference/public-openapi.json","https://docs.paysponge.com/wallet/mcp","https://docs.paysponge.com/wallet/x402-payments","https://docs.paysponge.com/api-reference/agents/get-current-agent"],"scoring_source":"YoofoozBot bounded crawl"},"methodology":{"separate_from_agent_readiness":true,"category_count":10,"category_scale":[0,5,10],"max_score":100,"evidence_required_for_public_claims":true}},"category_scores":{"documentation_clarity":10,"machine_readable_spec":10,"authentication_clarity":10,"error_handling":10,"rate_limit_clarity":0,"agent_safe_workflow_support":0,"sandbox_availability":10,"webhook_event_support":0,"commercial_trust":5,"developer_experience":10},"strengths":["Documentation clarity","Machine-readable specification (OpenAPI/GraphQL/etc.)","Authentication model clarity","Error handling and status codes","Sandbox / test-mode availability","Developer experience (SDKs, quickstart, CLI)"],"risks":["Rate-limit / quota behavior signal not detected in docs.","Agent-safe workflow primitives (idempotency, retries) signal not detected in docs.","Webhook / event support signal not detected in docs.","Commercial trust (status, SLA, compliance) signal is partial; clearer documentation recommended."],"recommended_next_steps":["Document rate limits, quota behavior, 429 responses, and Retry-After guidance.","Document idempotency keys, test mode, dry runs, and safe retry semantics for agents.","Expose webhook/event docs including event types, signature verification, and retry delivery.","Strengthen: Publish status page, SLA, and security/compliance posture (SOC 2, GDPR, PCI as applicable)."],"scoring_signals":{"docs_fetched":true,"docs_chars_used":32896,"pages_fetched":6,"candidate_pages":6,"fetched_urls":["https://docs.paysponge.com/wallet/authentication","https://docs.paysponge.com/wallet/sdk","https://docs.paysponge.com/api-reference/public-openapi.json","https://docs.paysponge.com/wallet/mcp","https://docs.paysponge.com/wallet/x402-payments","https://docs.paysponge.com/api-reference/agents/get-current-agent"],"scoring_source":"yoofoozbot_crawl_documents"},"matched_signals":{"documentation_clarity":{"score":10,"matched_terms":["parameters","request","response","examples","docs","reference"]},"machine_readable_spec":{"score":10,"matched_terms":["openapi","endpoints","schema"]},"authentication_clarity":{"score":10,"matched_terms":["oauth","authentication","authorization","api key","keys"]},"error_handling":{"score":10,"matched_terms":["400","retry"]},"rate_limit_clarity":{"score":0,"matched_terms":["limits"]},"agent_safe_workflow_support":{"score":0,"matched_terms":[]},"sandbox_availability":{"score":10,"matched_terms":["test keys"]},"webhook_event_support":{"score":0,"matched_terms":[]},"commercial_trust":{"score":5,"matched_terms":["support","security"]},"developer_experience":{"score":10,"matched_terms":["sdk","cli","dashboard"]}},"evidence_signals":{"documentation_clarity":[{"source_url":"https://docs.paysponge.com/api-reference/public-openapi.json","matched_terms":["parameters","request","response"],"snippet":"{ \"openapi\": \"3.0.3\", \"info\": , \"servers\": [ ], \"components\": { \"schemas\": { \"cardbillingaddress\": , \"cardshippingaddress\": , \"storecreditcardrequest\": , \"linkaddress\": , \"linkpaymentmethodrequest\": , \"linkpaymentcredentialrequest\": , \"getcardrequest\": , \"productlineitem\": ,..."},{"source_url":"https://docs.paysponge.com/wallet/sdk","matched_terms":["request","examples"],"snippet":"...swaps, and transaction history platform sdk : agent management, master keys, spending limits, and bank accounts payments and cards sdk : paid requests, x402, mpp, link, virtual cards, and sponge card sdk tools and helpers : mcp config, direct tools, httpclient , and publictoolsapi typescript..."}],"machine_readable_spec":[{"source_url":"https://docs.paysponge.com/api-reference/public-openapi.json","matched_terms":["openapi","schema"],"snippet":"{ \"openapi\": \"3.0.3\", \"info\": , \"servers\": [ ], \"components\": { \"schemas\": { \"cardbillingaddress\": , \"cardshippingaddress\": , \"storecreditcardrequest\": ,..."},{"source_url":"https://docs.paysponge.com/wallet/x402-payments","matched_terms":["endpoints"],"snippet":"pay x402 endpoints from an agent wallet. copy page copy page use x402 for http endpoints that return 402 payment required and accept a signed payment on retry. sdk..."}],"authentication_clarity":[{"source_url":"https://docs.paysponge.com/wallet/mcp","matched_terms":["oauth","authentication","authorization","api key","keys"],"snippet":"...to your agent framework. connect an mcp client use an agent api key ( sponge_live_... ) for cli-based clients. for app connectors that support oauth, connect the remote mcp url and authorize in the browser. mcp url: https://api.wallet.paysponge.com/mcp trading-only mcp url:..."},{"source_url":"https://docs.paysponge.com/wallet/authentication","matched_terms":["oauth","api key","keys"],"snippet":"...copy page auth methods the sdk supports three ways to authenticate: 1. device flow (interactive) on first use, spongewallet.connect() starts the oauth device flow: 1 sdk requests a device code a code like abcd-1234 is displayed in your terminal and copied to clipboard. 2 browser opens you’re taken..."}],"error_handling":[{"source_url":"https://docs.paysponge.com/wallet/mcp","matched_terms":["400"],"snippet":"...) mcp = wallet.mcp() print (mcp.url) print (mcp.headers) <div class=\"size-6 rounded-md flex items-center justify-center shadow-xs text-gray-400 dark:text-white/50 dark:bg-background-dark dark:brightness-[1.35] dark:ring-1 dark :brightness-150 bg-white ring-1 ring-gray-400/30..."},{"source_url":"https://docs.paysponge.com/wallet/x402-payments","matched_terms":["retry"],"snippet":"...x402 endpoints from an agent wallet. copy page copy page use x402 for http endpoints that return 402 payment required and accept a signed payment on retry. sdk typescript python import from \"@paysponge/sdk\" ; // connect as the paying agent. const wallet = await spongewallet . connect ( ); // fetch the..."}],"rate_limit_clarity":[{"source_url":"https://docs.paysponge.com/wallet/sdk","matched_terms":["limits"],"snippet":"...common next steps wallet sdk : addresses, balances, transfers, swaps, and transaction history platform sdk : agent management, master keys, spending limits, and bank accounts payments and cards sdk : paid requests, x402, mpp, link, virtual cards, and sponge card sdk tools and helpers : mcp config,..."}],"sandbox_availability":[{"source_url":"https://docs.paysponge.com/wallet/mcp","matched_terms":["test keys"],"snippet":"...server exposes get_balance , render_portfolio_ui , render_trade_ui , transfer , bridge , create_crypto_onramp , and a read-only hyperliquid . test keys hide create_crypto_onramp because crypto onramp links are mainnet-only. claude code run this command in your terminal: claude mcp add -s user http..."}],"commercial_trust":[{"source_url":"https://docs.paysponge.com/api-reference/public-openapi.json","matched_terms":["support","security"],"snippet":"{ \"openapi\": \"3.0.3\", \"info\": , \"servers\": [ ], \"components\": { \"schemas\": { \"cardbillingaddress\": , \"cardshippingaddress\": , \"storecreditcardrequest\": , \"linkaddress\": , \"linkpaymentmethodrequest\": , \"linkpaymentcredentialrequest\": , \"getcardrequest\": , \"productlineitem\": , \"virtualcardshippingaddr..."},{"source_url":"https://docs.paysponge.com/wallet/authentication","matched_terms":["support"],"snippet":"device flow, api keys, master keys, and credential storage. copy page copy page auth methods the sdk supports three ways to authenticate: 1. device flow (interactive) on first use, spongewallet.connect() starts the oauth device flow: 1 sdk requests a device..."}],"developer_experience":[{"source_url":"https://docs.paysponge.com/wallet/authentication","matched_terms":["sdk","cli"],"snippet":"device flow, api keys, master keys, and credential storage. copy page copy page auth methods the sdk supports three ways to authenticate: 1. device flow (interactive) on first use, spongewallet.connect() starts the oauth device flow: 1 sdk requests..."},{"source_url":"https://docs.paysponge.com/wallet/sdk","matched_terms":["sdk","cli"],"snippet":"build with @paysponge/sdk and paysponge. copy page copy page install the sdk, connect a wallet, and call the methods you need. install typescript python npm install..."}]},"evidence_quality":{"raw_pages_fetched":6,"scoring_pages":6,"index_pages_excluded":[],"protocol_responses_excluded":[],"html_navigation_trimmed":["https://docs.paysponge.com/wallet/authentication","https://docs.paysponge.com/wallet/sdk","https://docs.paysponge.com/wallet/mcp","https://docs.paysponge.com/wallet/x402-payments","https://docs.paysponge.com/api-reference/agents/get-current-agent"],"security_quarantined_pages_excluded":[],"security_quarantine_requires_review":false,"scoring_coverage_incomplete":false,"index_pages_are_discovery_only":true,"source_crawl_unchanged":true,"runtime_capabilities_not_tested":true,"no_trusted_documentation":false,"robots_access_deferred":false},"assessment_status":"documentation_only_preliminary","publication_eligible":true,"score_qualification":"Preliminary documentation-only scores; runtime not verified.","documentation_only":true,"runtime_capabilities_verified":false,"yoofoozbot":{"run_id":"20261025T231901Z_sponge_wallet_2c943429","user_agent":"YoofoozBot/1.12 (+https://yoofooz.com/yoofoozbot; contact: submit@yoofooz.com)","pages_fetched":6,"total_bytes":1232809,"robots_respected":true,"crawl_record_path":"outputs/yoofoozbot/20261025T231901Z_sponge_wallet_2c943429.json","spec_candidates":["https://docs.paysponge.com/api-reference/public-openapi.json"],"official_sibling_openapi_probes":[],"signal_summary":{"openapi":{"detected":true,"matched_terms":["openapi"]},"authentication":{"detected":true,"matched_terms":["authentication","oauth","api key"]},"errors":{"detected":true,"matched_terms":["retry"]},"rate_limits":{"detected":false,"matched_terms":[]},"webhooks":{"detected":false,"matched_terms":[]},"sandbox":{"detected":false,"matched_terms":[]},"agent_workflows":{"detected":true,"matched_terms":["mcp","agent"]},"developer_experience":{"detected":true,"matched_terms":["sdk","cli"]},"commercial_trust":{"detected":true,"matched_terms":["security"]},"mcp_support":{"detected":true,"matched_terms":["mcp server","mcp tools"]},"machine_payments":{"detected":true,"matched_terms":["x402","402 payment required"]},"machine_pricing":{"detected":false,"matched_terms":[]},"budget_controls":{"detected":true,"matched_terms":["spending limit"]},"agent_identity":{"detected":false,"matched_terms":[]},"auditability":{"detected":false,"matched_terms":[]},"agent_observability":{"detected":false,"matched_terms":[]}},"readiness_scoring_pages":6,"readiness_scoring_source":"yoofoozbot_crawl_documents","scoring_evidence_quality":{"raw_pages_fetched":6,"scoring_pages":6,"index_pages_excluded":[],"protocol_responses_excluded":[],"html_navigation_trimmed":["https://docs.paysponge.com/wallet/authentication","https://docs.paysponge.com/wallet/sdk","https://docs.paysponge.com/wallet/mcp","https://docs.paysponge.com/wallet/x402-payments","https://docs.paysponge.com/api-reference/agents/get-current-agent"],"security_quarantined_pages_excluded":[],"security_quarantine_requires_review":false,"scoring_coverage_incomplete":false,"index_pages_are_discovery_only":true,"source_crawl_unchanged":true,"runtime_capabilities_not_tested":true,"no_trusted_documentation":false,"robots_access_deferred":false},"agent_commerce_probe":{"score":35,"level":"Agent Commerce Emerging","machine_payment_capable":false,"payment_settlement_verified":false,"verified_unpaid_402_challenges":0,"detected_protocols":["x402","MCP"],"evidence_categories":["agent_identity_auth","agent_observability","agent_security","machine_payments","mcp_support"]}},"ai_analysis":{"provider":"nvidia","enabled":true,"model":"nvidia/nemotron-3.5-super-vl-120b-a12b","summary":"Sponge Wallet API is Agent-Compatible With Gaps at score 65, with strong documentation, specs, auth, errors, sandbox, and DX but missing rate-limit, idempotency, and webhook signals.","credibility_notes":["Agent readiness score: 65","Certification level: Agent-Compatible With Gaps","Partial commercial trust signal; clearer documentation recommended"],"next_actions":["Document rate limits, quota behavior, 429 responses, and Retry-After guidance.","Document idempotency keys, test mode, dry runs, and safe retry semantics for agents.","Expose webhook/event docs including event types, signature verification, and retry delivery."],"error":null}}