{"uid":"cap_YcZe5m52j9KiAunIOKNyh","slug":"samedaydesk-agent-surface-budget-audit-fc0f0d14","name":"SameDayDesk Agent Surface Budget Audit","description":"Deterministic agent APIs for web and company intelligence, repository security, agent-work economics, machine-service discoverability, payment preflight and settlement proof, wallet context, and Morpho decision evidence. Pay per call through Base x402 or native MPP, with a Circle Gateway Nanopayments path for gasless batched USDC.","url":"https://agents.samedaydesk.com/distribution/agent-surface-budget-audit","method":"GET","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"],"type":"string"},"queryParams":{"type":"object","required":["origin"],"properties":{"origin":{"type":"string","format":"uri","description":"Credential-free public HTTPS service origin on port 443."},"mcpPath":{"type":"string","default":"/mcp","pattern":"^/[^/?#{}][^?#{}]*$","description":"Exact root-relative MCP streamable-HTTP path."},"openApiPath":{"type":"string","default":"/openapi.json","pattern":"^/[^/?#{}][^?#{}]*$","description":"Exact root-relative OpenAPI JSON path."},"surfaceMode":{"enum":["mcp","openapi","both"],"type":"string","default":"both","description":"Audit MCP only, OpenAPI only, or both. Unselected surfaces are not fetched or judged."},"mcpBudgetBytes":{"type":"integer","default":65536,"maximum":1000000,"minimum":8192},"openApiBudgetBytes":{"type":"integer","default":524288,"maximum":1000000,"minimum":32768}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","product","version","checkedAt","decision","request","mcp","openapi","actions","boundary"],"properties":{"ok":{"type":"boolean"},"mcp":{"type":"object"},"actions":{"type":"array","items":{"type":"string"}},"openapi":{"type":"object"},"product":{"type":"string","const":"samedaydesk-agent-surface-budget-audit"},"request":{"type":"object"},"version":{"type":"string","const":"1.2.0"},"boundary":{"type":"object"},"decision":{"enum":["within_budget","optimize","surface_incomplete"],"type":"string"},"checkedAt":{"type":"string","format":"date-time"}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"ok":true,"mcp":{"bytes":90000,"server":{"name":"example","version":"1.0.0"},"available":true,"pageCount":1,"requested":true,"toolCount":20,"budgetBytes":65536,"withinBudget":false,"heaviestTools":[],"selectionBytes":87000,"protocolVersion":"2025-11-25","missingTitleCount":0,"missingDescriptionCount":0,"missingInputSchemaCount":0,"byteDerivedTokenEstimate":22500,"missingOutputSchemaCount":20},"actions":["Add progressive MCP tool discovery or split the server into task-focused tool sets so clients do not ingest the full catalog every turn."],"openapi":{"bytes":300000,"available":true,"requested":true,"budgetBytes":524288,"withinBudget":true,"operationCount":25,"heaviestOperations":[],"missingOperationIdCount":0,"byteDerivedTokenEstimate":75000},"product":"samedaydesk-agent-surface-budget-audit","request":{"origin":"https://agents.samedaydesk.com","mcpPath":"/mcp","openApiPath":"/openapi.json","surfaceMode":"both","mcpBudgetBytes":65536,"openApiBudgetBytes":524288},"version":"1.2.0","boundary":{"toolsCalled":false,"credentialsUsed":false,"schemasRetained":false,"redirectsFollowed":false,"targetPaymentSent":false,"targetPaymentSigned":false,"tokenEstimateMethod":"ceil(UTF-8 bytes / 4); comparative estimate, not tokenizer billing","responseBodiesReturned":false,"sessionIdentifiersReturned":false},"decision":"optimize","checkedAt":"2026-08-12T15:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_msiIb8ZhfiHu4NHPZA0mh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Audits an MCP server and/or OpenAPI surface to determine if its full schema fits within token/byte budgets an agent can afford to ingest per turn, and recommends optimization actions.","exampleAgentPrompt":"Can you audit my MCP server at /mcp and my OpenAPI spec at /openapi.json to see if they're both within token budget for agents, and tell me which tools are the heaviest and what I should do to optimize them?","exampleUseCases":[{"title":"MCP server token budget check","prompt":"My MCP server at /mcp has about 20 tools — can you check if the full catalog fits within the 65KB byte budget an agent can ingest per turn, and flag which tools are the heaviest?"},{"title":"OpenAPI spec size validation","prompt":"I have an OpenAPI spec at /openapi.json with around 25 operations — can you tell me if it's within the 512KB budget limit and how many tokens it would cost an agent to load?"},{"title":"Agent surface optimization advisory","prompt":"My agent service seems slow and expensive for clients to use — can you audit both my MCP and OpenAPI surfaces and give me concrete actions to make them more efficient for agents?"}],"resultDescription":"Returns a JSON object with byte sizes, token estimates, tool/operation counts, budget compliance flags, heaviest tools/operations, missing schema counts (titles, descriptions, input/output schemas), a 'decision' field (e.g. 'optimize'), and a list of actionable recommendations for improving the agent surface. Covers both MCP and OpenAPI surfaces independently with per-surface budget analysis.","failureModes":["MCP or OpenAPI path not reachable — returns available: false for that surface","Target surface exceeds budget — withinBudget: false with optimization actions returned","Invalid or missing path parameters — returns error response","Service temporarily unavailable — HTTP 5xx response"],"whenToPreferThis":"Use this endpoint when you need to programmatically assess whether an MCP server or OpenAPI surface is efficient enough for agents to consume without exceeding per-turn context budgets. It is specifically designed for agent infrastructure owners who want deterministic byte/token measurements and actionable optimization advice, rather than generic API linting tools.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:27.935Z","isFirstParty":false}