Hermes Plant — Agent Commerce Assurance

Check a free API key's remaining monthly quota, reset date, and upgrade path. Pass your hp_free_ key as apiKey. No key yet? POST an email to https://hermesplant.com/api/keys/free (250 calls/mo, no wallet).

{
  "type": "object",
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Your free-tier key (hp_free_...)"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

List active products from the Hermes Plant catalog

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Get a single product by slug

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Product slug from the catalog"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Return legal policy URLs required before checkout

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Return the live x402 manifest with paid endpoint prices, Bazaar metadata, and buyer policy checks

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Start a Stripe checkout session for a product slug

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Product slug to purchase"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Purchase a one-time product via x402 (returns 402 challenge or fulfillment JSON). Call get_x402_manifest first, verify method/path/network/amount/payTo, then sign and retry with PAYMENT-SIGNATURE.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "One-time product slug (e.g. destructguard-pro)"
    },
    "email": {
      "description": "Optional email for the order record",
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

AI agent action safety quick gate ($0.01 over x402 or free-tier quota). Deterministically scores a consequential action and returns the exact next call: proceed, request full DestructGuard evidence, or run the complete Action Safety workflow.

{
  "type": "object",
  "properties": {
    "command": {
      "type": "string",
      "description": "Shell, SQL, Git, deploy, or infrastructure action to preflight"
    },
    "repo": {
      "description": "Repository or project context",
      "type": "string"
    },
    "cwd": {
      "description": "Working directory or execution context",
      "type": "string"
    },
    "branch": {
      "description": "Branch or environment context",
      "type": "string"
    },
    "actor": {
      "description": "Agent or tool requesting the action",
      "type": "string"
    },
    "intent": {
      "description": "Why the action is being requested",
      "type": "string"
    },
    "diffStat": {
      "description": "Optional git diff --stat or change summary",
      "type": "string"
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "command"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Complete AI agent action safety workflow ($0.25 over x402 or free-tier quota): DestructGuard evidence, conditional ReviewQueue triage for high or critical risk, an honest decision, signed receipt, and 30-day status record. Triage does not imply human approval.

{
  "type": "object",
  "properties": {
    "command": {
      "type": "string",
      "description": "Shell, SQL, Git, deploy, or infrastructure action to preflight"
    },
    "repo": {
      "description": "Repository or project context",
      "type": "string"
    },
    "cwd": {
      "description": "Working directory or execution context",
      "type": "string"
    },
    "branch": {
      "description": "Branch or environment context",
      "type": "string"
    },
    "actor": {
      "description": "Agent or tool requesting the action",
      "type": "string"
    },
    "intent": {
      "description": "Why the action is being requested",
      "type": "string"
    },
    "diffStat": {
      "description": "Optional git diff --stat or change summary",
      "type": "string"
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "command"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Submit a command/action to the x402-paid ReviewQueue agent service. Call get_x402_manifest first, verify the ReviewQueue price and buyer policy, then retry the 402 challenge with an x402 payment signature.

{
  "type": "object",
  "properties": {
    "command": {
      "type": "string",
      "description": "Command or agent action being requested"
    },
    "repo": {
      "description": "Repository or project context",
      "type": "string"
    },
    "branch": {
      "description": "Branch or environment context",
      "type": "string"
    },
    "actor": {
      "description": "Agent/tool requesting the action",
      "type": "string"
    },
    "reason": {
      "description": "Why the action is being requested",
      "type": "string"
    },
    "diffStat": {
      "description": "Optional git diff --stat or change summary",
      "type": "string"
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "command"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Score a command/action with the x402-paid DestructGuard service. Call get_x402_manifest first, verify the DestructGuard price and buyer policy, then retry the 402 challenge with an x402 payment signature.

{
  "type": "object",
  "properties": {
    "command": {
      "type": "string",
      "description": "Command or agent action to score"
    },
    "repo": {
      "description": "Repository or project context",
      "type": "string"
    },
    "cwd": {
      "description": "Working directory or execution context",
      "type": "string"
    },
    "actor": {
      "description": "Agent/tool requesting the action",
      "type": "string"
    },
    "intent": {
      "description": "Why the command is being requested",
      "type": "string"
    },
    "diffStat": {
      "description": "Optional git diff --stat or change summary",
      "type": "string"
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "command"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

DealAnalyzer (x402-paid, $2.00): the flagship. Deterministic full deal underwrite in a single call — DCF valuation (EV, equity value, implied share price), fund returns (IRR/MOIC), and the LP/GP distribution waterfall, plus sensitivity. Combines what CashflowLens + WaterfallLens do, cross-checked.

{
  "type": "object",
  "properties": {
    "dcf": {
      "type": "object",
      "properties": {
        "cashflows": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Projected free cash flows"
        },
        "discountRate": {
          "type": "number",
          "description": "Annual discount rate, e.g. 0.11"
        },
        "terminalGrowth": {
          "description": "Gordon-growth terminal rate",
          "type": "number"
        },
        "exitMultiple": {
          "description": "Exit multiple on final year",
          "type": "number"
        },
        "netDebt": {
          "description": "Net debt to bridge EV to equity",
          "type": "number"
        },
        "shares": {
          "description": "Shares outstanding for per-share value",
          "type": "number"
        }
      },
      "required": [
        "cashflows",
        "discountRate"
      ],
      "description": "Required. DCF valuation inputs."
    },
    "returns": {
      "description": "Optional fund/deal return inputs (IRR, MOIC, NPV).",
      "type": "object",
      "properties": {
        "cashflows": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Investment cashflows (outflows negative)"
        },
        "discountRate": {
          "description": "Annual rate for NPV",
          "type": "number"
        }
      },
      "required": [
        "cashflows"
      ]
    },
    "waterfall": {
      "description": "Optional LP/GP distribution waterfall inputs.",
      "type": "object",
      "properties": {
        "contributedCapital": {
          "type": "number"
        },
        "carryPercentage": {
          "type": "number"
        },
        "catchUpPercentage": {
          "type": "number"
        },
        "preferredRate": {
          "type": "number"
        },
        "preferredReturnAmount": {
          "type": "number"
        },
        "years": {
          "type": "number"
        }
      },
      "required": [
        "contributedCapital"
      ]
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "dcf"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

CashflowLens (x402-paid, $0.20): deterministic NPV, IRR, XIRR, DCF valuation, MOIC/DPI/TVPI, and payback period from a cashflow series. Use for valuation and return analysis instead of letting the model estimate.

{
  "type": "object",
  "properties": {
    "cashflows": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "object",
            "properties": {
              "amount": {
                "type": "number"
              },
              "date": {
                "type": "string"
              },
              "label": {
                "type": "string"
              }
            },
            "required": [
              "amount"
            ]
          }
        ]
      },
      "description": "Cashflows: numbers for periodic, or {amount,date} objects for dated XIRR. Outflows negative."
    },
    "discountRate": {
      "description": "Annual rate for NPV, e.g. 0.08",
      "type": "number"
    },
    "periodsPerYear": {
      "description": "Periods per year to annualize a periodic IRR",
      "type": "number"
    },
    "nav": {
      "description": "Residual value, for TVPI",
      "type": "number"
    },
    "dcf": {
      "description": "Optional DCF valuation inputs (projected FCFs, discount rate, terminal value, net debt, shares)",
      "type": "object",
      "properties": {
        "cashflows": {
          "type": "array",
          "items": {
            "type": "number"
          }
        },
        "discountRate": {
          "type": "number"
        },
        "terminalGrowth": {
          "type": "number"
        },
        "exitMultiple": {
          "type": "number"
        },
        "netDebt": {
          "type": "number"
        },
        "shares": {
          "type": "number"
        }
      },
      "required": [
        "cashflows",
        "discountRate"
      ]
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "cashflows"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

WaterfallLens (x402-paid, $0.30): deterministic LP/GP distribution waterfall (return of capital, preferred, GP catch-up, carried-interest split) with the exact split, per-tier breakdown, LP MOIC, and effective carry %.

{
  "type": "object",
  "properties": {
    "contributedCapital": {
      "type": "number",
      "description": "Total LP capital to return in tier 1"
    },
    "distributable": {
      "type": "number",
      "description": "Total cash to distribute"
    },
    "carryPercentage": {
      "description": "GP carry, e.g. 0.20 (default 0.20)",
      "type": "number"
    },
    "catchUpPercentage": {
      "description": "GP catch-up share, 1.0 = full (default)",
      "type": "number"
    },
    "preferredReturnAmount": {
      "description": "Explicit preferred return amount",
      "type": "number"
    },
    "preferredRate": {
      "description": "Annual preferred rate, e.g. 0.08",
      "type": "number"
    },
    "years": {
      "description": "Holding period for preferred accrual",
      "type": "number"
    },
    "compounding": {
      "description": "Preferred-return accrual basis: 'simple' or 'compounded' (default compounded)",
      "type": "string",
      "enum": [
        "simple",
        "compounded"
      ]
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "contributedCapital",
    "distributable"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

OptionLens (x402-paid, $0.30): deterministic Black-Scholes price and full Greeks (delta, gamma, vega, theta, rho) for European calls/puts, with dividend yield, intrinsic/time value, and moneyness.

{
  "type": "object",
  "properties": {
    "spot": {
      "type": "number",
      "description": "Underlying price (> 0)"
    },
    "strike": {
      "type": "number",
      "description": "Strike price (> 0)"
    },
    "timeToExpiry": {
      "type": "number",
      "description": "Years to expiry, e.g. 0.5"
    },
    "volatility": {
      "type": "number",
      "description": "Annualized volatility, e.g. 0.2"
    },
    "riskFreeRate": {
      "description": "Annual risk-free rate, default 0",
      "type": "number"
    },
    "dividendYield": {
      "description": "Continuous dividend yield, default 0",
      "type": "number"
    },
    "optionType": {
      "description": "Option type, 'call' or 'put' (default call)",
      "type": "string",
      "enum": [
        "call",
        "put"
      ]
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "spot",
    "strike",
    "timeToExpiry",
    "volatility"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

BondLens (x402-paid, $0.25): deterministic fixed-income and loan analytics. Bond mode solves price<->yield-to-maturity, duration, and convexity; loan mode (send principal+annualRate+termMonths) returns an amortization schedule.

{
  "type": "object",
  "properties": {
    "faceValue": {
      "description": "Bond face value (default 1000)",
      "type": "number"
    },
    "couponRate": {
      "description": "Annual coupon rate, e.g. 0.05",
      "type": "number"
    },
    "periods": {
      "description": "Periods to maturity",
      "type": "number"
    },
    "frequency": {
      "description": "Coupons per year (default 2)",
      "type": "number"
    },
    "price": {
      "description": "Bond price; supply to solve yield",
      "type": "number"
    },
    "yield": {
      "description": "Annual yield; supply to solve price",
      "type": "number"
    },
    "principal": {
      "description": "Loan principal (selects loan mode)",
      "type": "number"
    },
    "annualRate": {
      "description": "Loan annual rate, e.g. 0.06",
      "type": "number"
    },
    "termMonths": {
      "description": "Loan term in months",
      "type": "number"
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

PortfolioGuard (x402-paid, $0.15): deterministic portfolio risk scoring from holdings — volatility, Sharpe, max drawdown, concentration (HHI), diversification, plus per-rule findings.

{
  "type": "object",
  "properties": {
    "holdings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string"
          },
          "weight": {
            "type": "number"
          },
          "returns": {
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "sector": {
            "type": "string"
          },
          "assetClass": {
            "type": "string"
          }
        },
        "required": [
          "symbol",
          "weight"
        ]
      },
      "description": "Positions with symbol, weight (0-1), optional returns[], sector"
    },
    "periodReturns": {
      "description": "Optional portfolio/market return series",
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "riskFreeRate": {
      "description": "Optional risk-free rate for the Sharpe ratio (default 0)",
      "type": "number"
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "holdings"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

WalletGuard (x402-paid, $0.10): analyzes caller-provided sanctions, exposures, labels, and funding context. Positive risk findings receive a score; no risk findings means unknown with a null score and review required. No chain lookup, independent sanctions screening, or compliance clearance.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet address"
    },
    "labels": {
      "description": "Address labels, e.g. exchange:binance, contract:..., sanctions:...",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "exposures": {
      "description": "Signals e.g. mixer:tornado, sanctions:ofac",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sanctionsHits": {
      "description": "Sanctions / OFAC / blacklist hit identifiers",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "transfers": {
      "description": "Optional transfer summaries (direction, value, counterparty, tags)",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "direction": {
            "type": "string",
            "enum": [
              "in",
              "out"
            ]
          },
          "valueUsd": {
            "type": "number"
          },
          "counterparty": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "direction"
        ]
      }
    },
    "fundingSources": {
      "description": "Optional fund-source breakdown (source, share 0-1, verified)",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "string"
          },
          "share": {
            "type": "number"
          },
          "verified": {
            "type": "boolean"
          },
          "labels": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "source",
          "share",
          "verified"
        ]
      }
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

EmailGuard (x402-paid, $0.02): deterministic email/contact quality scorer — validity, deliverability score, disposable/role/free classification, typo suggestion. Pure function, no DNS.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address to validate"
    },
    "name": {
      "description": "Optional contact name associated with the email",
      "type": "string"
    },
    "domain": {
      "description": "Optional explicit domain hint (usually derived from email)",
      "type": "string"
    },
    "mxPresent": {
      "description": "Caller-supplied MX hint",
      "type": "boolean"
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "email"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Validate up to 20 emails in one tool call — one deterministic verdict per record (validity, deliverability score, disposable/role/free classification, typo suggestion, canonical normalization). Pass your free apiKey (250 records/mo, no wallet — https://hermesplant.com/pricing) and each record serves from quota. Results preserve input order; the batch stops at the first 402 (quota exhausted) and marks the rest skipped so you can upgrade and resume.

{
  "type": "object",
  "properties": {
    "records": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "Email address to validate"
          },
          "name": {
            "description": "Optional contact name",
            "type": "string"
          }
        },
        "required": [
          "email"
        ]
      },
      "description": "Contact records to validate — one storefront call per record (max 20 per tool call)"
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "records"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

MCP Server Risk Analyzer (x402-paid, $0.05): score an MCP server manifest for security risk before install — destructive tools, over-broad scopes, weak auth, egress — with per-tool findings and fixes.

{
  "type": "object",
  "properties": {
    "tools": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "permissions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "network": {
            "type": "boolean"
          }
        },
        "required": [
          "name"
        ]
      },
      "description": "The MCP server's tool manifest"
    },
    "server": {
      "description": "Server name/URL",
      "type": "string"
    },
    "authModel": {
      "description": "e.g. oauth, token, none",
      "type": "string"
    },
    "priorTools": {
      "description": "Prior tool names to diff capability growth",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "tools"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Payment Policy Decision (x402-paid, $0.05): deterministic allow / deny / needs_review before your agent signs an x402 payment — checks resource binding, amount vs expected price, network, payTo, facilitator, replay readiness, PII leakage, and buyer spend limits, with evidence-backed findings. Loop it over every payment; pair with assurance_attest for a signed record.

{
  "type": "object",
  "properties": {
    "resourceUrl": {
      "type": "string",
      "description": "Absolute resource URL from the x402 challenge or Bazaar listing"
    },
    "method": {
      "description": "HTTP method the agent intends to call",
      "type": "string"
    },
    "scheme": {
      "description": "x402 payment scheme (exact expected)",
      "type": "string"
    },
    "network": {
      "description": "Payment network, e.g. eip155:8453",
      "type": "string"
    },
    "asset": {
      "description": "Payment asset address",
      "type": "string"
    },
    "amountUnits": {
      "description": "Raw x402 amount units (USDC = 6 decimals)",
      "type": "string"
    },
    "payTo": {
      "description": "Payment recipient from the challenge",
      "type": "string"
    },
    "facilitatorUrl": {
      "description": "Facilitator URL used to settle",
      "type": "string"
    },
    "maxTimeoutSeconds": {
      "description": "Challenge timeout window",
      "type": "number"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "tags": {
      "description": "Bazaar/service tags for sensitive-category detection",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "buyerPolicy": {
      "description": "Buyer guardrails: maxUsdPerCall, allowedNetworks, allowedPayTo, allowedHosts, requireExactScheme, requireHttps, ...",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "serviceRisk": {
      "description": "Optional upstream service-risk result (e.g. from mcp_risk_score)",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "resourceUrl"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Evidence Verification (x402-paid, $0.05): verify an agent-commerce evidence bundle before trusting a paid result — x402 challenge/receipt/policy-decision/service-response artifacts, endpoint and price binding, freshness, hashes, synthetic-proof leakage. Returns verified / needs_review / rejected / insufficient_evidence with per-rule evidence.

{
  "type": "object",
  "properties": {
    "artifacts": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      },
      "description": "Evidence artifacts (Hermes contract): x402_challenge, x402_receipt, payment_policy_decision, service_response, ..."
    },
    "subject": {
      "description": "Optional run subject: kind, serviceId, endpoint, method, runId",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "policy": {
      "description": "Verification policy: expected serviceId/endpoint/network/priceCents, require* flags",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "artifacts"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Assurance Attest (x402-paid, $0.05): bind one x402 payment intent or MCP tool call to a canonical HMAC-signed record (binding hash, policy verdict, findings, optional settlement outcome). Loop it after every payment or tool call to build a tamper-evident audit trail a third party can check at the free verify endpoint.

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string",
      "enum": [
        "x402",
        "mcp"
      ],
      "description": "\"x402\" for a payment, \"mcp\" for a tool call"
    },
    "subject": {
      "type": "object",
      "properties": {
        "runId": {
          "type": "string",
          "description": "Agent run id"
        },
        "agentId": {
          "type": "string"
        },
        "purpose": {
          "type": "string"
        }
      },
      "required": [
        "runId"
      ],
      "description": "Who acted and why"
    },
    "intent": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "x402: resourceUrl+method (+scheme/network/asset/amountUnits/payTo/settlement fields). mcp: serverId+toolName (+toolArguments or toolArgumentsHash)."
    },
    "policy": {
      "description": "Optional buyer policy (policyId+version, caps, allow-lists); omit for binding-only attestation",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "outcome": {
      "description": "Optional settlement outcome: {outcome: fulfilled|failed|rejected, settlementId, responseStatus, evidenceHashes[]}",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "apiKey": {
      "description": "Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing.",
      "type": "string"
    },
    "paymentSignature": {
      "description": "x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry",
      "type": "string"
    },
    "xPayment": {
      "description": "Raw X-PAYMENT proof from an x402-compatible wallet/client",
      "type": "string"
    },
    "paymentIdentifier": {
      "description": "Optional x402 payment identifier for idempotency/retry correlation",
      "type": "string"
    },
    "synthetic": {
      "description": "Mark this paid retry as an internal test/probe for analytics exclusion",
      "type": "boolean"
    },
    "channel": {
      "description": "Discovery channel or source tag",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign tag for downstream telemetry",
      "type": "string"
    },
    "actorType": {
      "description": "Caller type for analytics: agent, human, synthetic, system, or unknown",
      "type": "string",
      "enum": [
        "agent",
        "human",
        "synthetic",
        "system",
        "unknown"
      ]
    },
    "payer": {
      "description": "Optional wallet/account identifier; stored only as a hash",
      "type": "string"
    }
  },
  "required": [
    "protocol",
    "subject",
    "intent"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Verify a Hermes-signed assurance record for free: recomputes the canonical hash (hermes-stable-json-v1 + SHA-256) and HMAC signature server-side and reports recordHashValid / signatureValid. Use it to audit attestations produced by assurance_attest without trusting the agent that produced them.

{
  "type": "object",
  "properties": {
    "record": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "The attestation/decision/receipt record object"
    },
    "integrity": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "The integrity object returned with the record (recordHash, signature, keyId)"
    }
  },
  "required": [
    "record",
    "integrity"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the upstream storefront call returned a 2xx response"
    },
    "httpStatus": {
      "type": "number",
      "description": "Upstream HTTP status code"
    },
    "paymentRequired": {
      "description": "True when the response is an x402 HTTP 402 payment challenge",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "httpStatus"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}