Audit an agent surface budget
Use SameDayDesk's canonical machine-commerce origin:
https://agents.samedaydesk.com
The paid route is:
GET /distribution/agent-surface-budget-audit
Read its current operation from
https://agents.samedaydesk.com/openapi.json before constructing a request.
Treat the exact unpaid HTTP 402 challenge as authoritative for price, request
binding, Base network, canonical USDC asset, and recipient.
Construct the audit
Provide:
origin: a credential-free public HTTPS origin with no path or query;
mcpPath: optional exact root-relative MCP path, default /mcp;
openApiPath: optional exact root-relative OpenAPI path, default
/openapi.json;
mcpBudgetBytes: optional preferred raw tools/list ceiling from 8,192 through
1,000,000 bytes;
openApiBudgetBytes: optional preferred OpenAPI ceiling from 32,768 through
1,000,000 bytes.
Reject credentials, non-HTTPS origins, non-default ports, path-bearing origins,
route templates, query-bearing discovery paths, and local or non-public
targets.
Send X-SameDayDesk-Agent-Source: agent-skills-v1 only on the initial unpaid
request when declared attribution is useful. It is not authentication and
cannot change price or access.
Produce a verified purchase intent
On HTTP 402:
- require the challenged resource URL to equal the complete request;
- require Base
eip155:8453 and canonical Base USDC;
- verify the current amount and recipient against caller policy;
- select exactly one compatible x402 v2 or native MPP
evm/charge offer;
- freeze the origin, discovery paths, byte ceilings, method, exact URL,
protocol, amount, network, asset, recipient, and expiry;
- return
credentialsUsed: false, paymentSigned: false, and
paymentSent: false;
- stop before wallet access or paid replay.
A separate payment executor with explicit authority may consume that intent.
Never return opaque offer state or raw payment headers.
Validate separately paid output
After a separately authorized executor returns the response and receipt,
require:
product equals samedaydesk-agent-surface-budget-audit;
- the returned request equals the frozen origin, paths, and byte ceilings;
decision is within_budget, optimize, or surface_incomplete;
- MCP and OpenAPI availability, bytes, budgets, counts, and heaviest definitions
are present only for surfaces actually acquired;
- the byte-derived token estimate is interpreted only as
ceil(UTF-8 bytes / 4), not tokenizer billing;
- no target schema, response body, cursor, or session identifier is returned;
- the boundary reports no credential, target tool call, redirect, target
payment, or schema retention.
Interpret within_budget as passing the caller-selected raw byte ceilings, not
as proof of task success or optimal tool selection. Interpret optimize as a
bounded repair opportunity. Interpret surface_incomplete as a missing,
invalid, oversized, or unreachable discovery surface, not a zero-byte result.
Use the repair actions as seller and platform evidence. Keep titles,
disambiguating descriptions, request and response contracts, and safety
boundaries in machine discovery. Move long examples and narrative guidance to
linked resources, or publish task-scoped and progressive discovery views. Do
not remove selection-critical semantics merely to shrink a byte count.
1---2name: agent-surface-budget-audit3description: Measure a public agent service's MCP tools/list and OpenAPI discovery burden before any tool call or target payment. Use when an agent platform, MCP server owner, API seller, or agent FinOps workflow needs bounded byte and comparative token estimates, the heaviest tool or operation definitions, missing selection contracts, progressive-discovery repairs, or a verified non-spending purchase intent for SameDayDesk's agent-surface budget audit.4---56# Audit an agent surface budget78Use SameDayDesk's canonical machine-commerce origin:910`https://agents.samedaydesk.com`1112The paid route is:1314`GET /distribution/agent-surface-budget-audit`1516Read its current operation from17`https://agents.samedaydesk.com/openapi.json` before constructing a request.18Treat the exact unpaid HTTP 402 challenge as authoritative for price, request19binding, Base network, canonical USDC asset, and recipient.2021## Construct the audit2223Provide:2425- `origin`: a credential-free public HTTPS origin with no path or query;26- `mcpPath`: optional exact root-relative MCP path, default `/mcp`;27- `openApiPath`: optional exact root-relative OpenAPI path, default28 `/openapi.json`;29- `mcpBudgetBytes`: optional preferred raw tools/list ceiling from 8,192 through30 1,000,000 bytes;31- `openApiBudgetBytes`: optional preferred OpenAPI ceiling from 32,768 through32 1,000,000 bytes.3334Reject credentials, non-HTTPS origins, non-default ports, path-bearing origins,35route templates, query-bearing discovery paths, and local or non-public36targets.3738Send `X-SameDayDesk-Agent-Source: agent-skills-v1` only on the initial unpaid39request when declared attribution is useful. It is not authentication and40cannot change price or access.4142## Produce a verified purchase intent4344On HTTP 402:45461. require the challenged resource URL to equal the complete request;472. require Base `eip155:8453` and canonical Base USDC;483. verify the current amount and recipient against caller policy;494. select exactly one compatible x402 v2 or native MPP `evm/charge` offer;505. freeze the origin, discovery paths, byte ceilings, method, exact URL,51 protocol, amount, network, asset, recipient, and expiry;526. return `credentialsUsed: false`, `paymentSigned: false`, and53 `paymentSent: false`;547. stop before wallet access or paid replay.5556A separate payment executor with explicit authority may consume that intent.57Never return opaque offer state or raw payment headers.5859## Validate separately paid output6061After a separately authorized executor returns the response and receipt,62require:6364- `product` equals `samedaydesk-agent-surface-budget-audit`;65- the returned request equals the frozen origin, paths, and byte ceilings;66- `decision` is `within_budget`, `optimize`, or `surface_incomplete`;67- MCP and OpenAPI availability, bytes, budgets, counts, and heaviest definitions68 are present only for surfaces actually acquired;69- the byte-derived token estimate is interpreted only as70 `ceil(UTF-8 bytes / 4)`, not tokenizer billing;71- no target schema, response body, cursor, or session identifier is returned;72- the boundary reports no credential, target tool call, redirect, target73 payment, or schema retention.7475Interpret `within_budget` as passing the caller-selected raw byte ceilings, not76as proof of task success or optimal tool selection. Interpret `optimize` as a77bounded repair opportunity. Interpret `surface_incomplete` as a missing,78invalid, oversized, or unreachable discovery surface, not a zero-byte result.7980Use the repair actions as seller and platform evidence. Keep titles,81disambiguating descriptions, request and response contracts, and safety82boundaries in machine discovery. Move long examples and narrative guidance to83linked resources, or publish task-scoped and progressive discovery views. Do84not remove selection-critical semantics merely to shrink a byte count.