{"uid":"cap_bgGWmlUAztLwMhvYDJb-v","slug":"x402-agent-suite-mpp-session-create-retrieve-e84a1661","name":"x402-agent-suite MPP Session Create/Retrieve","description":"Creates or retrieves an MPP session after payment on Base or Solana.","url":"https://x402-agent-suite-production.up.railway.app/api/mpp/session?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","status","success","action","session","settlement","recommendation","facilitator","nextSteps","savingsNote","confidence","checks_passed"],"properties":{"ok":{"type":"boolean"},"action":{"type":"string"},"status":{"type":"string"},"session":{"type":"object","required":["sessionId","status","chain","agentId","expectedCalls","callsUsed","avgPricePerCallUsdc"],"properties":{"chain":{"type":"string"},"status":{"type":"string"},"agentId":{"type":"string"},"callsUsed":{"type":"number"},"sessionId":{"type":"string"},"expectedCalls":{"type":"number"},"avgPricePerCallUsdc":{"type":"number"}}},"success":{"type":"boolean"},"nextSteps":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number"},"settlement":{"type":"object","required":["status","sessionId","network","chain","agentId","callsSettled","plannedCalls","estimatedTotalUsdc","facilitatorUrl"],"properties":{"chain":{"type":"string"},"status":{"type":"string"},"agentId":{"type":"string"},"network":{"type":"string"},"sessionId":{"type":"string"},"callsSettled":{"type":"number"},"plannedCalls":{"type":"number"},"facilitatorUrl":{"type":"string"},"estimatedTotalUsdc":{"type":"number"}}},"facilitator":{"type":"object","required":["url","mppDocs"],"properties":{"url":{"type":"string"},"mppDocs":{"type":"string"}}},"savingsNote":{"type":"string"},"checks_passed":{"type":"array","items":{"type":"string"}},"recommendation":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"session":{"status":"open","sessionId":"mpp_example"}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"ok":true,"action":"open","status":"ok","session":{"chain":"solana","status":"open","agentId":"dexter-verifier-probe","openedAt":"2026-06-01T04:30:29.729Z","callsUsed":0,"sessionId":"mpp_942f78cea0ca","expectedCalls":25,"maxBudgetUsdc":0.75,"facilitatorUrl":"https://x402.dexter.cash","avgPricePerCallUsdc":0.03,"estimatedSavingsUsdc":0.715},"sources":["mpp-session-v2","dexter-facilitator"],"success":true,"nextSteps":["Point x402 client facilitatorUrl to https://x402.dexter.cash","Use network solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp for session channel","Call action:voucher before each API call in the session","Call action:close when batch completes"],"confidence":0.9,"facilitator":{"url":"https://x402.dexter.cash","mppDocs":"https://docs.dexter.cash/docs/mpp/"},"savingsNote":"Estimated savings $0.71 vs 25 per-call settlements","accuracy_note":"MPP session lifecycle planner; settlement happens client-side via facilitator.","checks_passed":["mpp_session","action_open","session_state"],"recommendation":"Use MPP session for this workload"}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jb3olL5EiQfqZx4KZ0a3e","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates or retrieves a Multi-Payment Protocol (MPP) session on Base or Solana after x402 micropayment, returning session state, settlement info, and next steps.","exampleAgentPrompt":"Start an MPP session for my agent on Base using x402 — I expect around 50 calls at roughly $0.03 USDC each, and I need the session ID and settlement details so I can track usage.","exampleUseCases":null,"resultDescription":"Returns a JSON object with ok/success flags, a session object (sessionId, status, chain, agentId, expectedCalls, callsUsed, avgPricePerCallUsdc), settlement details (network, callsSettled, plannedCalls, estimatedTotalUsdc, facilitatorUrl), facilitator info with MPP docs link, a confidence score, list of checks passed, a recommendation string, a savings note, and next steps as a string array.","failureModes":["Payment not received or insufficient — session not created, 402 response","Invalid HTTP method (only GET/HEAD/DELETE accepted for input.method) — validation error","Unsupported chain — session creation fails with chain error","Session not found on retrieval — returns not-found or empty session","Network timeout to Base/Solana RPC — settlement status unavailable"],"whenToPreferThis":"Use this endpoint when an AI agent needs to establish or resume a metered MPP session backed by x402 micropayments on Base or Solana, especially when you need session-level tracking of API call consumption, per-call USDC pricing, and settlement status. Prefer this over direct per-call payment when amortizing costs across many calls or when you need facilitator-backed session management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:36:56.743Z","isFirstParty":false,"canonicalSlug":"x402-agent-suite-mpp-session-create-retrieve-e84a1661"}