MCP Server
x402-data-gateway
io.github.epistemedeus/x402-data-gateway
What this MCP does
Provides paid agent-service discovery, payment and seller preflight audits, web extraction, wallet and transaction inspection, DeFi analysis, and supply-chain security checks.
Capabilities
Tools
25
tools
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.
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}
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.
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}
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}
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.
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}
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}
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.
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}
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.
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}
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.
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.'}}, 'additionalProperties': False}
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 https://agents.samedaydesk.com/extract/batch, not mcp://. Retry the identical authorized arguments and credential.
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.'}}, 'additionalProperties': False}
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 https://agents.samedaydesk.com/lockfile-pin-delta, not mcp://. Retry the identical authorized arguments and credential.
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}
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}
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.
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_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.
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_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.
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}
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}
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.
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}
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}
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.
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}
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}
page_change
Compare Held Page Extracts
Compare two already-held extract-batch JSON artifacts on caller-named fields. This tool is free: charged is false, it does not fetch, and it does not accept payment. Use extract_batch when you still need a paid observation. Do not add a second paid diff.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['before', 'after', 'fields'], 'properties': {'after': {'type': 'object', 'description': 'Already delivered batch JSON object. Not a URL or filesystem path.', 'additionalProperties': {}}, 'before': {'type': 'object', 'description': 'Already delivered batch JSON object. Not a URL or filesystem path.', 'additionalProperties': {}}, 'fields': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 11, 'minItems': 1, 'description': 'Explicit field names to compare.'}}, '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.
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}
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}
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.
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}
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.
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}
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.
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}
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.
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}
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.
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}
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}
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.
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}
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.
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}
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}
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.
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}
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.
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}
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.
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}
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}
History
Recent tool changes
Added
page_change
Sept. 25, 2026, 2:51 a.m.
Added
stateful_wallet_policy_conformance
Sept. 17, 2026, 12:41 p.m.
Added
wallet_policy_conformance
Sept. 17, 2026, 12:41 p.m.
Added
solana_transaction_receipt
Sept. 17, 2026, 12:41 p.m.
Added
transaction_receipt
Sept. 17, 2026, 12:41 p.m.
Added
settlement_proof
Sept. 17, 2026, 12:41 p.m.
Added
agent_surface_budget_audit
Sept. 17, 2026, 12:41 p.m.
Added
contract_qualified_search
Sept. 17, 2026, 12:41 p.m.
Added
seller_integrity_audit
Sept. 17, 2026, 12:41 p.m.
Added
payment_offer_preflight
Sept. 17, 2026, 12:41 p.m.
Added
agent_discoverability_audit
Sept. 17, 2026, 12:41 p.m.
Added
opportunity_preflight
Sept. 17, 2026, 12:41 p.m.
Added
morpho_preliquidation_replay
Sept. 17, 2026, 12:41 p.m.
Added
morpho_market_underwrite
Sept. 17, 2026, 12:41 p.m.
Added
morpho_protection
Sept. 17, 2026, 12:41 p.m.
Added
morpho_position
Sept. 17, 2026, 12:41 p.m.
Added
deep_audit
Sept. 17, 2026, 12:41 p.m.
Added
wallet_enrich
Sept. 17, 2026, 12:41 p.m.
Added
enrich
Sept. 17, 2026, 12:41 p.m.
Added
schemaforge
Sept. 17, 2026, 12:41 p.m.
Added
scan
Sept. 17, 2026, 12:41 p.m.
Added
read
Sept. 17, 2026, 12:41 p.m.
Added
lockfile_pin_delta
Sept. 17, 2026, 12:41 p.m.
Added
extract_batch
Sept. 17, 2026, 12:41 p.m.
Added
extract
Sept. 17, 2026, 12:41 p.m.
Discover
Similar MCP servers
agent-transaction-control
network.flint/agent-transaction-control
Issues and verifies agent identities, mandates, authority records, reputation data, and pre-transaction fraud checks for agent co…
SAP MCP Server
ai.oobeprotocol.sap.mcp/sap-mcp
Provides an MCP gateway connecting SAP-related tools with Solana, DeFi, decentralized identity, and x402 payments.
AIMEAT
io.aimeat/aimeat
Provides a self-hosted agent operating system with agent work delegation, access controls, federation, hooks, SSO, security admin…
hyperion
com.thetempleofdoom.hyperion/hyperion
Acts as a paid MCP tool marketplace and utility gateway with server discovery, HTTP and JavaScript tools, research, data conversi…
Japan Public Ledgers MCP
com.mcp-revenue-empire/japan-public-ledgers
Provides agent identity, memory, audit, trust, proxy, temporary email, webhook, CAPTCHA, and alerting capabilities alongside publ…
PHION Agent Trust Infrastructure
systems.phion/evidence-engine
Provides agent trust, policy, provenance, evidence, delegation, telemetry, and transaction-control services for MCP and agent wor…
Swamp
world.swampai/swamp
Coordinates security agents through scoped bug-bounty programs, target claims, vulnerability submissions, peer review, shared fin…
AgentBIT
app.agentbit/mcp
Routes pay-per-call tools over x402 on Base, covering discovery, data conversion, company research, counterparty screening, domai…