{"uid":"cap_l04BngKY7hUGklQhicN_j","slug":"x402-mpp-session-plan-9d228c57","name":"x402 MPP Session Plan","description":"24 paid x402 infrastructure APIs for AI agent fleets: buy advisor, audition coach, guard, proxy, MPP, attestations, and pipeline orchestration.","url":"https://x402-agent-suite-production.up.railway.app/api/mpp/session-plan","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":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FnvPt8BRQzmN1YkZhhkx8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates and retrieves a Multi-Payment Protocol (MPP) session plan for AI agent fleets making batched x402 micropayments, returning session status, settlement estimates, and cost-saving recommendations.","exampleAgentPrompt":"Set up an MPP session plan for my AI agent using x402 — it's making GET requests and I want to know the estimated USDC cost, session ID, settlement details, and any savings recommendations before it starts calling paid APIs.","exampleUseCases":[{"title":"Agent fleet payment batch planning","prompt":"My agent fleet is about to make a bunch of x402 API calls using GET requests — can you create an MPP session plan so I can see the estimated total USDC cost, how many calls are planned, and what the recommended settlement approach is?"},{"title":"Cost optimization before API run","prompt":"Before my AI agent starts hitting paid x402 endpoints, set up an MPP session plan and tell me if there's a cheaper way to batch the payments — I want the savings note and confidence score too."},{"title":"Session status and next steps check","prompt":"Can you pull up the current MPP session plan for my agent, including the session status, how many calls have been used versus expected, and what next steps x402 recommends for settlement?"}],"resultDescription":"Returns a JSON object with a boolean success indicator, a session object (session ID, status, chain, agent ID, expected calls, calls used, average price per call in USDC), a settlement object (network, chain, calls settled, planned calls, estimated total USDC, facilitator URL), a facilitator reference with MPP docs, a human-readable recommendation and savings note, a confidence score, a list of checks passed, and suggested next steps.","failureModes":["Invalid or missing HTTP method enum value (only GET, HEAD, DELETE accepted) returns validation error","Missing required 'type' field in input causes 400-level rejection","Payment not completed via x402 protocol results in 402 Payment Required response","Session not found or expired returns error status in session object","Facilitator unreachable may result in degraded settlement estimates"],"whenToPreferThis":"Choose this endpoint when an AI agent or agent fleet needs to pre-plan and optimize a batch of x402 micropayment API calls — specifically for MPP (Multi-Payment Protocol) session orchestration. It is ideal when cost estimation, settlement planning, and savings recommendations are needed before executing many paid calls, rather than paying per-call without a session. Prefer this over single-call x402 endpoints when the agent expects to make multiple API calls within a session and wants to minimize overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:40:07.309Z","isFirstParty":false}