SameDayDesk Machine Commerce MCP
An MCP server providing agent tools for discovery, payment safety, data extraction, and DeFi. It offers endpoints for extracting web content, scanning GitHub repos for security, generating JSON-LD, enriching company and wallet data, and auditing AI-search readiness, all settled via x402 payments on Base.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
No account or subscription is required
MCP endpoint (Streamable HTTP)
https://agents.samedaydesk.com/mcpWhat its tools do
30 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Can change data (1)
Not annotated (29)
careers_boardextractextract_batchlockfile_pin_deltareadscanschemaforgeenrichwallet_enrichdeep_auditmorpho_positionmorpho_protectionmorpho_market_underwritemorpho_preliquidation_replayopportunity_preflightagent_discoverability_auditpayment_offer_preflightseller_integrity_auditcontract_qualified_searchagent_surface_budget_auditsettlement_prooftransaction_receiptsolana_transaction_receiptwallet_policy_conformancestateful_wallet_policy_conformancepage_changecareers_board_coldreport_caller_resultrecover_paid_result
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Extract public HTTP(S) pages into structured JSON
- Scan GitHub repositories for supply-chain security risks
- Generate JSON-LD structured data for business sites
- Enrich domain or wallet addresses with agent-ready intelligence
Source and maintenance
Community listingRegistry 1.23.55
- Maintenance checked
Protocol and capabilities
- Server
- x402-data-gateway 1.23.55
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 30 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
}
}Tools
30 advertised
careers_board — Read Named Public Careers Board
Read one configured public careers board and return title, location or null, posting URL, source, fetchedAt, and explicit coverage. Use `careers_board_cold` for the acquired free recipe. Partial, missing, duplicate, listed, empty, and changed stay explicit. A source failure is unavailable and is not an empty board. Price is $0.005 USDC. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/data/careers-board, not mcp://. Retry the identical authorized arguments and credential.
careers_board input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"board"
],
"properties": {
"board": {
"type": "string",
"description": "Named board id or alias. Initial reference ids are acxiom and liveramp."
},
"company": {
"type": "string",
"description": "Optional alias. When board is also set, both must resolve to the same id."
}
},
"additionalProperties": false
}careers_board output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"product",
"charged",
"board",
"outcome",
"rows",
"coverage",
"source",
"fetchedAt",
"roleFilter"
],
"properties": {
"ok": {
"type": "boolean"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"location",
"url",
"source",
"fetchedAt"
],
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": "string"
}
},
"additionalProperties": true
}
},
"board": {
"type": "string"
},
"source": {
"type": "object",
"additionalProperties": {}
},
"charged": {
"type": "boolean"
},
"outcome": {
"type": "string"
},
"product": {
"type": "string"
},
"coverage": {
"type": "object",
"additionalProperties": {}
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"roleFilter": {
"type": "null"
}
},
"additionalProperties": true
}extract — Extract Web Page as Structured JSON
Fetch a public HTTP(S) page and return compact extraction signals for programmatic inspection: title, meta description, Open Graph/Twitter metadata, JSON-LD, headings, links, text excerpt, and AI-readiness flags. Use `read` instead when you need the page body as LLM-ready Markdown rather than metadata or a link inventory. Does not execute JavaScript; follows redirects and applies SSRF, timeout, and response-size guards. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/extract, not mcp://. Retry the identical authorized arguments and credential.
extract input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Public HTTP(S) URL. Choose extract for metadata, JSON-LD, headings, links, and a bounded text excerpt; use read for longer bounded Markdown. Content is fetched without JavaScript rendering. Check status/sourceOk/error/capture; ok means a typed extract record, not source completeness."
},
"textExcerptLimitChars": {
"type": "integer",
"maximum": 40000,
"minimum": 1,
"description": "Optional excerpt budget. Default 1200. Maximum 40000. Rejected before fetch. Does not purchase /read or change the price."
}
},
"additionalProperties": false
}extract output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"requestedUrl",
"finalUrl",
"url",
"status",
"sourceOk",
"error",
"contentType",
"title",
"description",
"canonical",
"lang",
"openGraph",
"twitter",
"jsonLd",
"headings",
"links",
"text",
"aiReadiness",
"capture",
"fetchedAt"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"url": {
"type": "string"
},
"lang": {
"type": [
"string",
"null"
]
},
"text": {
"type": "string"
},
"error": {
"anyOf": [
{
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"links": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"jsonLd": {
"type": "array",
"items": {}
},
"status": {
"type": "integer"
},
"capture": {
"type": "object",
"required": [
"method",
"javascriptExecuted",
"maxBodyBytes",
"textExcerptLimitChars",
"markdownLimitChars",
"bodyBytes",
"bodyTruncated",
"textTruncated",
"charset",
"charsetSource"
],
"properties": {
"method": {
"type": "string",
"const": "http-get-no-javascript"
},
"charset": {
"type": [
"string",
"null"
]
},
"bodyBytes": {
"type": "integer",
"minimum": 0
},
"maxBodyBytes": {
"type": "integer"
},
"bodyTruncated": {
"type": "boolean"
},
"charsetSource": {
"enum": [
"content-type",
"html-meta",
"default-utf-8",
"invalid-charset-fallback"
],
"type": "string"
},
"textTruncated": {
"type": "boolean"
},
"javascriptExecuted": {
"type": "boolean",
"const": false
},
"markdownLimitChars": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"textExcerptLimitChars": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"twitter": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"finalUrl": {
"type": "string"
},
"headings": {
"type": "object",
"required": [
"h1",
"h2"
],
"properties": {
"h1": {
"type": "array",
"items": {
"type": "string"
}
},
"h2": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"sourceOk": {
"type": "boolean"
},
"canonical": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": "string",
"format": "date-time"
},
"openGraph": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"aiReadiness": {
"type": "object",
"required": [
"hasJsonLd",
"hasOpenGraph",
"hasTitle",
"hasDescription",
"hasCanonical",
"schemaTypes"
],
"properties": {
"hasTitle": {
"type": "boolean"
},
"hasJsonLd": {
"type": "boolean"
},
"schemaTypes": {
"type": "array",
"items": {}
},
"hasCanonical": {
"type": "boolean"
},
"hasOpenGraph": {
"type": "boolean"
},
"hasDescription": {
"type": "boolean"
}
},
"additionalProperties": false
},
"contentType": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"requestedUrl": {
"type": "string"
}
},
"additionalProperties": false
}extract_batch — Extract Public URLs in Batch
Fetch one to five public HTTPS URLs and return bounded structured fields for each source in one paid attempt. Supply `urls` as a JSON array and optional unique `fields`. Use `extract` for a single URL when you do not need batch accounting. Charge is one flat introductory 0.01 USDC quote for the bounded attempt, not a guarantee that every URL succeeds. Automatic retries are disabled; unknown outcomes must not be re-paid automatically. Payment challenge and credentials are bound to POST https://agents.samedaydesk.com/extract/batch, not mcp://. Retry the identical authorized arguments and credential.
extract_batch input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"urls"
],
"properties": {
"urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"maxItems": 5,
"minItems": 1,
"description": "One to five public HTTPS URLs as a JSON array. Charge is one flat introductory attempt, not per-URL success."
},
"fields": {
"type": "array",
"items": {
"enum": [
"title",
"description",
"canonical",
"lang",
"openGraph",
"twitter",
"jsonLd",
"headings",
"links",
"text",
"aiReadiness"
],
"type": "string"
},
"maxItems": 11,
"minItems": 1,
"description": "Optional unique bounded subset of structured extraction fields."
},
"textExcerptLimitChars": {
"type": "integer",
"maximum": 40000,
"minimum": 1,
"description": "Optional per-item excerpt budget. Omitted requests keep 1200. A value that cannot fit the batch response ceiling is rejected before fetch. Does not change the price."
}
},
"additionalProperties": false
}extract_batch output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"product",
"schemaVersion",
"quote",
"jobId",
"jobStatus",
"stopReason",
"partial",
"sources",
"accounting",
"costInputs",
"charged",
"boundary"
],
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "string"
},
"jobId": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"quote": {
"type": "object",
"required": [
"amountAtomic",
"displayUsdc",
"meaning"
],
"properties": {
"meaning": {
"type": "string"
},
"displayUsdc": {
"type": "string",
"const": "0.01"
},
"amountAtomic": {
"type": "string",
"const": "10000"
}
},
"additionalProperties": false
},
"charged": {
"type": "boolean"
},
"partial": {
"type": "boolean"
},
"product": {
"type": "string",
"const": "samedaydesk-extract-batch"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source",
"status",
"data",
"notes",
"error",
"provenance"
],
"properties": {
"id": {
"type": "string"
},
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"error": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"notes": {
"type": "array"
},
"source": {
"type": "string"
},
"status": {
"enum": [
"pending",
"success",
"partial",
"failure",
"unknown",
"skipped_duplicate"
],
"type": "string"
},
"finalUrl": {
"type": [
"string",
"null"
]
},
"httpStatus": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"provenance": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"additionalProperties": true
},
"maxItems": 5,
"minItems": 1
},
"boundary": {
"type": "object",
"additionalProperties": {}
},
"jobStatus": {
"enum": [
"running",
"completed",
"completed_with_unknown",
"stopped",
"interrupted"
],
"type": "string"
},
"accounting": {
"type": "object",
"additionalProperties": {}
},
"costInputs": {
"type": "object",
"additionalProperties": {}
},
"stopReason": {
"type": [
"string",
"null"
]
},
"schemaVersion": {
"type": "string",
"const": "samedaydesk.extract-batch.v0"
}
},
"additionalProperties": false
}lockfile_pin_delta — Inspect Lockfile Pin Delta
Inspect two caller-supplied npm package-lock.json objects and return added, removed, and changed name+version+integrity+resolved pins. Supply JSON `before` and `after` lockfile objects, not filesystem paths, URLs, or commands. An identical pin set is informational, not a failure. HTML, package.json, and unsupported lockfileVersion values are refused before payment. This is not an npm install, audit, or purchase. Ordinary wallets sign through examples/customer-x402 (inspect, explicit approve, attempt-receipt, read-only reconcile), not a precomputed signature. Initial live release accepts x402 only. Payment challenge and credentials are bound to POST https://agents.samedaydesk.com/lockfile-pin-delta, not mcp://. Retry the identical authorized arguments and credential.
lockfile_pin_delta input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"before",
"after"
],
"properties": {
"after": {
"type": "object",
"description": "npm package-lock.json object (lockfileVersion 2 or 3). Not a filesystem path, URL, or command.",
"additionalProperties": {}
},
"before": {
"type": "object",
"description": "npm package-lock.json object (lockfileVersion 2 or 3). Not a filesystem path, URL, or command.",
"additionalProperties": {}
}
},
"additionalProperties": false
}lockfile_pin_delta output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"product",
"schemaVersion",
"quote",
"charged",
"analysis",
"transport",
"engine",
"digest",
"engineProvenance",
"costInputs",
"boundary",
"limits"
],
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "string"
},
"quote": {
"type": "object",
"required": [
"amountAtomic",
"displayUsdc",
"meaning"
],
"properties": {
"meaning": {
"type": "string"
},
"displayUsdc": {
"type": "string"
},
"amountAtomic": {
"type": "string"
}
},
"additionalProperties": false
},
"digest": {
"type": [
"string",
"null"
]
},
"engine": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"limits": {
"type": "object",
"additionalProperties": {}
},
"charged": {
"type": "boolean"
},
"product": {
"type": "string",
"const": "samedaydesk-lockfile-pin-delta"
},
"analysis": {
"enum": [
"actionable",
"informational",
"partial",
"not-run"
],
"type": "string"
},
"boundary": {
"type": "object",
"additionalProperties": {}
},
"markdown": {
"type": [
"string",
"null"
]
},
"transport": {
"enum": [
"ok",
"timeout",
"engine-crash",
"internal-error",
"rejected"
],
"type": "string"
},
"costInputs": {
"type": "object",
"additionalProperties": {}
},
"owedDelivery": {
"type": "boolean"
},
"schemaVersion": {
"type": "string",
"const": "samedaydesk.lockfile-pin-delta-http.v0"
},
"markdownOmitted": {
"type": "boolean"
},
"engineProvenance": {
"type": "object",
"additionalProperties": {}
}
},
"additionalProperties": false
}read — Read Web Page as Markdown
Fetch a public HTTP(S) page and return its readable body as cleaned Markdown for LLM context, preserving headings, links, and lists while dropping navigation, ads, scripts, headers, footers, asides, and forms. Use `extract` instead when you need metadata, JSON-LD, Open Graph/Twitter tags, or a link inventory. Markdown is capped at 40,000 characters and no JavaScript is executed. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/read, not mcp://. Retry the identical authorized arguments and credential.
read input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Public HTTP(S) URL whose readable body is needed as Markdown. Content is fetched without JavaScript rendering and may be truncated at 40,000 characters. Check status/sourceOk/error/truncated/capture; missing discussion text is not proof of absence."
}
},
"additionalProperties": false
}read output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"requestedUrl",
"finalUrl",
"url",
"status",
"sourceOk",
"error",
"title",
"markdown",
"wordCount",
"truncated",
"capture",
"fetchedAt"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"url": {
"type": "string"
},
"error": {
"anyOf": [
{
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"status": {
"type": "integer"
},
"capture": {
"type": "object",
"required": [
"method",
"javascriptExecuted",
"maxBodyBytes",
"textExcerptLimitChars",
"markdownLimitChars",
"bodyBytes",
"bodyTruncated",
"textTruncated",
"charset",
"charsetSource"
],
"properties": {
"method": {
"type": "string",
"const": "http-get-no-javascript"
},
"charset": {
"type": [
"string",
"null"
]
},
"bodyBytes": {
"type": "integer",
"minimum": 0
},
"maxBodyBytes": {
"type": "integer"
},
"bodyTruncated": {
"type": "boolean"
},
"charsetSource": {
"enum": [
"content-type",
"html-meta",
"default-utf-8",
"invalid-charset-fallback"
],
"type": "string"
},
"textTruncated": {
"type": "boolean"
},
"javascriptExecuted": {
"type": "boolean",
"const": false
},
"markdownLimitChars": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"textExcerptLimitChars": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"finalUrl": {
"type": "string"
},
"markdown": {
"type": "string"
},
"sourceOk": {
"type": "boolean"
},
"fetchedAt": {
"type": "string",
"format": "date-time"
},
"truncated": {
"type": "boolean"
},
"wordCount": {
"type": "integer",
"minimum": 0
},
"requestedUrl": {
"type": "string"
}
},
"additionalProperties": false
}scan — Scan GitHub Repository Before Install
Static supply-chain security scan of a public GitHub repo before an agent installs/runs it. Flags exfil sinks, obfuscation, credential reads, install-time curl|bash. risk=clean|suspicious|dangerous. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/scan, not mcp://. Retry the identical authorized arguments and credential.
scan input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Public GitHub repo: owner/name or URL"
}
},
"additionalProperties": false
}scan output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"repo",
"branch",
"filesScanned",
"risk",
"summary",
"findings",
"disclaimer",
"scannedAt"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"repo": {
"type": "string"
},
"risk": {
"enum": [
"clean",
"suspicious",
"dangerous"
],
"type": "string"
},
"branch": {
"type": "string"
},
"summary": {
"type": "string"
},
"findings": {
"type": "array",
"items": {
"type": "object",
"required": [
"file",
"severity",
"why"
],
"properties": {
"why": {
"type": "string"
},
"file": {
"type": "string"
},
"severity": {
"enum": [
"danger",
"warn"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 50
},
"scannedAt": {
"type": "string",
"format": "date-time"
},
"disclaimer": {
"type": "string"
},
"filesScanned": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}schemaforge — Generate Business JSON-LD
Analyze a public business site and return a deterministic, paste-ready JSON-LD template plus the live structured-data gap diff and ranked fixes. Use `deep_audit` instead when the same call must also return company, technology, contact, and DNS/email evidence. Generated markup contains placeholders that must be replaced with real business values; this tool makes no site changes and does not guarantee AI citations. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/schemaforge, not mcp://. Retry the identical authorized arguments and credential.
schemaforge input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site"
],
"properties": {
"city": {
"type": "string",
"description": "Optional city the business serves; used to contextualize the generated structured-data template."
},
"site": {
"type": "string",
"description": "Public business homepage or representative landing-page URL. Live HTML must be directly fetchable; JavaScript is not executed."
},
"vertical": {
"type": "string",
"description": "Optional structured-data template profile. med-spas is currently the specialized profile; unsupported values fall back to it."
}
},
"additionalProperties": false
}enrich — Enrich Company Domain
Inspect a public company domain and return structured identity, technology, social, contact, DNS, email-infrastructure, and AI-readiness evidence. Use `schemaforge` instead for a paste-ready JSON-LD template and remediation diff, or `deep_audit` when both outputs are required together. Public data only; this tool makes no site changes. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/enrich, not mcp://. Retry the identical authorized arguments and credential.
enrich input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Public company domain or URL, for example stripe.com. Use enrich for company evidence; use wallet_enrich for an EVM address."
}
},
"additionalProperties": false
}wallet_enrich — Enrich Base Wallet or Contract
Inspect a public Base or EVM address and return an agent-ready on-chain profile: EOA or contract type, native and curated token holdings, token/NFT metadata, proxy evidence, activity, and a derived profile label. Use `enrich` for a company domain; the two tools accept different identifiers and return different evidence. Read-only public chain data; no wallet action or custody. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/wallet-enrich, not mcp://. Retry the identical authorized arguments and credential.
wallet_enrich input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Public Base or EVM 0x address. Use wallet_enrich for on-chain evidence; use enrich for a company domain."
}
},
"additionalProperties": false
}deep_audit — Audit Complete AI Search Readiness
Run one read-only AI-search-readiness audit for a public business domain: company, technology, contact, and DNS/email evidence from `enrich`, plus the live structured-data gap analysis and paste-ready JSON-LD template from `schemaforge`. Use `enrich` for company facts only or `schemaforge` for structured-data remediation only. The template contains placeholders for real data; the score is diagnostic, no site changes are made, and it does not guarantee AI citations. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/deep-audit, not mcp://. Retry the identical authorized arguments and credential.
deep_audit input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"city": {
"type": "string",
"description": "Optional city the business serves; used only to contextualize the generated structured-data template."
},
"domain": {
"type": "string",
"description": "Public business domain or URL. The hostname is normalized and the audit starts at its HTTPS homepage; any supplied path or query is ignored."
},
"vertical": {
"type": "string",
"description": "Optional structured-data template profile. med-spas is currently specialized; unsupported values fall back to it."
}
},
"additionalProperties": false
}morpho_position — Inspect Morpho Borrower Position
Inspect one Base borrower across Morpho markets and return position balances, LTV, health factor, liquidation headroom, direct-RPC verification, and caller-selected collateral-price stress scenarios. Use `morpho_protection` when you need exact repay or add-collateral amounts and unsigned transaction templates, `morpho_market_underwrite` for market-wide risk, or `morpho_preliquidation_replay` for one completed historical event. Read-only; no wallet, signing, broadcast, or custody. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/defi/morpho-position, not mcp://. Retry the identical authorized arguments and credential.
morpho_position input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"shocks": {
"type": "array",
"items": {
"type": "number",
"maximum": 100,
"minimum": -99
},
"maxItems": 8,
"description": "Collateral price shocks in percent"
},
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Borrower EVM address on Base mainnet"
}
},
"additionalProperties": false
}morpho_protection — Plan Morpho Borrower Protection
Calculate two alternative protection plans for one Base Morpho borrower under a selected collateral-price shock and target health factor: partial repayment or added collateral. Each plan includes the bounded asset amount, expected stressed health factor, evidence basis, and unsigned ERC-20 approval plus Morpho call templates. Use `morpho_position` for diagnosis without an action plan, `morpho_market_underwrite` for market-wide risk, or `morpho_preliquidation_replay` for a completed historical event. Read-only; no wallet, signing, broadcast, or custody. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/defi/morpho-protection, not mcp://. Retry the identical authorized arguments and credential.
morpho_protection input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Borrower EVM address on Base mainnet."
},
"executionBufferBps": {
"type": "integer",
"default": 25,
"maximum": 500,
"minimum": 0,
"description": "Additional repayment or collateral amount buffer in basis points for debt accrual and integer rounding; 25 means 0.25%."
},
"targetHealthFactor": {
"type": "number",
"default": 1.25,
"maximum": 5,
"description": "Target Morpho health factor after the selected collateral-price shock; must be greater than 1 and at most 5.",
"exclusiveMinimum": 1
},
"protectAgainstShockPct": {
"type": "number",
"default": -10,
"maximum": 0,
"minimum": -99,
"description": "Collateral-price shock percentage to withstand, from -99 through 0; for example -10 models a 10% price decline."
}
},
"additionalProperties": false
}morpho_protection output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"product",
"version",
"address",
"chain",
"fetchedAt",
"latestIndexedAt",
"inputs",
"positionCount",
"actionableCount",
"unverifiedCount",
"quotes",
"source",
"invariants",
"boundary"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"chain": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"inputs": {
"type": "object",
"required": [
"targetHealthFactor",
"protectAgainstShockPct",
"executionBufferBps"
],
"properties": {
"executionBufferBps": {
"type": "integer"
},
"targetHealthFactor": {
"type": "number"
},
"protectAgainstShockPct": {
"type": "number"
}
},
"additionalProperties": false
},
"quotes": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"marketId",
"currentHealthFactor",
"status",
"plans",
"explanation"
],
"properties": {
"plans": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"asset",
"amountRaw",
"amount",
"expectedHealthFactorAtShock",
"transactions"
],
"properties": {
"id": {
"enum": [
"partial_repay",
"add_collateral"
],
"type": "string"
},
"asset": {
"type": "object",
"required": [
"address",
"symbol",
"decimals"
],
"properties": {
"symbol": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"string",
"null"
]
},
"decimals": {
"type": "number"
}
},
"additionalProperties": false
},
"amount": {
"type": "string"
},
"amountRaw": {
"type": "string"
},
"transactions": {
"type": "array",
"items": {
"type": "object",
"required": [
"to",
"value",
"data",
"purpose"
],
"properties": {
"to": {
"type": "string"
},
"data": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]+$"
},
"value": {
"type": "string",
"const": "0"
},
"purpose": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 2,
"minItems": 2
},
"expectedHealthFactorAtShock": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"maxItems": 0
},
"status": {
"type": "string",
"const": "state_unverified"
},
"marketId": {
"type": "string"
},
"explanation": {
"type": "string"
},
"currentHealthFactor": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"marketId",
"currentHealthFactor",
"healthFactorAtShockBeforeAction",
"targetHealthFactorAtShock",
"shock",
"stateBasis",
"status",
"plans",
"explanation"
],
"properties": {
"plans": {
"type": "array",
"items": {
"$ref": "#/properties/quotes/items/anyOf/0/properties/plans/items"
},
"maxItems": 0
},
"shock": {
"type": "object",
"required": [
"collateralPricePct",
"oraclePriceRaw"
],
"properties": {
"oraclePriceRaw": {
"type": "string"
},
"collateralPricePct": {
"type": "number"
}
},
"additionalProperties": false
},
"status": {
"type": "string",
"const": "target_met"
},
"marketId": {
"type": "string"
},
"stateBasis": {
"type": "object",
"required": [
"blockNumber",
"collateralAndBorrowShares",
"oraclePrice",
"borrowAssets",
"marketParams"
],
"properties": {
"blockNumber": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"oraclePrice": {
"type": "string",
"const": "direct_rpc_fresh_read"
},
"borrowAssets": {
"type": "string",
"const": "indexed amount with explicit execution buffer"
},
"marketParams": {
"type": "string",
"const": "keccak256 match to observed Morpho market ID"
},
"collateralAndBorrowShares": {
"type": "string",
"const": "direct_rpc_exact_match"
}
},
"additionalProperties": false
},
"explanation": {
"type": "string"
},
"currentHealthFactor": {
"type": [
"number",
"null"
]
},
"targetHealthFactorAtShock": {
"type": [
"number",
"null"
]
},
"healthFactorAtShockBeforeAction": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"marketId",
"currentHealthFactor",
"healthFactorAtShockBeforeAction",
"targetHealthFactorAtShock",
"shock",
"stateBasis",
"status",
"plans"
],
"properties": {
"plans": {
"type": "array",
"items": {
"$ref": "#/properties/quotes/items/anyOf/0/properties/plans/items"
},
"maxItems": 2,
"minItems": 2
},
"shock": {
"$ref": "#/properties/quotes/items/anyOf/1/properties/shock"
},
"status": {
"type": "string",
"const": "protection_available"
},
"marketId": {
"$ref": "#/properties/quotes/items/anyOf/1/properties/marketId"
},
"stateBasis": {
"$ref": "#/properties/quotes/items/anyOf/1/properties/stateBasis"
},
"currentHealthFactor": {
"$ref": "#/properties/quotes/items/anyOf/1/properties/currentHealthFactor"
},
"targetHealthFactorAtShock": {
"$ref": "#/properties/quotes/items/anyOf/1/properties/targetHealthFactorAtShock"
},
"healthFactorAtShockBeforeAction": {
"$ref": "#/properties/quotes/items/anyOf/1/properties/healthFactorAtShockBeforeAction"
}
},
"additionalProperties": false
}
]
}
},
"source": {
"type": "object",
"required": [
"provider"
],
"properties": {
"provider": {
"type": "string"
}
},
"additionalProperties": true
},
"address": {
"type": "string"
},
"product": {
"type": "string",
"const": "morpho-protection-quote"
},
"version": {
"type": "string",
"const": "1.0.0"
},
"boundary": {
"type": "string"
},
"fetchedAt": {
"type": "string",
"format": "date-time"
},
"invariants": {
"type": "object",
"required": [
"signing",
"broadcasting",
"custody",
"value",
"revalidation",
"simulation",
"postconditions"
],
"properties": {
"value": {
"type": "string",
"const": "0 on every unsigned transaction template"
},
"custody": {
"type": "string",
"const": "none"
},
"signing": {
"type": "string",
"const": "none"
},
"simulation": {
"type": "string"
},
"broadcasting": {
"type": "string",
"const": "none"
},
"revalidation": {
"type": "string"
},
"postconditions": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
}
},
"additionalProperties": false
},
"positionCount": {
"type": "integer",
"minimum": 0
},
"actionableCount": {
"type": "integer",
"minimum": 0
},
"latestIndexedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"unverifiedCount": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}morpho_market_underwrite — Underwrite Morpho Market
Underwrite one Base Morpho market with independent GraphQL, REST, and direct-RPC evidence for configuration integrity, liquidity, utilization, concentration, borrower health bands, recent history, bad debt, and PreLiquidation availability. Use `morpho_position` or `morpho_protection` for one borrower's current position or protection plan, and `morpho_preliquidation_replay` for the economics of one completed historical event. Read-only evidence with explicit disagreements; no opaque risk score or transaction action. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/defi/morpho-market-underwrite, not mcp://. Retry the identical authorized arguments and credential.
morpho_market_underwrite input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"marketId"
],
"properties": {
"marketId": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Morpho market ID on Base mainnet"
}
},
"additionalProperties": false
}morpho_preliquidation_replay — Replay Morpho PreLiquidation
Reconstruct one successful Base Morpho PreLiquidation transaction from its receipt and the exact block state, returning repaid and seized assets, protocol-oracle valuation, gross incentive, configured health window, and transaction gas before off-chain costs. Use `morpho_market_underwrite` for current market risk, `morpho_position` for a current borrower, or `morpho_protection` for a future protection plan. Historical read-only evidence; no transaction simulation, wallet, signing, or broadcast. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/defi/morpho-preliquidation-replay, not mcp://. Retry the identical authorized arguments and credential.
morpho_preliquidation_replay input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"transactionHash"
],
"properties": {
"transactionHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Successful Base transaction containing a Morpho PreLiquidate event"
}
},
"additionalProperties": false
}morpho_preliquidation_replay output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"product",
"version",
"chain",
"transaction",
"eventCount",
"events",
"verification",
"boundary"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"chain": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "number",
"const": 8453
},
"name": {
"type": "string",
"const": "Base mainnet"
}
},
"additionalProperties": false
},
"events": {
"type": "array",
"items": {
"type": "object",
"required": [
"contract",
"marketId",
"liquidator",
"borrower",
"assets",
"protocolOracle",
"grossEconomics",
"parameters"
],
"properties": {
"assets": {
"type": "object",
"required": [
"repaid",
"seized",
"repaidSharesRaw"
],
"properties": {
"repaid": {
"type": "object",
"required": [
"token",
"symbol",
"decimals",
"raw",
"amount"
],
"properties": {
"raw": {
"type": "string"
},
"token": {
"type": "string"
},
"amount": {
"type": "string"
},
"symbol": {
"type": [
"string",
"null"
]
},
"decimals": {
"type": "number"
}
},
"additionalProperties": false
},
"seized": {
"$ref": "#/properties/events/items/properties/assets/properties/repaid"
},
"repaidSharesRaw": {
"type": "string"
}
},
"additionalProperties": false
},
"borrower": {
"type": "string"
},
"contract": {
"type": "string"
},
"marketId": {
"type": "string"
},
"liquidator": {
"type": "string"
},
"parameters": {
"type": "object",
"required": [
"marketLltvRaw",
"marketLltvPct",
"preLltvRaw",
"preLltvPct",
"closeFactorStartRaw",
"closeFactorEndRaw",
"incentiveStartRaw",
"incentiveEndRaw"
],
"properties": {
"preLltvPct": {
"type": [
"number",
"null"
]
},
"preLltvRaw": {
"type": "string"
},
"marketLltvPct": {
"type": [
"number",
"null"
]
},
"marketLltvRaw": {
"type": "string"
},
"incentiveEndRaw": {
"type": "string"
},
"closeFactorEndRaw": {
"type": "string"
},
"incentiveStartRaw": {
"type": "string"
},
"closeFactorStartRaw": {
"type": "string"
}
},
"additionalProperties": false
},
"grossEconomics": {
"type": "object",
"required": [
"incentiveInLoanRaw",
"incentiveInLoanAmount",
"incentiveSign",
"incentivePct",
"boundary"
],
"properties": {
"boundary": {
"type": "string"
},
"incentivePct": {
"type": [
"number",
"null"
]
},
"incentiveSign": {
"enum": [
"negative",
"positive"
],
"type": "string"
},
"incentiveInLoanRaw": {
"type": "string"
},
"incentiveInLoanAmount": {
"type": "string"
}
},
"additionalProperties": false
},
"protocolOracle": {
"type": "object",
"required": [
"address",
"priceRaw",
"scale",
"collateralQuotedInLoanRaw",
"collateralQuotedInLoanAmount"
],
"properties": {
"scale": {
"type": "string"
},
"address": {
"type": "string"
},
"priceRaw": {
"type": "string"
},
"collateralQuotedInLoanRaw": {
"type": "string"
},
"collateralQuotedInLoanAmount": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"minItems": 1
},
"product": {
"type": "string",
"const": "morpho-preliquidation-replay"
},
"version": {
"type": "string",
"const": "1.0.0"
},
"boundary": {
"type": "string"
},
"eventCount": {
"type": "integer",
"exclusiveMinimum": 0
},
"transaction": {
"type": "object",
"required": [
"hash",
"blockNumber",
"blockTimestamp",
"from",
"status",
"gasUsed",
"effectiveGasPriceWei",
"gasCostWei",
"gasCostEth"
],
"properties": {
"to": {
"type": [
"string",
"null"
]
},
"from": {
"type": "string"
},
"hash": {
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"status": {
"type": "string",
"const": "success"
},
"gasUsed": {
"type": "string"
},
"gasCostEth": {
"type": "string"
},
"gasCostWei": {
"type": "string"
},
"blockNumber": {
"type": "integer",
"minimum": 0
},
"blockTimestamp": {
"type": "string",
"format": "date-time"
},
"effectiveGasPriceWei": {
"type": "string"
}
},
"additionalProperties": false
},
"verification": {
"type": "object",
"required": [
"receipt",
"event",
"params",
"price"
],
"properties": {
"event": {
"type": "string",
"const": "strict ABI decode of the official PreLiquidate signature"
},
"price": {
"type": "string",
"const": "PreLiquidation oracle read at the execution block"
},
"params": {
"type": "string",
"const": "PreLiquidation immutable contract reads at the execution block"
},
"receipt": {
"type": "string",
"const": "fresh direct Base RPC"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}opportunity_preflight — Preflight Agent Work Opportunity
Agent work opportunity -> deterministic attempt, verify-first, or abandon preflight using caller-supplied cost and selection assumptions plus dated platform evidence. Returns break-even probability, expected surplus, hard gates, and source-linked evidence. No claim, bid, payment, or submission. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/work/opportunity-preflight, not mcp://. Retry the identical authorized arguments and credential.
opportunity_preflight input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"rewardUsd",
"hours",
"hourlyCostUsd"
],
"properties": {
"hours": {
"type": "number",
"maximum": 10000,
"minimum": 0,
"description": "Estimated human and agent work time in hours for one complete attempt."
},
"slots": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Number of independently paid winner or worker slots."
},
"platform": {
"type": "string",
"maxLength": 100,
"description": "Optional platform slug used to attach dated platform-health evidence when a matching card exists."
},
"rewardUsd": {
"type": "number",
"description": "Maximum gross reward in USD if the opportunity is selected and paid.",
"exclusiveMinimum": 0
},
"acceptance": {
"enum": [
"deterministic",
"machine_scored",
"timed_review",
"discretionary",
"unknown"
],
"type": "string",
"default": "unknown",
"description": "How completion is accepted: deterministic proof, machine score, review deadline, discretionary judgment, or unknown."
},
"computeUsd": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Expected model, API, hosting, and compute spend in USD for one attempt."
},
"settlement": {
"enum": [
"direct",
"escrow",
"platform_balance",
"discretionary",
"unfunded",
"unknown"
],
"type": "string",
"default": "unknown",
"description": "How the reward is funded and paid: direct, escrow, platform balance, discretionary, unfunded, or unknown."
},
"agentAccess": {
"enum": [
"agent_allowed",
"agent_only",
"mixed",
"human_only",
"unknown"
],
"type": "string",
"default": "unknown",
"description": "Whether the platform explicitly allows agent participation, is agent-only, mixes agents and humans, is human-only, or remains unknown."
},
"competition": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Known number of competing submissions or workers; use 0 when unknown."
},
"hourlyCostUsd": {
"type": "number",
"maximum": 100000,
"minimum": 0,
"description": "Internal opportunity cost per hour in USD."
},
"reusableValueUsd": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Conservative USD value of reusable code, research, distribution, or other assets created by the attempt."
},
"mandatorySpendUsd": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Non-recoverable cash spend in USD required before the opportunity can settle."
},
"selectionProbabilityPct": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Caller-supplied probability, from 0 to 100, of receiving the reward; omit to receive a verify-first decision."
}
},
"additionalProperties": false
}opportunity_preflight output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"product",
"version",
"decision",
"input",
"economics",
"gates",
"platformEvidence",
"boundary"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"gates": {
"type": "object",
"required": [
"hardBlocks",
"requiredChecks",
"warnings"
],
"properties": {
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"hardBlocks": {
"type": "array",
"items": {
"type": "string"
}
},
"requiredChecks": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"input": {
"type": "object",
"required": [
"platform",
"rewardUsd",
"hours",
"hourlyCostUsd",
"computeUsd",
"mandatorySpendUsd",
"reusableValueUsd",
"selectionProbabilityPct",
"competition",
"slots",
"agentAccess",
"acceptance",
"settlement"
],
"properties": {
"hours": {
"type": "number"
},
"slots": {
"type": "integer"
},
"platform": {
"type": [
"string",
"null"
]
},
"rewardUsd": {
"type": "number"
},
"acceptance": {
"enum": [
"deterministic",
"machine_scored",
"timed_review",
"discretionary",
"unknown"
],
"type": "string"
},
"computeUsd": {
"type": "number"
},
"settlement": {
"enum": [
"direct",
"escrow",
"platform_balance",
"discretionary",
"unfunded",
"unknown"
],
"type": "string"
},
"agentAccess": {
"enum": [
"agent_allowed",
"agent_only",
"mixed",
"human_only",
"unknown"
],
"type": "string"
},
"competition": {
"type": "integer"
},
"hourlyCostUsd": {
"type": "number"
},
"reusableValueUsd": {
"type": "number"
},
"mandatorySpendUsd": {
"type": "number"
},
"selectionProbabilityPct": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"product": {
"type": "string",
"const": "samedaydesk-opportunity-preflight"
},
"version": {
"type": "string",
"const": "1.0.0"
},
"boundary": {
"type": "string"
},
"decision": {
"enum": [
"attempt",
"verify_first",
"abandon"
],
"type": "string"
},
"economics": {
"type": "object",
"required": [
"executionCostUsd",
"mandatorySpendUsd",
"totalAtRiskUsd",
"reusableValueUsd",
"expectedRewardUsd",
"expectedSurplusUsd",
"breakEvenSelectionProbabilityPct",
"equalEntryShareReferencePct",
"probabilitySource",
"equalEntryShareBoundary"
],
"properties": {
"totalAtRiskUsd": {
"type": "number"
},
"executionCostUsd": {
"type": "number"
},
"reusableValueUsd": {
"type": "number"
},
"expectedRewardUsd": {
"type": [
"number",
"null"
]
},
"mandatorySpendUsd": {
"type": "number"
},
"probabilitySource": {
"enum": [
"missing",
"caller_supplied"
],
"type": "string"
},
"expectedSurplusUsd": {
"type": [
"number",
"null"
]
},
"equalEntryShareBoundary": {
"type": "string"
},
"equalEntryShareReferencePct": {
"type": [
"number",
"null"
]
},
"breakEvenSelectionProbabilityPct": {
"type": "number"
}
},
"additionalProperties": false
},
"platformEvidence": {
"anyOf": [
{
"type": "object",
"required": [
"platformId",
"platformName",
"healthCategory",
"confidence",
"freshness",
"observedAt",
"freshUntil",
"sampleCount",
"settlementMechanism",
"rightsClass",
"evidence",
"unknowns"
],
"properties": {
"evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"factClass",
"summary",
"sourceUrl",
"observedAt",
"stageReached",
"failedAt",
"confidence"
],
"properties": {
"summary": {
"type": "string"
},
"failedAt": {
"type": [
"string",
"null"
]
},
"factClass": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"confidence": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"stageReached": {
"type": "string"
}
},
"additionalProperties": false
}
},
"unknowns": {
"type": "array",
"items": {
"type": "string"
}
},
"freshness": {
"type": "string"
},
"confidence": {
"type": "string"
},
"freshUntil": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"platformId": {
"type": "string"
},
"rightsClass": {
"type": "string"
},
"sampleCount": {
"type": "integer"
},
"platformName": {
"type": "string"
},
"healthCategory": {
"type": "string"
},
"settlementMechanism": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}agent_discoverability_audit — Audit Agent Service Discoverability
Measure one service's brand-blind rank, source-family coverage, expected-route presence, canonical-vs-alias listing identity, duplicate records, competitors, and exact-price drift across ten public machine-service discovery views. Supply `runtimeUrl` with an exact GET route to derive the comparison price from one coherent live unsigned x402 or MPP offer; otherwise `expectedPriceUsd` remains caller-supplied. Set `surfaceAudit` to check the target's public Agent Card, ERC-8004 registration document, and action catalog. Set `materializationAudit` with an exact GET or POST route to distinguish Coinbase seller ineligibility from provider acceptance without exact-resource Bazaar materialization. Catalog queries use no credentials or payments. Results are point-in-time provider and catalog evidence, not demand, seller trust, settlement, or future-rank proof. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/distribution/agent-discoverability-audit, not mcp://. Retry the identical authorized arguments and credential.
agent_discoverability_audit input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"origin",
"intent"
],
"properties": {
"payTo": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Optional EVM payTo for alias matching"
},
"route": {
"type": "string",
"pattern": "^\\/[^?#]*$",
"description": "Optional expected exact path"
},
"intent": {
"type": "string",
"maxLength": 500,
"minLength": 20,
"description": "Brand-blind capability description"
},
"method": {
"enum": [
"GET",
"POST"
],
"type": "string",
"description": "Exact route method for the optional Coinbase materialization audit. Defaults to GET; runtimeUrl is GET-only."
},
"origin": {
"type": "string",
"format": "uri",
"description": "Public HTTPS service origin"
},
"runtimeUrl": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Optional exact same-origin HTTPS GET URL whose unpaid x402 or MPP offer supplies the runtime price reference. Requires route and an exactly matching pathname."
},
"surfaceAudit": {
"type": "boolean",
"description": "When true, inspect the target's public Agent Card, ERC-8004 registration document, and action catalog for the expected route through bounded same-origin fetches."
},
"expectedPriceUsd": {
"anyOf": [
{
"type": "number",
"maximum": 1000000,
"minimum": 0
},
{
"type": "string",
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]{1,6})?$"
}
],
"description": "Optional exact route price expected by the caller. A coherent runtimeUrl offer takes precedence and caller drift is reported."
},
"materializationAudit": {
"type": "boolean",
"description": "When true with route and method, distinguish Coinbase seller ineligibility from provider acceptance without exact-resource Bazaar materialization."
}
},
"additionalProperties": false
}payment_offer_preflight — Preflight x402 and MPP Offer
Compare x402 and MPP payment challenges, terms, and seller-declared JSON success-response readiness for one exact public HTTPS GET route before buyer authorization, including URL and realm binding, expiry, cross-protocol economic parity, and exact-route OpenAPI evidence. Use `agent_discoverability_audit` instead when you need to know whether catalogs rank or expose a service. This tool uses no target credential, signature, or target payment, follows no redirect, never reads the paid target body, and reads only the same-origin public OpenAPI document under a strict size cap. A seller declaration is advisory and does not establish runtime validity, seller trust, utility, or settlement reliability. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/commerce/payment-offer-preflight, not mcp://. Retry the identical authorized arguments and credential.
payment_offer_preflight input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Exact public HTTPS GET route whose unpaid x402 and MPP challenge headers and same-origin OpenAPI success-response declaration should be inspected before buyer authorization. Credential-like query keys, fragments, unresolved parameters, local hosts, redirects, and non-public IPs are rejected."
},
"catalog": {
"type": "object",
"required": [
"source",
"method",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Exact catalog candidate URL, including all non-secret query values."
},
"asset": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Optional advertised currency or asset identifier."
},
"method": {
"type": "string",
"const": "GET",
"description": "Catalog request method. The current product inspects exact GET routes."
},
"source": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Public catalog or registry name."
},
"network": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Optional advertised network identifier."
},
"protocol": {
"enum": [
"x402",
"mpp"
],
"type": "string",
"description": "Optional advertised payment protocol."
},
"expiresAt": {
"type": "string",
"format": "date-time",
"description": "Optional advertised offer expiry."
},
"recipient": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Optional advertised payment recipient."
},
"amountAtomic": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,77})$",
"description": "Optional advertised price in atomic currency units."
}
},
"description": "Optional caller-supplied catalog candidate. When present, the tool compares it with every live unsigned offer across request, protocol, amount, network, asset, recipient, and expiry.",
"additionalProperties": false
}
},
"additionalProperties": false
}payment_offer_preflight output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"product",
"version",
"checkedAt",
"target",
"decision",
"protocols",
"offerCount",
"offers",
"parity",
"catalogCoherence",
"responseContract",
"responseContractAcquisition",
"findings",
"boundary"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"offers": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"protocol",
"scheme",
"intent",
"network",
"asset",
"amountAtomic",
"decimals",
"amountDisplay",
"recipient",
"expiresAt",
"valid"
],
"properties": {
"asset": {
"type": [
"string",
"null"
]
},
"valid": {
"type": "boolean"
},
"intent": {
"type": [
"string",
"null"
]
},
"scheme": {
"type": [
"string",
"null"
]
},
"network": {
"type": [
"string",
"null"
]
},
"decimals": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"protocol": {
"type": "string",
"const": "x402"
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"recipient": {
"type": [
"string",
"null"
]
},
"amountAtomic": {
"type": [
"string",
"null"
]
},
"amountDisplay": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"protocol",
"scheme",
"intent",
"network",
"asset",
"amountAtomic",
"decimals",
"amountDisplay",
"recipient",
"expiresAt",
"valid",
"realm",
"credentialTypes"
],
"properties": {
"asset": {
"$ref": "#/properties/offers/items/anyOf/0/properties/asset"
},
"realm": {
"type": [
"string",
"null"
]
},
"valid": {
"$ref": "#/properties/offers/items/anyOf/0/properties/valid"
},
"intent": {
"$ref": "#/properties/offers/items/anyOf/0/properties/intent"
},
"scheme": {
"$ref": "#/properties/offers/items/anyOf/0/properties/scheme"
},
"network": {
"$ref": "#/properties/offers/items/anyOf/0/properties/network"
},
"decimals": {
"$ref": "#/properties/offers/items/anyOf/0/properties/decimals"
},
"protocol": {
"type": "string",
"const": "mpp"
},
"expiresAt": {
"$ref": "#/properties/offers/items/anyOf/0/properties/expiresAt"
},
"recipient": {
"$ref": "#/properties/offers/items/anyOf/0/properties/recipient"
},
"amountAtomic": {
"$ref": "#/properties/offers/items/anyOf/0/properties/amountAtomic"
},
"amountDisplay": {
"$ref": "#/properties/offers/items/anyOf/0/properties/amountDisplay"
},
"credentialTypes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
]
}
},
"parity": {
"type": "object",
"required": [
"compared",
"consistent",
"driftFields"
],
"properties": {
"compared": {
"type": "boolean"
},
"consistent": {
"type": [
"boolean",
"null"
]
},
"driftFields": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"target": {
"type": "object",
"required": [
"method",
"url",
"httpStatus"
],
"properties": {
"url": {
"type": "string"
},
"method": {
"type": "string",
"const": "GET"
},
"httpStatus": {
"type": "integer"
}
},
"additionalProperties": false
},
"product": {
"type": "string",
"const": "samedaydesk-payment-offer-preflight"
},
"version": {
"type": "string",
"const": "1.2.0"
},
"boundary": {
"type": "object",
"required": [
"credentialsUsed",
"paymentSigned",
"paymentSent",
"targetResponseBodyRead",
"openApiDocumentRead",
"redirectsFollowed",
"claim"
],
"properties": {
"claim": {
"type": "string"
},
"paymentSent": {
"type": "boolean",
"const": false
},
"paymentSigned": {
"type": "boolean",
"const": false
},
"credentialsUsed": {
"type": "boolean",
"const": false
},
"redirectsFollowed": {
"type": "boolean",
"const": false
},
"openApiDocumentRead": {
"type": "boolean"
},
"targetResponseBodyRead": {
"type": "boolean",
"const": false
}
},
"additionalProperties": false
},
"decision": {
"enum": [
"parseable_offer",
"review_required",
"no_parseable_offer"
],
"type": "string"
},
"findings": {
"type": "array",
"items": {
"type": "object",
"required": [
"severity",
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"severity": {
"enum": [
"error",
"warning"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"checkedAt": {
"type": "string",
"format": "date-time"
},
"protocols": {
"type": "array",
"items": {
"enum": [
"mpp",
"x402"
],
"type": "string"
}
},
"offerCount": {
"type": "integer",
"minimum": 0
},
"catalogCoherence": {
"type": "array",
"items": {
"type": "object",
"required": [
"decision"
],
"properties": {
"decision": {
"enum": [
"coherent",
"partial",
"drifted"
],
"type": "string"
}
},
"additionalProperties": true
}
},
"responseContract": {
"type": "object",
"required": [
"decision"
],
"properties": {
"decision": {
"enum": [
"admissible",
"partial",
"absent",
"invalid"
],
"type": "string"
}
},
"additionalProperties": true
},
"responseContractAcquisition": {
"type": "object",
"required": [
"attempted",
"sameOrigin",
"path",
"maxBytes",
"documentRead",
"targetResponseBodyRead",
"credentialsUsed",
"redirectsFollowed"
],
"properties": {
"path": {
"type": "string",
"const": "/openapi.json"
},
"maxBytes": {
"type": "integer",
"exclusiveMinimum": 0
},
"attempted": {
"type": "boolean",
"const": true
},
"sameOrigin": {
"type": "boolean",
"const": true
},
"documentRead": {
"type": "boolean"
},
"credentialsUsed": {
"type": "boolean",
"const": false
},
"redirectsFollowed": {
"type": "boolean",
"const": false
},
"targetResponseBodyRead": {
"type": "boolean",
"const": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}seller_integrity_audit — Audit Seller Machine Buyability
Use this after a buyer integration fails, a seller changes a paid route, or before the next paid retry or release. Audit one exact paid GET or POST seller route against buyer-required JSON success paths. GET verifies constructible non-secret input, exact request binding, live x402 and MPP economics, and optional Bazaar eligibility; POST performs static-safe OpenAPI contract analysis and sends no target request. Use `payment_offer_preflight` instead when you already have one exact callable GET URL and only need its current unpaid offer before buyer authorization, or `agent_discoverability_audit` for catalog rank and identity. Uses no target credential, signature, or target payment and retains no seller schema, body, or query values. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/commerce/seller-integrity-audit, not mcp://. Retry the identical authorized arguments and credential.
seller_integrity_audit input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"origin",
"route"
],
"properties": {
"route": {
"type": "string",
"pattern": "^\\/[^/?#{}][^?#{}]*$",
"description": "Exact paid GET or POST path declared by the seller, without query or template parameters."
},
"method": {
"enum": [
"GET",
"POST"
],
"type": "string",
"default": "GET",
"description": "POST receives static OpenAPI response-contract analysis without sending a target request."
},
"origin": {
"type": "string",
"format": "uri",
"description": "Credential-free public HTTPS seller origin on port 443."
},
"referral": {
"type": "string",
"pattern": "^r1_[0-9a-f]{64}$",
"description": "Optional x402 receipt-derived acquisition label. It cannot change payment or delivery."
},
"requireBazaar": {
"type": "boolean",
"default": false,
"description": "When true, missing Bazaar discovery metadata becomes a repair finding for live-probed GET routes."
},
"requiredPaths": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+(?:\\.[A-Za-z0-9_-]+){0,7}$"
},
"default": [],
"maxItems": 16,
"description": "Buyer-required dotted success-response paths that the seller schema must guarantee recursively."
}
},
"additionalProperties": false
}contract_qualified_search — Search Contract-Qualified Services
Search Agent402 and the official MPP catalog for paid machine services that both match a capability intent and guarantee buyer-required JSON response paths. Use `agent_discoverability_audit` when you are measuring one known seller's catalog reach or rank, `seller_integrity_audit` when you already know the exact seller route to inspect, or `payment_offer_preflight` when you already have one exact callable GET URL. This search excludes SameDayDesk-owned supply and unresolved routes before audit, uses no credential or wallet, sends no seller POST or target payment, reads no paid response body, and returns only a query digest. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/commerce/contract-qualified-search, not mcp://. Retry the identical authorized arguments and credential.
contract_qualified_search input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"requiredPaths"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 8,
"minimum": 1,
"description": "Maximum candidates audited and returned across Agent402 and MPP."
},
"query": {
"type": "string",
"maxLength": 300,
"minLength": 10,
"description": "Capability intent sent to Agent402 and used locally to rank MPP catalog metadata. Do not include credentials or private values."
},
"requiredPaths": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+(?:\\.[A-Za-z0-9_-]+){0,7}$"
},
"maxItems": 16,
"minItems": 1,
"description": "Buyer-required dotted success-response paths that every returned seller schema must guarantee recursively."
},
"maxPriceDisplayUnits": {
"type": "number",
"default": 0.1,
"maximum": 10,
"description": "Maximum advertised per-call price in each source's display currency.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}contract_qualified_search output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"product",
"version",
"checkedAt",
"decision",
"request",
"sources",
"qualified",
"rejected",
"boundary"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"product": {
"type": "string",
"const": "samedaydesk-contract-qualified-search"
},
"request": {
"type": "object",
"required": [
"queryDigest",
"requiredPaths",
"maxPriceDisplayUnits",
"limit"
],
"properties": {
"limit": {
"type": "integer"
},
"queryDigest": {
"type": "string",
"pattern": "^sha256:[0-9a-f]{64}$"
},
"requiredPaths": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 16,
"minItems": 1
},
"maxPriceDisplayUnits": {
"type": "number"
}
},
"additionalProperties": false
},
"sources": {
"type": "object",
"required": [
"agent402",
"mpp"
],
"properties": {
"mpp": {
"$ref": "#/properties/sources/properties/agent402"
},
"agent402": {
"type": "object",
"required": [
"status",
"discovered",
"audited"
],
"properties": {
"status": {
"enum": [
"ok",
"unavailable"
],
"type": "string"
},
"audited": {
"type": "integer",
"minimum": 0
},
"discovered": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"version": {
"type": "string",
"const": "1.1.0"
},
"boundary": {
"type": "object",
"required": [
"credentialsUsed",
"walletAccessed",
"targetPaymentSigned",
"targetPaymentSent",
"sellerPostRequestSent",
"paidResponseBodyRead",
"queryRetained",
"querySentTo",
"directoryRequests",
"sellerAudits"
],
"properties": {
"querySentTo": {
"type": "array",
"items": {
"type": "string",
"const": "agent402"
}
},
"sellerAudits": {
"type": "integer"
},
"queryRetained": {
"type": "boolean",
"const": false
},
"walletAccessed": {
"type": "boolean",
"const": false
},
"credentialsUsed": {
"type": "boolean",
"const": false
},
"directoryRequests": {
"type": "integer"
},
"targetPaymentSent": {
"type": "boolean",
"const": false
},
"targetPaymentSigned": {
"type": "boolean",
"const": false
},
"paidResponseBodyRead": {
"type": "boolean",
"const": false
},
"sellerPostRequestSent": {
"type": "boolean",
"const": false
}
},
"additionalProperties": false
},
"decision": {
"enum": [
"qualified_candidates_found",
"no_qualified_candidate"
],
"type": "string"
},
"rejected": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"serviceName",
"origin",
"method",
"route",
"price",
"reason",
"findings"
],
"properties": {
"price": {
"$ref": "#/properties/qualified/items/properties/price"
},
"route": {
"$ref": "#/properties/qualified/items/properties/route"
},
"method": {
"$ref": "#/properties/qualified/items/properties/method"
},
"origin": {
"$ref": "#/properties/qualified/items/properties/origin"
},
"reason": {
"type": "string"
},
"source": {
"$ref": "#/properties/qualified/items/properties/source"
},
"findings": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 12
},
"serviceName": {
"$ref": "#/properties/qualified/items/properties/serviceName"
}
},
"additionalProperties": false
},
"maxItems": 8
},
"checkedAt": {
"type": "string",
"format": "date-time"
},
"qualified": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"serviceName",
"origin",
"method",
"route",
"price",
"description",
"decision",
"protocols",
"runtimeChallengeVerified",
"guaranteedPaths"
],
"properties": {
"price": {
"type": "object",
"required": [
"amountDisplayUnits",
"currency",
"decimals",
"amountAtomic"
],
"properties": {
"currency": {
"type": "string"
},
"decimals": {
"type": "integer"
},
"amountAtomic": {
"type": "string"
},
"amountDisplayUnits": {
"type": "number"
}
},
"additionalProperties": false
},
"route": {
"type": "string"
},
"method": {
"enum": [
"GET",
"POST"
],
"type": "string"
},
"origin": {
"type": "string",
"format": "uri"
},
"source": {
"enum": [
"agent402",
"mpp"
],
"type": "string"
},
"decision": {
"enum": [
"machine_buyable",
"contract_ready"
],
"type": "string"
},
"protocols": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"guaranteedPaths": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 16
},
"runtimeChallengeVerified": {
"type": "boolean"
}
},
"additionalProperties": false
},
"maxItems": 8
}
},
"additionalProperties": false
}agent_surface_budget_audit — Audit Agent Surface Budget
Measure one public service's credential-free MCP tools/list, OpenAPI, or both declared discovery surfaces before any tool call or target payment. Use `agent_discoverability_audit` for catalog reach and rank, `seller_integrity_audit` for one exact operation's response contract, or this tool for byte budgets, heaviest definitions, missing selection contracts, and progressive-discovery fixes. Unselected surfaces are not fetched or judged. It follows no redirect, calls no target tool, sends no credential or target payment, and returns no target schema, response body, or session identifier. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/distribution/agent-surface-budget-audit, not mcp://. Retry the identical authorized arguments and credential.
agent_surface_budget_audit input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"origin"
],
"properties": {
"origin": {
"type": "string",
"format": "uri",
"description": "Credential-free public HTTPS service origin on port 443, with no path or query."
},
"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,
"description": "Maximum preferred raw MCP tools/list response size in bytes."
},
"openApiBudgetBytes": {
"type": "integer",
"default": 524288,
"maximum": 1000000,
"minimum": 32768,
"description": "Maximum preferred raw OpenAPI document size in bytes."
}
},
"additionalProperties": false
}agent_surface_budget_audit output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"product",
"version",
"checkedAt",
"decision",
"request",
"mcp",
"openapi",
"actions",
"boundary"
],
"properties": {
"ok": {
"type": "boolean"
},
"mcp": {
"anyOf": [
{
"type": "object",
"required": [
"requested"
],
"properties": {
"requested": {
"type": "boolean",
"const": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"requested",
"available",
"failureCode"
],
"properties": {
"available": {
"type": "boolean",
"const": false
},
"requested": {
"type": "boolean",
"const": true
},
"httpStatus": {
"type": "integer",
"maximum": 599,
"minimum": 300
},
"failureCode": {
"enum": [
"authentication_required",
"bounded_transport_failure",
"connection_reset",
"dns_failed",
"method_not_allowed",
"rate_limited",
"redirect_rejected",
"surface_invalid",
"surface_too_large",
"surface_unavailable",
"transport_timeout",
"upstream_unavailable"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"requested",
"available",
"bytes",
"byteDerivedTokenEstimate",
"budgetBytes",
"withinBudget",
"protocolVersion",
"server",
"toolCount",
"pageCount",
"selectionBytes",
"missingTitleCount",
"missingDescriptionCount",
"missingInputSchemaCount",
"missingOutputSchemaCount",
"heaviestTools"
],
"properties": {
"bytes": {
"type": "integer",
"minimum": 0
},
"server": {
"type": "object",
"required": [
"name",
"version"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"available": {
"type": "boolean",
"const": true
},
"pageCount": {
"type": "integer",
"exclusiveMinimum": 0
},
"requested": {
"type": "boolean",
"const": true
},
"toolCount": {
"type": "integer",
"minimum": 0
},
"budgetBytes": {
"type": "integer",
"exclusiveMinimum": 0
},
"withinBudget": {
"type": "boolean"
},
"heaviestTools": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"bytes",
"descriptionBytes",
"inputSchemaBytes",
"outputSchemaBytes",
"hasTitle",
"hasDescription",
"hasInputSchema",
"hasOutputSchema"
],
"properties": {
"name": {
"type": "string"
},
"bytes": {
"type": "integer",
"minimum": 0
},
"hasTitle": {
"type": "boolean"
},
"hasDescription": {
"type": "boolean"
},
"hasInputSchema": {
"type": "boolean"
},
"hasOutputSchema": {
"type": "boolean"
},
"descriptionBytes": {
"type": "integer",
"minimum": 0
},
"inputSchemaBytes": {
"type": "integer",
"minimum": 0
},
"outputSchemaBytes": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 8
},
"selectionBytes": {
"type": "integer",
"minimum": 0
},
"protocolVersion": {
"type": [
"string",
"null"
]
},
"missingTitleCount": {
"type": "integer",
"minimum": 0
},
"missingDescriptionCount": {
"type": "integer",
"minimum": 0
},
"missingInputSchemaCount": {
"type": "integer",
"minimum": 0
},
"byteDerivedTokenEstimate": {
"type": "integer",
"minimum": 0
},
"missingOutputSchemaCount": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
]
},
"actions": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 16
},
"openapi": {
"anyOf": [
{
"$ref": "#/properties/mcp/anyOf/0"
},
{
"$ref": "#/properties/mcp/anyOf/1"
},
{
"type": "object",
"required": [
"requested",
"available",
"bytes",
"byteDerivedTokenEstimate",
"budgetBytes",
"withinBudget",
"operationCount",
"missingOperationIdCount",
"heaviestOperations"
],
"properties": {
"bytes": {
"type": "integer",
"minimum": 0
},
"available": {
"type": "boolean",
"const": true
},
"requested": {
"type": "boolean",
"const": true
},
"budgetBytes": {
"type": "integer",
"exclusiveMinimum": 0
},
"withinBudget": {
"type": "boolean"
},
"operationCount": {
"type": "integer",
"minimum": 0
},
"heaviestOperations": {
"type": "array",
"items": {
"type": "object",
"required": [
"method",
"path",
"bytes",
"summaryBytes",
"hasOperationId"
],
"properties": {
"path": {
"type": "string"
},
"bytes": {
"type": "integer",
"minimum": 0
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"HEAD",
"OPTIONS"
],
"type": "string"
},
"summaryBytes": {
"type": "integer",
"minimum": 0
},
"hasOperationId": {
"type": "boolean"
}
},
"additionalProperties": false
},
"maxItems": 8
},
"missingOperationIdCount": {
"type": "integer",
"minimum": 0
},
"byteDerivedTokenEstimate": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
]
},
"product": {
"type": "string",
"const": "samedaydesk-agent-surface-budget-audit"
},
"request": {
"type": "object",
"required": [
"origin",
"surfaceMode",
"mcpPath",
"openApiPath",
"mcpBudgetBytes",
"openApiBudgetBytes"
],
"properties": {
"origin": {
"type": "string",
"format": "uri"
},
"mcpPath": {
"type": "string"
},
"openApiPath": {
"type": "string"
},
"surfaceMode": {
"enum": [
"mcp",
"openapi",
"both"
],
"type": "string"
},
"mcpBudgetBytes": {
"type": "integer",
"exclusiveMinimum": 0
},
"openApiBudgetBytes": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"version": {
"type": "string",
"const": "1.2.0"
},
"boundary": {
"type": "object",
"required": [
"credentialsUsed",
"toolsCalled",
"targetPaymentSigned",
"targetPaymentSent",
"redirectsFollowed",
"responseBodiesReturned",
"schemasRetained",
"sessionIdentifiersReturned",
"tokenEstimateMethod"
],
"properties": {
"toolsCalled": {
"type": "boolean",
"const": false
},
"credentialsUsed": {
"type": "boolean",
"const": false
},
"schemasRetained": {
"type": "boolean",
"const": false
},
"redirectsFollowed": {
"type": "boolean",
"const": false
},
"targetPaymentSent": {
"type": "boolean",
"const": false
},
"targetPaymentSigned": {
"type": "boolean",
"const": false
},
"tokenEstimateMethod": {
"type": "string",
"const": "ceil(UTF-8 bytes / 4); comparative estimate, not tokenizer billing"
},
"responseBodiesReturned": {
"type": "boolean",
"const": false
},
"sessionIdentifiersReturned": {
"type": "boolean",
"const": false
}
},
"additionalProperties": false
},
"decision": {
"enum": [
"within_budget",
"optimize",
"surface_incomplete"
],
"type": "string"
},
"checkedAt": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
}settlement_proof — Verify Base USDC Settlement
Verify one claimed canonical Base USDC settlement after execution by matching a successful transaction receipt to the exact recipient, atomic amount, and optional payer. Use `payment_offer_preflight` before authorization when you need to inspect an unpaid x402 or MPP offer instead. This tool reads only public Base receipt and log data; it reads no merchant ledger and performs no wallet, signing, broadcast, custody, or execution action. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/commerce/settlement-proof, not mcp://. Retry the identical authorized arguments and credential.
settlement_proof input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"transactionHash",
"recipient",
"amountAtomic"
],
"properties": {
"payer": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Optional expected canonical Base USDC payer."
},
"recipient": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Expected canonical Base USDC recipient."
},
"amountAtomic": {
"type": "string",
"pattern": "^[1-9][0-9]{0,20}$",
"description": "Expected positive USDC amount in six-decimal atomic units."
},
"transactionHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Base mainnet transaction hash containing the claimed canonical USDC transfer."
}
},
"additionalProperties": false
}settlement_proof output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"product",
"version",
"checkedAt",
"decision",
"request",
"chain",
"asset",
"transaction",
"settlement",
"findings",
"boundary"
],
"properties": {
"ok": {
"type": "boolean"
},
"asset": {
"type": "object",
"required": [
"address",
"symbol",
"decimals"
],
"properties": {
"symbol": {
"type": "string",
"const": "USDC"
},
"address": {
"type": "string"
},
"decimals": {
"type": "number",
"const": 6
}
},
"additionalProperties": false
},
"chain": {
"type": "object",
"required": [
"id",
"name",
"network"
],
"properties": {
"id": {
"type": "number",
"const": 8453
},
"name": {
"type": "string",
"const": "Base mainnet"
},
"network": {
"type": "string",
"const": "eip155:8453"
}
},
"additionalProperties": false
},
"product": {
"type": "string",
"const": "samedaydesk-base-usdc-settlement-proof"
},
"request": {
"type": "object",
"required": [
"transactionHash",
"recipient",
"amountAtomic",
"payer"
],
"properties": {
"payer": {
"type": [
"string",
"null"
]
},
"recipient": {
"type": "string"
},
"amountAtomic": {
"type": "string"
},
"transactionHash": {
"type": "string"
}
},
"additionalProperties": false
},
"version": {
"type": "string",
"const": "1.0.0"
},
"boundary": {
"type": "object",
"required": [
"source",
"privateLedgerRead",
"auditedTransactionModified",
"walletAccessed",
"executionAuthorized"
],
"properties": {
"source": {
"type": "string",
"const": "public Base mainnet receipt and logs"
},
"walletAccessed": {
"type": "boolean",
"const": false
},
"privateLedgerRead": {
"type": "boolean",
"const": false
},
"executionAuthorized": {
"type": "boolean",
"const": false
},
"auditedTransactionModified": {
"type": "boolean",
"const": false
}
},
"additionalProperties": false
},
"decision": {
"enum": [
"verified",
"not_verified",
"receipt_unavailable"
],
"type": "string"
},
"findings": {
"type": "array",
"items": {
"type": "object",
"required": [
"severity",
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"severity": {
"type": "string",
"const": "error"
}
},
"additionalProperties": false
}
},
"checkedAt": {
"type": "string",
"format": "date-time"
},
"settlement": {
"type": "object",
"required": [
"verified",
"exactTransferCount",
"recipientTransferCount"
],
"properties": {
"observed": {
"anyOf": [
{
"type": "object",
"required": [
"payer",
"recipient",
"amountAtomic",
"amountUsdc"
],
"properties": {
"payer": {
"type": "string"
},
"recipient": {
"type": "string"
},
"amountUsdc": {
"type": "string"
},
"amountAtomic": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"verified": {
"type": "boolean"
},
"exactTransferCount": {
"type": "integer",
"minimum": 0
},
"recipientTransferCount": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"transaction": {
"type": "object",
"required": [
"hash",
"status"
],
"properties": {
"hash": {
"type": "string"
},
"status": {
"type": "string"
},
"blockNumber": {
"type": "string"
},
"blockTimestamp": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}transaction_receipt — Inspect Transaction Receipt
Inspect one Base or Ethereum transaction hash and return normalized success or revert status, block time, gas and fee fields, decoded ERC-20 Transfer events, and canonical USDC transfers. Use `settlement_proof` instead when you must verify an exact canonical Base USDC recipient, amount, and optional payer claim. Raw logs are excluded; this tool performs no wallet, signing, broadcast, custody, or execution action. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/chain/transaction-receipt, not mcp://. Retry the identical authorized arguments and credential.
transaction_receipt input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"transactionHash"
],
"properties": {
"network": {
"enum": [
"base",
"ethereum"
],
"type": "string",
"default": "base",
"description": "Receipt network. Defaults to Base mainnet."
},
"transactionHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Mined Base or Ethereum transaction hash whose normalized receipt should be returned."
}
},
"additionalProperties": false
}solana_transaction_receipt — Inspect Solana Transaction Receipt
Inspect one finalized Solana mainnet transaction signature and return normalized success or failure status, slot, block time, fee, SPL-token owner deltas, and canonical USDC deltas. Supply recipient, amount, and optional payer when an exact settlement claim must be verified; use `transaction_receipt` for Base or Ethereum. Raw instructions and logs are excluded, and this tool performs no wallet, signing, broadcast, custody, or execution action. Payment challenge and credentials are bound to GET https://agents.samedaydesk.com/chain/solana-transaction-receipt, not mcp://. Retry the identical authorized arguments and credential.
solana_transaction_receipt input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"signature"
],
"properties": {
"mint": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"description": "Optional SPL-token mint; defaults to canonical Solana USDC."
},
"payer": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"description": "Optional expected token payer owner; requires recipient and amountAtomic."
},
"recipient": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"description": "Optional expected token recipient owner."
},
"signature": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{80,90}$",
"description": "Finalized Solana mainnet transaction signature."
},
"amountAtomic": {
"type": "string",
"pattern": "^[1-9][0-9]{0,19}$",
"description": "Optional expected positive token amount in atomic units; requires recipient."
}
},
"additionalProperties": false
}wallet_policy_conformance — Evaluate Agent Wallet Policy Conformance
Evaluate safe standardized allow, deny, and error observations from an agent wallet or delegated signer. Use this after running a bounded provider policy test matrix to distinguish explicit provider-policy enforcement from validation or generic provider failures and to test exact execution shape separately from operation allowlisting. Accepts no credentials, wallet IDs, signatures, transactions, or raw provider responses; it evaluates caller-supplied observations and does not run the provider tests itself. Payment challenge and credentials are bound to POST https://agents.samedaydesk.com/security/wallet-policy-conformance, not mcp://. Retry the identical authorized arguments and credential.
wallet_policy_conformance input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"profileId",
"provider",
"network",
"protocol",
"observations"
],
"properties": {
"network": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Network identifier used by the tested profile."
},
"protocol": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Payment or execution protocol bound by the tested profile."
},
"provider": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Wallet or delegated-signer provider name."
},
"profileId": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Caller-defined policy profile identifier with no credential or wallet secret."
},
"observations": {
"type": "array",
"items": {
"type": "object",
"required": [
"case",
"actual",
"denialClass"
],
"properties": {
"case": {
"enum": [
"intended",
"missing_authorization",
"wrong_operation",
"duplicate_approved_action",
"wrong_chain",
"wrong_token_contract_or_program",
"wrong_recipient",
"wrong_amount",
"wrong_function_or_instruction",
"wrong_route_or_offer",
"changed_protocol_challenge",
"replay_or_reuse",
"reordered_approved_actions",
"mixed_unapproved_action",
"wrong_fee_asset",
"missing_validity"
],
"type": "string",
"description": "Standardized mutation or control case."
},
"code": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,63}$",
"description": "Optional safe provider code only, never a raw message or payload."
},
"actual": {
"enum": [
"allowed",
"denied",
"error"
],
"type": "string",
"description": "Observed high-level outcome."
},
"denialClass": {
"enum": [
"none",
"policy",
"validation",
"provider"
],
"type": "string",
"description": "Where the denial or error occurred; only policy earns provider-native coverage."
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 1,
"description": "Unique standardized observations. Raw provider responses, signatures, transactions, credentials, and wallet IDs are rejected."
}
},
"additionalProperties": false
}wallet_policy_conformance output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"schemaVersion",
"standardSchemaVersion",
"product",
"evaluatedAt",
"profile",
"decision",
"complete",
"exactShapePassed",
"results",
"providerNativeVerified",
"providerNativeUnverified",
"notEvaluatedByWalletPolicy",
"missingRequiredCases",
"unsafeCases",
"inconclusiveCases",
"boundary"
],
"properties": {
"product": {
"type": "string",
"const": "samedaydesk-wallet-policy-conformance"
},
"profile": {
"type": "object",
"required": [
"profileId",
"provider",
"network",
"protocol"
],
"properties": {
"network": {
"type": "string"
},
"protocol": {
"type": "string"
},
"provider": {
"type": "string"
},
"profileId": {
"type": "string"
}
},
"additionalProperties": false
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"case",
"actual",
"denialClass",
"expected",
"control",
"required",
"expectationMet",
"providerNativeVerified",
"finding"
],
"properties": {
"case": {
"enum": [
"intended",
"missing_authorization",
"wrong_operation",
"duplicate_approved_action",
"wrong_chain",
"wrong_token_contract_or_program",
"wrong_recipient",
"wrong_amount",
"wrong_function_or_instruction",
"wrong_route_or_offer",
"changed_protocol_challenge",
"replay_or_reuse",
"reordered_approved_actions",
"mixed_unapproved_action",
"wrong_fee_asset",
"missing_validity"
],
"type": "string"
},
"code": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,63}$"
},
"actual": {
"enum": [
"allowed",
"denied",
"error"
],
"type": "string"
},
"control": {
"type": [
"string",
"null"
]
},
"finding": {
"enum": [
"expected_behavior",
"unsafe_allowed",
"expected_behavior_not_proven",
"denied_outside_provider_policy"
],
"type": "string"
},
"expected": {
"enum": [
"allow",
"deny"
],
"type": "string"
},
"required": {
"type": "boolean"
},
"denialClass": {
"enum": [
"none",
"policy",
"validation",
"provider"
],
"type": "string"
},
"expectationMet": {
"type": "boolean"
},
"providerNativeVerified": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"boundary": {
"type": "object",
"required": [
"credentialsAccepted",
"walletAccessed",
"signatureVerified",
"transactionBroadcast",
"statement"
],
"properties": {
"statement": {
"type": "string"
},
"walletAccessed": {
"type": "boolean",
"const": false
},
"signatureVerified": {
"type": "boolean",
"const": false
},
"credentialsAccepted": {
"type": "boolean",
"const": false
},
"transactionBroadcast": {
"type": "boolean",
"const": false
}
},
"additionalProperties": false
},
"complete": {
"type": "boolean"
},
"decision": {
"enum": [
"conformant",
"partial",
"unsafe"
],
"type": "string"
},
"evaluatedAt": {
"type": "string",
"format": "date-time"
},
"unsafeCases": {
"type": "array",
"items": {
"type": "string"
}
},
"schemaVersion": {
"type": "string",
"const": "samedaydesk.wallet-policy-conformance.v1"
},
"exactShapePassed": {
"type": "boolean"
},
"inconclusiveCases": {
"type": "array",
"items": {
"type": "string"
}
},
"missingRequiredCases": {
"type": "array",
"items": {
"type": "string"
}
},
"standardSchemaVersion": {
"type": "string",
"const": "agent-payment-policy.wallet-policy-observation-report.v1"
},
"providerNativeVerified": {
"type": "array",
"items": {
"type": "string"
}
},
"providerNativeUnverified": {
"type": "array",
"items": {
"type": "string"
}
},
"notEvaluatedByWalletPolicy": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}stateful_wallet_policy_conformance — Evaluate Stateful Wallet Policy Conformance
Evaluate safe standardized observations from wallet policies that track prior or concurrent requests. Use `wallet_policy_conformance` instead for one-request action shape, method, chain, token, recipient, amount, and function controls. This tool separately tests sequential cumulative limits, signed-but-unbroadcast accounting, ABI extraction, concurrent oversubscription, counter-reference failure, and application serialization. It accepts no credentials, counter values, wallet or resource IDs, signatures, transactions, or raw provider responses and does not run the provider tests itself. Payment challenge and credentials are bound to POST https://agents.samedaydesk.com/security/stateful-wallet-policy-conformance, not mcp://. Retry the identical authorized arguments and credential.
stateful_wallet_policy_conformance input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"profileId",
"provider",
"network",
"protocol",
"observations"
],
"properties": {
"network": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Network identifier used by the tested stateful profile."
},
"protocol": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Payment or execution protocol bound by the tested stateful profile."
},
"provider": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Wallet or delegated-signer provider name."
},
"profileId": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Caller-defined stateful policy profile identifier with no credential, wallet, or counter secret."
},
"observations": {
"type": "array",
"items": {
"type": "object",
"required": [
"case",
"actual",
"enforcementClass"
],
"properties": {
"case": {
"enum": [
"first_within_cap",
"sequential_exceeds_cap",
"signed_unbroadcast_counts",
"unrecognized_calldata",
"concurrent_exceeds_cap",
"missing_counter_reference",
"application_serialized_concurrent_exceeds_cap"
],
"type": "string",
"description": "Standardized cumulative, extraction, concurrency, reference, or application-serialization case."
},
"code": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,63}$",
"description": "Optional safe provider code only, never a raw message, counter value, or payload."
},
"actual": {
"enum": [
"allowed",
"denied",
"error"
],
"type": "string",
"description": "Observed high-level outcome."
},
"enforcementClass": {
"enum": [
"none",
"policy",
"application",
"validation",
"provider"
],
"type": "string",
"description": "Where enforcement occurred. Provider policy and application guards remain separate."
}
},
"additionalProperties": false
},
"maxItems": 7,
"minItems": 1,
"description": "Unique standardized stateful observations. Raw provider responses, signatures, transactions, counter values, credentials, wallet IDs, and resource IDs are rejected."
}
},
"additionalProperties": false
}stateful_wallet_policy_conformance output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"schemaVersion",
"standardSchemaVersion",
"product",
"evaluatedAt",
"profile",
"decision",
"complete",
"strictBudgetPassed",
"results",
"providerNativeVerified",
"providerNativeUnverified",
"applicationVerified",
"missingRequiredCases",
"unsafeCases",
"inconclusiveCases",
"boundary"
],
"properties": {
"product": {
"type": "string",
"const": "samedaydesk-stateful-wallet-policy-conformance"
},
"profile": {
"type": "object",
"required": [
"profileId",
"provider",
"network",
"protocol"
],
"properties": {
"network": {
"type": "string"
},
"protocol": {
"type": "string"
},
"provider": {
"type": "string"
},
"profileId": {
"type": "string"
}
},
"additionalProperties": false
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"case",
"actual",
"enforcementClass",
"expected",
"control",
"required",
"expectationMet",
"providerNativeVerified",
"applicationVerified",
"finding"
],
"properties": {
"case": {
"enum": [
"first_within_cap",
"sequential_exceeds_cap",
"signed_unbroadcast_counts",
"unrecognized_calldata",
"concurrent_exceeds_cap",
"missing_counter_reference",
"application_serialized_concurrent_exceeds_cap"
],
"type": "string"
},
"code": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,63}$"
},
"actual": {
"enum": [
"allowed",
"denied",
"error"
],
"type": "string"
},
"control": {
"type": [
"string",
"null"
]
},
"finding": {
"enum": [
"expected_behavior",
"unsafe_allowed",
"expected_behavior_not_proven",
"denied_outside_policy_or_application_guard"
],
"type": "string"
},
"expected": {
"enum": [
"allow",
"deny"
],
"type": "string"
},
"required": {
"type": "boolean"
},
"expectationMet": {
"type": "boolean"
},
"enforcementClass": {
"enum": [
"none",
"policy",
"application",
"validation",
"provider"
],
"type": "string"
},
"applicationVerified": {
"type": "boolean"
},
"providerNativeVerified": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"boundary": {
"type": "object",
"required": [
"credentialsAccepted",
"walletAccessed",
"signaturesVerified",
"transactionBroadcast",
"statement"
],
"properties": {
"statement": {
"type": "string"
},
"walletAccessed": {
"type": "boolean",
"const": false
},
"signaturesVerified": {
"type": "boolean",
"const": false
},
"credentialsAccepted": {
"type": "boolean",
"const": false
},
"transactionBroadcast": {
"type": "boolean",
"const": false
}
},
"additionalProperties": false
},
"complete": {
"type": "boolean"
},
"decision": {
"enum": [
"conformant",
"partial",
"unsafe"
],
"type": "string"
},
"evaluatedAt": {
"type": "string",
"format": "date-time"
},
"unsafeCases": {
"type": "array",
"items": {
"type": "string"
}
},
"schemaVersion": {
"type": "string",
"const": "samedaydesk.stateful-wallet-policy-conformance.v1"
},
"inconclusiveCases": {
"type": "array",
"items": {
"type": "string"
}
},
"strictBudgetPassed": {
"type": "boolean"
},
"applicationVerified": {
"type": "array",
"items": {
"type": "string"
}
},
"missingRequiredCases": {
"type": "array",
"items": {
"type": "string"
}
},
"standardSchemaVersion": {
"type": "string",
"const": "agent-payment-policy.stateful-wallet-policy-observation-report.v1"
},
"providerNativeVerified": {
"type": "array",
"items": {
"type": "string"
}
},
"providerNativeUnverified": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}page_change — Compare Held Page Extracts
Compare two already-held extract-batch JSON artifacts. charged is false. Not a paid SKU. Does not fetch, pay, or schedule a second observation. Compare only the explicitly selected data keys present on both matched rows. Missing keys are coverage unknown, not deletions; explicit null is a present value. Unselected metadata is not a content delta. SYNTHETIC offline construction example only. No URL fetch, payment, receipt, observation or freshness is evidenced. Complete request example (title changes, description stays unchanged): {"before":{"ok":true,"product":"samedaydesk-extract-batch","schemaVersion":"samedaydesk.extract-batch.v0","quote":{"amountAtomic":"10000","displayUsdc":"0.01","meaning":"SYNTHETIC offline construction example only. No URL fetch, payment, receipt, observation or freshness is evidenced."},"jobId":"0000000000000000000000000000000000000000000000000000000000000000","jobStatus":"completed","stopReason":null,"partial":false,"sources":[{"id":"item-001","source":"https://synthetic.example.invalid/page","status":"success","data":{"title":"Synthetic title before","description":"Stable synthetic description"},"notes":[],"error":null,"provenance":{"transport":"synthetic","note":"SYNTHETIC offline construction example only. No URL fetch, payment, receipt, observation or freshness is evidenced."}}],"accounting":{"requests":0,"bytes":0,"wallMs":0,"retries":0,"succeeded":0,"partial":0,"failed":0,"unknown":0,"skippedDuplicate":0},"costInputs":{"note":"SYNTHETIC offline construction example only. No URL fetch, payment, receipt, observation or freshness is evidenced."},"charged":false,"boundary":{"guaranteedUrlSuccess":false,"introductoryPrice":true,"sourceFetchBeforeAuthorization":false,"automaticRetries":false}},"after":{"ok":true,"product":"samedaydesk-extract-batch","schemaVersion":"samedaydesk.extract-batch.v0","quote":{"amountAtomic":"10000","displayUsdc":"0.01","meaning":"SYNTHETIC offline construction example only. No URL fetch, payment, receipt, observation or freshness is evidenced."},"jobId":"1111111111111111111111111111111111111111111111111111111111111111","jobStatus":"completed","stopReason":null,"partial":false,"sources":[{"id":"item-001","source":"https://synthetic.example.invalid/page","status":"success","data":{"title":"Synthetic title after","description":"Stable synthetic description"},"notes":[],"error":null,"provenance":{"transport":"synthetic","note":"SYNTHETIC offline construction example only. No URL fetch, payment, receipt, observation or freshness is evidenced."}}],"accounting":{"requests":0,"bytes":0,"wallMs":0,"retries":0,"succeeded":0,"partial":0,"failed":0,"unknown":0,"skippedDuplicate":0},"costInputs":{"note":"SYNTHETIC offline construction example only. No URL fetch, payment, receipt, observation or freshness is evidenced."},"charged":false,"boundary":{"guaranteedUrlSuccess":false,"introductoryPrice":true,"sourceFetchBeforeAuthorization":false,"automaticRetries":false}},"fields":["title","description"]}
page_change input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"before",
"after",
"fields"
],
"properties": {
"after": {
"$ref": "#/properties/before"
},
"clock": {
"type": [
"string",
"null"
],
"description": "Optional caller UTC ISO-8601 timestamp with trailing Z, accepted for compatibility only; cannot attest freshness."
},
"before": {
"anyOf": [
{
"type": "object",
"required": [
"ok",
"product",
"schemaVersion",
"quote",
"jobId",
"jobStatus",
"stopReason",
"partial",
"sources",
"accounting",
"costInputs",
"charged",
"boundary"
],
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"$ref": "#/properties/before/anyOf/0/properties/quote/properties/meaning"
},
"jobId": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"quote": {
"type": "object",
"required": [
"amountAtomic",
"displayUsdc",
"meaning"
],
"properties": {
"meaning": {
"type": "string"
},
"displayUsdc": {
"type": "string",
"const": "0.01"
},
"amountAtomic": {
"type": "string",
"const": "10000"
}
},
"additionalProperties": true
},
"charged": {
"$ref": "#/properties/before/anyOf/0/properties/ok"
},
"partial": {
"$ref": "#/properties/before/anyOf/0/properties/ok"
},
"product": {
"type": "string",
"const": "samedaydesk-extract-batch"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source",
"status",
"data",
"notes",
"error",
"provenance"
],
"properties": {
"id": {
"type": "string",
"description": "Row identifier; does not replace source identity."
},
"data": {
"anyOf": [
{
"type": "object",
"properties": {
"lang": {
"description": "Selected extraction value: lang."
},
"text": {
"description": "Selected extraction value: text."
},
"links": {
"description": "Selected extraction value: links."
},
"title": {
"description": "Selected extraction value: title."
},
"jsonLd": {
"description": "Selected extraction value: jsonLd."
},
"twitter": {
"description": "Selected extraction value: twitter."
},
"headings": {
"description": "Selected extraction value: headings."
},
"canonical": {
"description": "Selected extraction value: canonical."
},
"openGraph": {
"description": "Selected extraction value: openGraph."
},
"aiReadiness": {
"description": "Selected extraction value: aiReadiness."
},
"description": {
"description": "Selected extraction value: description."
}
},
"description": "Compare only the explicitly selected data keys present on both matched rows. Missing keys are coverage unknown, not deletions; explicit null is a present value. Unselected metadata is not a content delta.",
"additionalProperties": true
},
{
"type": "null",
"description": "Compare only the explicitly selected data keys present on both matched rows. Missing keys are coverage unknown, not deletions; explicit null is a present value. Unselected metadata is not a content delta."
}
],
"description": "Compare only the explicitly selected data keys present on both matched rows. Missing keys are coverage unknown, not deletions; explicit null is a present value. Unselected metadata is not a content delta."
},
"error": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"notes": {
"type": "array"
},
"source": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "Stable source identity, separate from row id and observation time. Matching normalizes source strings (URL fragments removed). Use the same non-empty identity on both sides; duplicate active identities are ambiguous. Synthetic URL STRINGS are inert and are never fetched by this transform."
},
"status": {
"enum": [
"pending",
"success",
"partial",
"failure",
"unknown",
"skipped_duplicate"
],
"type": "string"
},
"finalUrl": {
"$ref": "#/properties/before/anyOf/0/properties/stopReason"
},
"httpStatus": {
"anyOf": [
{
"type": "integer"
},
{
"$ref": "#/properties/before/anyOf/0/properties/sources/items/properties/error/anyOf/1"
}
]
},
"provenance": {
"$ref": "#/properties/before/anyOf/0/properties/sources/items/properties/error"
}
},
"additionalProperties": true
},
"maxItems": 5,
"minItems": 1
},
"boundary": {
"$ref": "#/properties/before/anyOf/0/properties/sources/items/properties/error/anyOf/0"
},
"jobStatus": {
"enum": [
"running",
"completed",
"completed_with_unknown",
"stopped",
"interrupted"
],
"type": "string"
},
"accounting": {
"$ref": "#/properties/before/anyOf/0/properties/sources/items/properties/error/anyOf/0"
},
"costInputs": {
"$ref": "#/properties/before/anyOf/0/properties/sources/items/properties/error/anyOf/0"
},
"stopReason": {
"type": [
"string",
"null"
]
},
"schemaVersion": {
"type": "string",
"const": "samedaydesk.extract-batch.v0"
}
},
"description": "Representative merchant structure for useful comparisons; not a new paid request or proof of payment. Compare only the explicitly selected data keys present on both matched rows. Missing keys are coverage unknown, not deletions; explicit null is a present value. Unselected metadata is not a content delta.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"jobId",
"status",
"costParameters",
"accounting",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/properties/before/anyOf/0/properties/sources/items"
},
"maxItems": 32,
"minItems": 1
},
"jobId": {
"$ref": "#/properties/before/anyOf/0/properties/quote/properties/meaning"
},
"status": {
"$ref": "#/properties/before/anyOf/0/properties/quote/properties/meaning"
},
"accounting": {
"$ref": "#/properties/before/anyOf/0/properties/sources/items/properties/error/anyOf/0"
},
"costParameters": {
"$ref": "#/properties/before/anyOf/0/properties/sources/items/properties/error/anyOf/0"
}
},
"description": "Existing C1 result compatibility. No merchant product/schemaVersion is required. Compare only the explicitly selected data keys present on both matched rows. Missing keys are coverage unknown, not deletions; explicit null is a present value. Unselected metadata is not a content delta.",
"additionalProperties": true
},
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"anyOf": [
{
"$ref": "#/properties/before/anyOf/0"
},
{
"$ref": "#/properties/before/anyOf/1"
}
]
},
"status": {
"$ref": "#/properties/before/anyOf/0/properties/quote/properties/meaning"
},
"mediaType": {
"type": "string",
"const": "application/json"
},
"observedAt": {
"type": [
"string",
"null"
],
"description": "Caller observation metadata only; does not attest freshness."
}
},
"additionalProperties": false
},
{
"type": "object",
"properties": {},
"description": "Intentionally permissive diagnostic alternative, not a template for a useful comparison. Missing/wrong schemas, keys, source identities or fields do not become valid comparison evidence. A missing snapshot can be supplied as {missing:true}. Safety admission still rejects paths, URL dereference, limit raises and invalid envelopes.",
"additionalProperties": true
}
],
"description": "Already held JSON artifact or JSON envelope, never a path or URL to dereference. Stable source identity, separate from row id and observation time. Matching normalizes source strings (URL fragments removed). Use the same non-empty identity on both sides; duplicate active identities are ambiguous. Synthetic URL STRINGS are inert and are never fetched by this transform. The structured branches describe representative comparable inputs. Incomplete objects remain admitted for diagnostic reports, subject to unchanged HTTP safety checks; HTTP 200 does not establish completeness or usefulness."
},
"fields": {
"type": "array",
"items": {
"enum": [
"title",
"description",
"canonical",
"lang",
"openGraph",
"twitter",
"jsonLd",
"headings",
"links",
"text",
"aiReadiness"
],
"type": "string"
},
"maxItems": 11,
"minItems": 1,
"description": "Explicit non-empty unique subset of supported fields. Compare only the explicitly selected data keys present on both matched rows. Missing keys are coverage unknown, not deletions; explicit null is a present value. Unselected metadata is not a content delta."
},
"maxStaleMs": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"description": "Optional freshness horizon, not a compute ceiling or freshness authority."
},
{
"type": "null",
"description": "Optional freshness horizon, not a compute ceiling or freshness authority."
}
],
"description": "Optional freshness horizon, not a compute ceiling or freshness authority."
},
"allowFreshClaim": {
"type": "boolean",
"const": false,
"description": "Supplied inputs cannot attest freshness. True is rejected."
}
},
"additionalProperties": false
}careers_board_cold — Return Acquired Careers Board Recipe
Return the acquired cold careers-board recipe and its public tests. This tool is free: charged is false, it does not fetch a live board, and it does not accept payment. Use `careers_board` when you need one named-board observation. Direct free execution remains available.
careers_board_cold input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}report_caller_result — Report One Caller Result
Optionally state whether the current paid morpho_position result was useful or not_useful. This tool is free: charged is false, it does not repay, and it does not change the delivered purchase. Read the capability only from the paid result meta samedaydesk/mcp-caller-result. Schema success is not a statement. Absence is not useful or not_useful. Do not follow a link, do not send the capability to another origin, and do not pay again to report.
report_caller_result input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"token",
"disposition"
],
"properties": {
"token": {
"type": "string",
"description": "Capability copied from the paid result meta. Not a payer, price, or event id."
},
"disposition": {
"enum": [
"useful",
"not_useful"
],
"type": "string",
"description": "Explicit statement after you inspect the result."
},
"reasonCategory": {
"enum": [
"matched_task",
"saved_a_step",
"wrong_output",
"missing_field",
"not_actionable"
],
"type": "string",
"description": "Optional reason. Omit it to leave the reason empty."
}
},
"additionalProperties": false
}trial_read — Read Public Page Under Shared Trial
Open-world
Read one public HTTP(S) page as bounded Markdown through the existing walletless trial. Read and extract share the same original authority, remaining hops, expiry and one concurrent operation. No separate reader allowance. Optional markdownLimitChars is an integer from 1 through 40000; omitted calls use 40000. charged is false. This is not the paid `read` tool and it returns no payment or settlement receipt. The paid next path stays GET /read?url={encodedPublicUrl}. Each attempted DNS, HTTP, or redirect hop consumes one durable start before I/O. The call is not idempotent or effect-free; a retry spends another hop and does not refund a lost response. Existing readMarkdown JSON: inspect ok, sourceOk, status, error, markdown, truncated and capture. Bounded native HTML tables preserve blank cells, spans and links inside Markdown; unsupported tables are explicitly omitted with truncation. No JavaScript or completeness guarantee. HTTP 200 may report source or fetch failure. No payment or settlement receipt.
trial_read input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Caller public http(s) URL. Private, loopback, and non-public hosts are refused."
},
"markdownLimitChars": {
"type": "integer",
"maximum": 40000,
"minimum": 1,
"description": "Optional Markdown character limit from 1 through 40000. Omitted calls use 40000."
}
},
"additionalProperties": false
}trial_read output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"requestedUrl",
"finalUrl",
"url",
"status",
"sourceOk",
"error",
"title",
"markdown",
"wordCount",
"truncated",
"capture",
"fetchedAt",
"charged"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"url": {
"type": "string"
},
"error": {
"anyOf": [
{
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"status": {
"type": "integer"
},
"capture": {
"type": "object",
"required": [
"method",
"javascriptExecuted",
"maxBodyBytes",
"textExcerptLimitChars",
"markdownLimitChars",
"bodyBytes",
"bodyTruncated",
"textTruncated",
"charset",
"charsetSource"
],
"properties": {
"method": {
"type": "string",
"const": "http-get-no-javascript"
},
"charset": {
"type": [
"string",
"null"
]
},
"bodyBytes": {
"type": "integer",
"minimum": 0
},
"maxBodyBytes": {
"type": "integer"
},
"bodyTruncated": {
"type": "boolean"
},
"charsetSource": {
"enum": [
"content-type",
"html-meta",
"default-utf-8",
"invalid-charset-fallback"
],
"type": "string"
},
"textTruncated": {
"type": "boolean"
},
"javascriptExecuted": {
"type": "boolean",
"const": false
},
"markdownLimitChars": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"textExcerptLimitChars": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"charged": {
"type": "boolean",
"const": false
},
"finalUrl": {
"type": "string"
},
"markdown": {
"type": "string"
},
"sourceOk": {
"type": "boolean"
},
"fetchedAt": {
"type": "string",
"format": "date-time"
},
"truncated": {
"type": "boolean"
},
"wordCount": {
"type": "integer",
"minimum": 0
},
"requestedUrl": {
"type": "string"
}
},
"additionalProperties": false
}trial_read annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}recover_paid_result
Read the stored outcome of an earlier native paid call using its original input and credential. This call cannot execute or pay.
recover_paid_result input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"arguments"
],
"properties": {
"name": {
"type": "string"
},
"arguments": {
"type": "object",
"additionalProperties": {}
}
},
"additionalProperties": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-06: 1 of 1 checks answered
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 578 ms
- 95th percentile latency
- 578 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 578 ms · metadata changed · 30 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http samedaydesk-machine-commerce-mcp https://agents.samedaydesk.com/mcpCodex
Codex configuration
codex mcp add samedaydesk-machine-commerce-mcp --url https://agents.samedaydesk.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"samedaydesk-machine-commerce-mcp": {
"url": "https://agents.samedaydesk.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"samedaydesk-machine-commerce-mcp": {
"type": "streamableHttp",
"url": "https://agents.samedaydesk.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"samedaydesk-machine-commerce-mcp": {
"type": "http",
"url": "https://agents.samedaydesk.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http samedaydesk-machine-commerce-mcp https://agents.samedaydesk.com/mcpClaude Desktop
Claude Desktop configuration
https://agents.samedaydesk.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"samedaydesk-machine-commerce-mcp": {
"serverUrl": "https://agents.samedaydesk.com/mcp"
}
}
}Let your agent find its tools
Find servers like SameDayDesk Machine Commerce MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.