x402-data-gateway

Search Contract-Qualified Services

contract_qualified_search

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.

Input Schema

Name	Required	Description
`limit`	No	Maximum candidates audited and returned across Agent402 and MPP.
`query`	Yes	Capability intent sent to Agent402 and used locally to rank MPP catalog metadata. Do not include credentials or private values.
`requiredPaths`	Yes	Buyer-required dotted success-response paths that every returned seller schema must guarantee recursively.
`maxPriceDisplayUnits`	No	Maximum advertised per-call price in each source's display currency.

Output Schema

Name	Required	Description	Default
`ok`	Yes
`product`	Yes
`request`	Yes
`sources`	Yes
`version`	Yes
`boundary`	Yes
`decision`	Yes
`rejected`	Yes
`checkedAt`	Yes
`qualified`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedAug 20, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "boundary": {
+      "additionalProperties": false,
+      "properties": {
+        "credentialsUsed": {
+          "const": false,
+          "type": "boolean"
+        },
+        "directoryRequests": {
+          "type": "integer"
+        },
+        "paidResponseBodyRead": {
+          "const": false,
+          "type": "boolean"
+        },
+        "queryRetained": {
+          "const": false,
+          "type": "boolean"
+        },
+        "querySentTo": {
+          "items": {
+            "const": "agent402",
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "sellerAudits": {
+          "type": "integer"
+        },
+        "sellerPostRequestSent": {
+          "const": false,
+          "type": "boolean"
+        },
+        "targetPaymentSent": {
+          "const": false,
+          "type": "boolean"
+        },
+        "targetPaymentSigned": {
+          "const": false,
+          "type": "boolean"
+        },
+        "walletAccessed": {
+          "const": false,
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "credentialsUsed",
+        "walletAccessed",
+        "targetPaymentSigned",
+        "targetPaymentSent",
+        "sellerPostRequestSent",
+        "paidResponseBodyRead",
+        "queryRetained",
+        "querySentTo",
+        "directoryRequests",
+        "sellerAudits"
+      ],
+      "type": "object"
+    },
+    "checkedAt": {
+      "format": "date-time",
+      "type": "string"
+    },
+    "decision": {
+      "enum": [
+        "qualified_candidates_found",
+        "no_qualified_candidate"
+      ],
+      "type": "string"
+    },
+    "ok": {
+      "const": true,
+      "type": "boolean"
+    },
+    "product": {
+      "const": "samedaydesk-contract-qualified-search",
+      "type": "string"
+    },
+    "qualified": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "decision": {
+            "enum": [
+              "machine_buyable",
+              "contract_ready"
+            ],
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "guaranteedPaths": {
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 16,
+            "type": "array"
+          },
+          "method": {
+            "enum": [
+              "GET",
+              "POST"
+            ],
+            "type": "string"
+          },
+          "origin": {
+            "format": "uri",
+            "type": "string"
+          },
+          "price": {
+            "additionalProperties": false,
+            "properties": {
+              "amountAtomic": {
+                "type": "string"
+              },
+              "amountDisplayUnits": {
+                "type": "number"
+              },
+              "currency": {
+                "type": "string"
+              },
+              "decimals": {
+                "type": "integer"
+              }
+            },
+            "required": [
+              "amountDisplayUnits",
+              "currency",
+              "decimals",
+              "amountAtomic"
+            ],
+            "type": "object"
+          },
+          "protocols": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "route": {
+            "type": "string"
+          },
+          "runtimeChallengeVerified": {
+            "type": "boolean"
+          },
+          "serviceName": {
+            "type": "string"
+          },
+          "source": {
+            "enum": [
+              "agent402",
+              "mpp"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "source",
+          "serviceName",
+          "origin",
+          "method",
+          "route",
+          "price",
+          "description",
+          "decision",
+          "protocols",
+          "runtimeChallengeVerified",
+          "guaranteedPaths"
+        ],
+        "type": "object"
+      },
+      "maxItems": 8,
+      "type": "array"
+    },
+    "rejected": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "findings": {
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 12,
+            "type": "array"
+          },
+          "method": {
+            "$ref": "#/properties/qualified/items/properties/method"
+          },
+          "origin": {
+            "$ref": "#/properties/qualified/items/properties/origin"
+          },
+          "price": {
+            "$ref": "#/properties/qualified/items/properties/price"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "route": {
+            "$ref": "#/properties/qualified/items/properties/route"
+          },
+          "serviceName": {
+            "$ref": "#/properties/qualified/items/properties/serviceName"
+          },
+          "source": {
+            "$ref": "#/properties/qualified/items/properties/source"
+          }
+        },
+        "required": [
+          "source",
+          "serviceName",
+          "origin",
+          "method",
+          "route",
+          "price",
+          "reason",
+          "findings"
+        ],
+        "type": "object"
+      },
+      "maxItems": 8,
+      "type": "array"
+    },
+    "request": {
+      "additionalProperties": false,
+      "properties": {
+        "limit": {
+          "type": "integer"
+        },
+        "maxPriceDisplayUnits": {
+          "type": "number"
+        },
+        "queryDigest": {
+          "pattern": "^sha256:[0-9a-f]{64}$",
+          "type": "string"
+        },
+        "requiredPaths": {
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 16,
+          "minItems": 1,
+          "type": "array"
+        }
+      },
+      "required": [
+        "queryDigest",
+        "requiredPaths",
+        "maxPriceDisplayUnits",
+        "limit"
+      ],
+      "type": "object"
+    },
+    "sources": {
+      "additionalProperties": false,
+      "properties": {
+        "agent402": {
+          "additionalProperties": false,
+          "properties": {
+            "audited": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "discovered": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "status": {
+              "enum": [
+                "ok",
+                "unavailable"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "status",
+            "discovered",
+            "audited"
+          ],
+          "type": "object"
+        },
+        "mpp": {
+          "$ref": "#/properties/sources/properties/agent402"
+        }
+      },
+      "required": [
+        "agent402",
+        "mpp"
+      ],
+      "type": "object"
+    },
+    "version": {
+      "const": "1.1.0",
+      "type": "string"
+    }
+  },
+  "required": [
+    "ok",
+    "product",
+    "version",
+    "checkedAt",
+    "decision",
+    "request",
+    "sources",
+    "qualified",
+    "rejected",
+    "boundary"
+  ],
+  "type": "object"
+}

AddedAug 12, 2026

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and delivers: it discloses pre-audit exclusions (SameDayDesk-owned supply, unresolved routes), the no-credential/no-wallet posture, that it sends no seller POST and reads no paid response body, and returns only a query digest. It also surfaces the payment-challenge binding to a specific GET URL rather than mcp:// and the retry semantics.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and the sibling-routing alternatives are front-loaded, and every sentence carries signal. The trailing payment-binding and retry instructions are operational caveats that slightly pad length but remain relevant, keeping it just short of maximally tight.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be explained, and the description still covers exclusions, safety posture, routing, and credential/retry behavior. For a four-parameter, no-annotation tool, nothing an agent needs to invoke it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all four parameters (limit, query, requiredPaths, maxPriceDisplayUnits) are already fully documented in the schema. The description restates the intent ('capability intent', 'buyer-required JSON response paths') but adds no syntax or format detail beyond the schema, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (Search) and resource (Agent402 and the official MPP catalog for paid machine services) with a clear qualifying scope: capability intent plus guaranteed buyer-required JSON response paths. It is instantly distinguishable from the audit and preflight siblings it names.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes the agent away from this tool by naming three alternatives with the exact condition selecting each: agent_discoverability_audit for one known seller's reach/rank, seller_integrity_audit for a known seller route, and payment_offer_preflight for one exact callable GET URL. Nothing is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All x402-data-gateway tools Inspect

Try in Browser

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.