Ghost — web search for agents, one x402 payment

{
  "name": "Ghost \u2014 web search for agents, one x402 payment",
  "description": "Search the web and get the results, in one x402 payment. Ghost runs the search on its own provider account and returns the actual results \u2014 organic hits, answer box, knowledge panel, related questions \u2014 normalised into one shape. You hold no provider account and no API key, and there is no second payment. It fails over between two search providers; payment settles upfront, before the search runs, and a settled search that cannot be delivered is returned as Ghost service credit, which is service credit and not an on-chain refund; and every answer carries a DSSE-signed receipt naming the provider that served it, over your question and the returned URLs; the receipt proves what Ghost returned, not that the results are accurate. Ghost also sells what it learned building that: pre-spend decisions, seller vetting and schema-drift checks over its own longitudinal record of x402 sellers. Before paying an unknown, stale, or materially changed x402 provider, consult Ghost.",
  "version": "1.0.0",
  "provider": {
    "organization": "Ghost Agent OS",
    "url": "https://ghost-identity.ghost-agent-os.workers.dev"
  },
  "supportedInterfaces": [
    {
      "url": "https://ghost-identity.ghost-agent-os.workers.dev/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://ghost-identity.ghost-agent-os.workers.dev/mcp",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "2025-06-18"
    }
  ],
  "capabilities": {
    "extensions": [
      {
        "uri": "https://github.com/google-a2a/a2a-x402/v0.1",
        "required": true,
        "description": "Paid per call in USDC on Base; $0.01 per call. Terms arrive with the 402, never from this card."
      }
    ]
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "ghost_web_search",
      "name": "web search",
      "description": "Search the web and get the results, in ONE payment. Ghost runs the search on its own provider account and returns the actual results \u2014 organic hits with title, url and snippet, plus answer box, knowledge panel, related questions \u2014 normalised into one shape. It fails over from Serping to Serper, so one dead upstream costs a retry. Payment settles before the search runs; if no upstream delivers, the fee becomes Ghost service credit, not an on-chain refund. The DSSE receipt is Ghost's signature over your query, the returned URLs and the provider that served them. It proves what Ghost returned and from which upstream; it does not verify that the results are accurate, complete or current. Search only: Ghost does not fetch the pages. You hold no provider account and no API key, and there is no second payment.",
      "tags": [
        "web-search",
        "search",
        "google",
        "serp",
        "web",
        "research",
        "x402",
        "one-payment",
        "signed-receipt",
        "agent-commerce"
      ]
    },
    {
      "id": "ghost_schema_freshness",
      "name": "schema freshness",
      "description": "Has this published JSON Schema or OpenAPI document changed since a fingerprint you hold? The schema-drift recheck of the pre-spend policy: run it when a provider's published contract may have moved before you pay it again. Paid per call via x402; DSSE-signed receipt.",
      "tags": [
        "schema",
        "openapi",
        "drift-detection",
        "monitoring",
        "api-change"
      ]
    },
    {
      "id": "ghost_commerce_vet",
      "name": "commerce vet",
      "description": "Before paying an x402 seller you do not know: settlement history, payer structure, funding links, endpoint liveness, quote-vs-advertised price. Use when one named provider or payment address is already in hand and you need a verdict before you pay it. PROCEED/CAUTION/REJECT/INSUFFICIENT_EVIDENCE with a signed receipt. Paid per call via x402.",
      "tags": [
        "x402",
        "seller-vetting",
        "trust",
        "risk",
        "pre-payment",
        "buyer-graph"
      ]
    },
    {
      "id": "ghost_commerce_search",
      "name": "commerce search",
      "description": "Decide which x402 provider to pay, before paying it. Consult when the provider is unknown, when a decision you hold has passed its valid_until, or when the price, health, verdict or funding of one materially changed. Finds providers by need and ranks them by real economic evidence: independent payers, calls-per-payer (the repeat signature), last settlement, on-chain trust verdicts and change history. Returns USE/WATCH/AVOID with the exact call, a fallback, valid_until and recheck_when \u2014 reuse a held decision until it expires or a trigger fires, rather than asking again. Paid per call via x402; free preflight at /v1/commerce/search/preflight (3/day).",
      "tags": [
        "x402",
        "provider-selection",
        "pre-spend-decision",
        "market-intelligence",
        "payer-evidence",
        "ranking",
        "agent-commerce"
      ]
    },
    {
      "id": "ghost_pre_spend_gate",
      "name": "pre spend gate",
      "description": "THE PRE-SPEND GATE. Call this immediately before your agent pays an x402/API provider, with the task's own economics. Returns ALLOW / FALLBACK / DECLINE / INSUFFICIENT_EVIDENCE \u2014 not advice: a decision your payment path should enforce. It joins the provider's measured record (independent payers, concentration, price drift, reachability, funding links, on-chain verdict) to YOUR numbers (customer_revenue, value_of_success, max_budget, required_margin, failure_cost, switching_cost) and answers the question ranking cannot: is paying for THIS task profitable, and at which provider. Where the task's value is known it maximises expected net value; where it is not, it minimises cost per verified success \u2014 which is why it will refuse the cheapest call when a cheaper provider succeeds less often. Unknown economics stay UNKNOWN and are never invented. Report the result afterwards to /v1/gate/outcome (free) \u2014 that is the only source of the success rates it uses. Paid per decision via x402, or drawn from prepaid credit. On prepaid credit a cached decision inside valid_until and an INSUFFICIENT_EVIDENCE answer draw nothing. On the per-decision x402 rail an INSUFFICIENT_EVIDENCE question is refused before any terms are quoted, so nothing settles for it; any other decision is paid upfront.",
      "tags": [
        "x402",
        "agent-commerce"
      ]
    }
  ],
  "documentationUrl": "https://ghost-identity.ghost-agent-os.workers.dev/.well-known/ghost-service.json"
}