Serveur MCP

Hermes Plant — Agent Commerce Assurance

io.github.JesseGdotIO/hermes-plant

Ce que fait ce MCP

Preflights and attests consequential agent actions, verifies signed evidence, evaluates payments and wallets, and provides deterministic financial analytics.

action_safety_quick_gate
Action Safety - one-cent preflight
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['command'], 'properties': {'cwd': {'type': 'string', 'description': 'Working directory or execution context'}, 'repo': {'type': 'string', 'description': 'Repository or project context'}, 'actor': {'type': 'string', 'description': 'Agent or tool requesting the action'}, 'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'branch': {'type': 'string', 'description': 'Branch or environment context'}, 'intent': {'type': 'string', 'description': 'Why the action is being requested'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'command': {'type': 'string', 'description': 'Shell, SQL, Git, deploy, or infrastructure action to preflight'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'diffStat': {'type': 'string', 'description': 'Optional git diff --stat or change summary'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
action_safety_run
Action Safety - complete workflow
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['command'], 'properties': {'cwd': {'type': 'string', 'description': 'Working directory or execution context'}, 'repo': {'type': 'string', 'description': 'Repository or project context'}, 'actor': {'type': 'string', 'description': 'Agent or tool requesting the action'}, 'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'branch': {'type': 'string', 'description': 'Branch or environment context'}, 'intent': {'type': 'string', 'description': 'Why the action is being requested'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'command': {'type': 'string', 'description': 'Shell, SQL, Git, deploy, or infrastructure action to preflight'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'diffStat': {'type': 'string', 'description': 'Optional git diff --stat or change summary'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
assurance_attest
Assurance Attest — signed receipt for an agent action
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['protocol', 'subject', 'intent'], 'properties': {'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'intent': {'type': 'object', 'description': 'x402: resourceUrl+method (+scheme/network/asset/amountUnits/payTo/settlement fields). mcp: serverId+toolName (+toolArguments or toolArgumentsHash).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'policy': {'type': 'object', 'description': 'Optional buyer policy (policyId+version, caps, allow-lists); omit for binding-only attestation', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'outcome': {'type': 'object', 'description': 'Optional settlement outcome: {outcome: fulfilled|failed|rejected, settlementId, responseStatus, evidenceHashes[]}', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'subject': {'type': 'object', 'required': ['runId'], 'properties': {'runId': {'type': 'string', 'description': 'Agent run id'}, 'agentId': {'type': 'string'}, 'purpose': {'type': 'string'}}, 'description': 'Who acted and why'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'protocol': {'enum': ['x402', 'mcp'], 'type': 'string', 'description': '"x402" for a payment, "mcp" for a tool call'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
assurance_verify
Assurance Verify — check a signed record (free)
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['record', 'integrity'], 'properties': {'record': {'type': 'object', 'description': 'The attestation/decision/receipt record object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'integrity': {'type': 'object', 'description': 'The integrity object returned with the record (recordHash, signature, keyId)', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
bond_analyze
BondLens — bond & loan analytics
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'price': {'type': 'number', 'description': 'Bond price; supply to solve yield'}, 'yield': {'type': 'number', 'description': 'Annual yield; supply to solve price'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'periods': {'type': 'number', 'description': 'Periods to maturity'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'faceValue': {'type': 'number', 'description': 'Bond face value (default 1000)'}, 'frequency': {'type': 'number', 'description': 'Coupons per year (default 2)'}, 'principal': {'type': 'number', 'description': 'Loan principal (selects loan mode)'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'annualRate': {'type': 'number', 'description': 'Loan annual rate, e.g. 0.06'}, 'couponRate': {'type': 'number', 'description': 'Annual coupon rate, e.g. 0.05'}, 'termMonths': {'type': 'number', 'description': 'Loan term in months'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
cashflowlens_analyze
CashflowLens — DCF, IRR & cashflow returns
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['cashflows'], 'properties': {'dcf': {'type': 'object', 'required': ['cashflows', 'discountRate'], 'properties': {'shares': {'type': 'number'}, 'netDebt': {'type': 'number'}, 'cashflows': {'type': 'array', 'items': {'type': 'number'}}, 'discountRate': {'type': 'number'}, 'exitMultiple': {'type': 'number'}, 'terminalGrowth': {'type': 'number'}}, 'description': 'Optional DCF valuation inputs (projected FCFs, discount rate, terminal value, net debt, shares)'}, 'nav': {'type': 'number', 'description': 'Residual value, for TVPI'}, 'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'cashflows': {'type': 'array', 'items': {'anyOf': [{'type': 'number'}, {'type': 'object', 'required': ['amount'], 'properties': {'date': {'type': 'string'}, 'label': {'type': 'string'}, 'amount': {'type': 'number'}}}]}, 'description': 'Cashflows: numbers for periodic, or {amount,date} objects for dated XIRR. Outflows negative.'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'discountRate': {'type': 'number', 'description': 'Annual rate for NPV, e.g. 0.08'}, 'periodsPerYear': {'type': 'number', 'description': 'Periods per year to annualize a periodic IRR'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
dealanalyzer_analyze
DealAnalyzer — full deal underwriting in one call
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['dcf'], 'properties': {'dcf': {'type': 'object', 'required': ['cashflows', 'discountRate'], 'properties': {'shares': {'type': 'number', 'description': 'Shares outstanding for per-share value'}, 'netDebt': {'type': 'number', 'description': 'Net debt to bridge EV to equity'}, 'cashflows': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Projected free cash flows'}, 'discountRate': {'type': 'number', 'description': 'Annual discount rate, e.g. 0.11'}, 'exitMultiple': {'type': 'number', 'description': 'Exit multiple on final year'}, 'terminalGrowth': {'type': 'number', 'description': 'Gordon-growth terminal rate'}}, 'description': 'Required. DCF valuation inputs.'}, 'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'returns': {'type': 'object', 'required': ['cashflows'], 'properties': {'cashflows': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Investment cashflows (outflows negative)'}, 'discountRate': {'type': 'number', 'description': 'Annual rate for NPV'}}, 'description': 'Optional fund/deal return inputs (IRR, MOIC, NPV).'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'waterfall': {'type': 'object', 'required': ['contributedCapital'], 'properties': {'years': {'type': 'number'}, 'preferredRate': {'type': 'number'}, 'carryPercentage': {'type': 'number'}, 'catchUpPercentage': {'type': 'number'}, 'contributedCapital': {'type': 'number'}, 'preferredReturnAmount': {'type': 'number'}}, 'description': 'Optional LP/GP distribution waterfall inputs.'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
emailguard_validate
EmailGuard — email validation
EmailGuard (x402-paid, $0.02): deterministic email/contact quality scorer — validity, deliverability score, disposable/role/free classification, typo suggestion. Pure function, no DNS.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['email'], 'properties': {'name': {'type': 'string', 'description': 'Optional contact name associated with the email'}, 'email': {'type': 'string', 'description': 'Email address to validate'}, 'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'domain': {'type': 'string', 'description': 'Optional explicit domain hint (usually derived from email)'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'mxPresent': {'type': 'boolean', 'description': 'Caller-supplied MX hint'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
emailguard_validate_batch
EmailGuard — validate a whole contact list
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['records'], 'properties': {'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'records': {'type': 'array', 'items': {'type': 'object', 'required': ['email'], 'properties': {'name': {'type': 'string', 'description': 'Optional contact name'}, 'email': {'type': 'string', 'description': 'Email address to validate'}}}, 'maxItems': 20, 'minItems': 1, 'description': 'Contact records to validate â\x80\x94 one storefront call per record (max 20 per tool call)'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
evidence_verify
Evidence Verify — check a paid result's evidence bundle
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['artifacts'], 'properties': {'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'policy': {'type': 'object', 'description': 'Verification policy: expected serviceId/endpoint/network/priceCents, require* flags', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'subject': {'type': 'object', 'description': 'Optional run subject: kind, serviceId, endpoint, method, runId', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'artifacts': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'minItems': 1, 'description': 'Evidence artifacts (Hermes contract): x402_challenge, x402_receipt, payment_policy_decision, service_response, ...'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
freetier_status
Free-tier key status
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).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey'], 'properties': {'apiKey': {'type': 'string', 'description': 'Your free-tier key (hp_free_...)'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
get_checkout_policies
Get checkout policies
Return legal policy URLs required before checkout
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
get_product
Get product
Get a single product by slug
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Product slug from the catalog'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
get_x402_manifest
Get x402 manifest
Return the live x402 manifest with paid endpoint prices, Bazaar metadata, and buyer policy checks
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
list_products
List products
List active products from the Hermes Plant catalog
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
mcp_risk_score
MCP Server Risk Analyzer
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tools'], 'properties': {'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'tools': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string'}, 'scopes': {'type': 'array', 'items': {'type': 'string'}}, 'network': {'type': 'boolean'}, 'description': {'type': 'string'}, 'permissions': {'type': 'array', 'items': {'type': 'string'}}}}, 'description': "The MCP server's tool manifest"}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'server': {'type': 'string', 'description': 'Server name/URL'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'authModel': {'type': 'string', 'description': 'e.g. oauth, token, none'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'priorTools': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Prior tool names to diff capability growth'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
options_price
OptionLens — Black-Scholes price & Greeks
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['spot', 'strike', 'timeToExpiry', 'volatility'], 'properties': {'spot': {'type': 'number', 'description': 'Underlying price (> 0)'}, 'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'strike': {'type': 'number', 'description': 'Strike price (> 0)'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'optionType': {'enum': ['call', 'put'], 'type': 'string', 'description': "Option type, 'call' or 'put' (default call)"}, 'volatility': {'type': 'number', 'description': 'Annualized volatility, e.g. 0.2'}, 'riskFreeRate': {'type': 'number', 'description': 'Annual risk-free rate, default 0'}, 'timeToExpiry': {'type': 'number', 'description': 'Years to expiry, e.g. 0.5'}, 'dividendYield': {'type': 'number', 'description': 'Continuous dividend yield, default 0'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
payment_policy_decide
Payment Policy — preflight an x402 payment
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['resourceUrl'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Bazaar/service tags for sensitive-category detection'}, 'asset': {'type': 'string', 'description': 'Payment asset address'}, 'payTo': {'type': 'string', 'description': 'Payment recipient from the challenge'}, 'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'method': {'type': 'string', 'description': 'HTTP method the agent intends to call'}, 'scheme': {'type': 'string', 'description': 'x402 payment scheme (exact expected)'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'network': {'type': 'string', 'description': 'Payment network, e.g. eip155:8453'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'amountUnits': {'type': 'string', 'description': 'Raw x402 amount units (USDC = 6 decimals)'}, 'buyerPolicy': {'type': 'object', 'description': 'Buyer guardrails: maxUsdPerCall, allowedNetworks, allowedPayTo, allowedHosts, requireExactScheme, requireHttps, ...', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'resourceUrl': {'type': 'string', 'description': 'Absolute resource URL from the x402 challenge or Bazaar listing'}, 'serviceRisk': {'type': 'object', 'description': 'Optional upstream service-risk result (e.g. from mcp_risk_score)', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'facilitatorUrl': {'type': 'string', 'description': 'Facilitator URL used to settle'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'maxTimeoutSeconds': {'type': 'number', 'description': 'Challenge timeout window'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
portfolioguard_score
PortfolioGuard — portfolio risk
PortfolioGuard (x402-paid, $0.15): deterministic portfolio risk scoring from holdings — volatility, Sharpe, max drawdown, concentration (HHI), diversification, plus per-rule findings.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['holdings'], 'properties': {'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'holdings': {'type': 'array', 'items': {'type': 'object', 'required': ['symbol', 'weight'], 'properties': {'sector': {'type': 'string'}, 'symbol': {'type': 'string'}, 'weight': {'type': 'number'}, 'returns': {'type': 'array', 'items': {'type': 'number'}}, 'assetClass': {'type': 'string'}}}, 'description': 'Positions with symbol, weight (0-1), optional returns[], sector'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'riskFreeRate': {'type': 'number', 'description': 'Optional risk-free rate for the Sharpe ratio (default 0)'}, 'periodReturns': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Optional portfolio/market return series'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
purchase_with_x402
Purchase with x402
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.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'One-time product slug (e.g. destructguard-pro)'}, 'email': {'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,}$", 'description': 'Optional email for the order record'}, 'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
score_destructguard_command
DestructGuard — score command risk
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['command'], 'properties': {'cwd': {'type': 'string', 'description': 'Working directory or execution context'}, 'repo': {'type': 'string', 'description': 'Repository or project context'}, 'actor': {'type': 'string', 'description': 'Agent/tool requesting the action'}, 'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'intent': {'type': 'string', 'description': 'Why the command is being requested'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'command': {'type': 'string', 'description': 'Command or agent action to score'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'diffStat': {'type': 'string', 'description': 'Optional git diff --stat or change summary'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
start_checkout
Start checkout
Start a Stripe checkout session for a product slug
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Product slug to purchase'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
submit_reviewqueue_request
ReviewQueue — submit for risk triage
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['command'], 'properties': {'repo': {'type': 'string', 'description': 'Repository or project context'}, 'actor': {'type': 'string', 'description': 'Agent/tool requesting the action'}, 'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'branch': {'type': 'string', 'description': 'Branch or environment context'}, 'reason': {'type': 'string', 'description': 'Why the action is being requested'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'command': {'type': 'string', 'description': 'Command or agent action being requested'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'diffStat': {'type': 'string', 'description': 'Optional git diff --stat or change summary'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
walletguard_score
WalletGuard — supplied wallet risk signals
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['wallet'], 'properties': {'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'labels': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Address labels, e.g. exchange:binance, contract:..., sanctions:...'}, 'wallet': {'type': 'string', 'description': 'Wallet address'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'exposures': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Signals e.g. mixer:tornado, sanctions:ofac'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'transfers': {'type': 'array', 'items': {'type': 'object', 'required': ['direction'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}}, 'valueUsd': {'type': 'number'}, 'direction': {'enum': ['in', 'out'], 'type': 'string'}, 'counterparty': {'type': 'string'}}}, 'description': 'Optional transfer summaries (direction, value, counterparty, tags)'}, 'sanctionsHits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Sanctions / OFAC / blacklist hit identifiers'}, 'fundingSources': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'share', 'verified'], 'properties': {'share': {'type': 'number'}, 'labels': {'type': 'array', 'items': {'type': 'string'}}, 'source': {'type': 'string'}, 'verified': {'type': 'boolean'}}}, 'description': 'Optional fund-source breakdown (source, share 0-1, verified)'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
waterfall_distribute
WaterfallLens — LP/GP distribution waterfall
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 %.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['contributedCapital', 'distributable'], 'properties': {'payer': {'type': 'string', 'description': 'Optional wallet/account identifier; stored only as a hash'}, 'years': {'type': 'number', 'description': 'Holding period for preferred accrual'}, 'apiKey': {'type': 'string', 'description': 'Free-tier / plan API key (hp_free_â\x80¦ 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.'}, 'channel': {'type': 'string', 'description': 'Discovery channel or source tag'}, 'campaign': {'type': 'string', 'description': 'Campaign tag for downstream telemetry'}, 'xPayment': {'type': 'string', 'description': 'Raw X-PAYMENT proof from an x402-compatible wallet/client'}, 'actorType': {'enum': ['agent', 'human', 'synthetic', 'system', 'unknown'], 'type': 'string', 'description': 'Caller type for analytics: agent, human, synthetic, system, or unknown'}, 'synthetic': {'type': 'boolean', 'description': 'Mark this paid retry as an internal test/probe for analytics exclusion'}, 'compounding': {'enum': ['simple', 'compounded'], 'type': 'string', 'description': "Preferred-return accrual basis: 'simple' or 'compounded' (default compounded)"}, 'distributable': {'type': 'number', 'description': 'Total cash to distribute'}, 'preferredRate': {'type': 'number', 'description': 'Annual preferred rate, e.g. 0.08'}, 'carryPercentage': {'type': 'number', 'description': 'GP carry, e.g. 0.20 (default 0.20)'}, 'paymentSignature': {'type': 'string', 'description': 'x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry'}, 'catchUpPercentage': {'type': 'number', 'description': 'GP catch-up share, 1.0 = full (default)'}, 'paymentIdentifier': {'type': 'string', 'description': 'Optional x402 payment identifier for idempotency/retry correlation'}, 'contributedCapital': {'type': 'number', 'description': 'Total LP capital to return in tier 1'}, 'preferredReturnAmount': {'type': 'number', 'description': 'Explicit preferred return amount'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'httpStatus'], 'properties': {'ok': {'type': 'boolean', 'description': 'True when the upstream storefront call returned a 2xx response'}, 'httpStatus': {'type': 'number', 'description': 'Upstream HTTP status code'}, 'paymentRequired': {'type': 'boolean', 'description': 'True when the response is an x402 HTTP 402 payment challenge'}}, 'additionalProperties': False}
Ajouté
assurance_verify
17 September 2026 12:42
Ajouté
assurance_attest
17 September 2026 12:42
Ajouté
evidence_verify
17 September 2026 12:42
Ajouté
payment_policy_decide
17 September 2026 12:42
Ajouté
mcp_risk_score
17 September 2026 12:42
Ajouté
emailguard_validate_batch
17 September 2026 12:42
Ajouté
emailguard_validate
17 September 2026 12:42
Ajouté
walletguard_score
17 September 2026 12:42
Ajouté
portfolioguard_score
17 September 2026 12:42
Ajouté
bond_analyze
17 September 2026 12:42
Ajouté
options_price
17 September 2026 12:42
Ajouté
waterfall_distribute
17 September 2026 12:42
Ajouté
cashflowlens_analyze
17 September 2026 12:42
Ajouté
dealanalyzer_analyze
17 September 2026 12:42
Ajouté
score_destructguard_command
17 September 2026 12:42
Ajouté
submit_reviewqueue_request
17 September 2026 12:42
Ajouté
action_safety_run
17 September 2026 12:42
Ajouté
action_safety_quick_gate
17 September 2026 12:42
Ajouté
purchase_with_x402
17 September 2026 12:42
Ajouté
start_checkout
17 September 2026 12:42
Ajouté
get_x402_manifest
17 September 2026 12:42
Ajouté
get_checkout_policies
17 September 2026 12:42
Ajouté
get_product
17 September 2026 12:42
Ajouté
list_products
17 September 2026 12:42
Ajouté
freetier_status
17 September 2026 12:42

GoCreative Agent API

io.github.ColinHughes2121/gocreative-agent-api

Offers pay-per-call LLM completions and data services for company intelligence, KYB, sanctions screening, threat intelligence, co…

IA-QA — 130+ QA & Dev Tools for AI Agents

io.github.JcJamet/ia-qa-toolbox

Provides deterministic QA, evaluation, testing, code analysis, prompt and RAG checks, model comparison, and web security diagnost…

tollbooth

io.github.huwhitememes/tollbooth

Provides paid OSINT, web intelligence, security threat and vulnerability lookups, prediction-market analysis, financial data, leg…

DDG Agent Services

io.github.daedalusdevelopmentgroup/ddg-agent-services-mcp

Acts as a pay-per-call gateway for agent tools including LLM routes, web and market data, Ethereum RPC, security scans, service c…

SYNTHORA x402 Intelligence Mesh

com.hergertsynthora/synthora-x402

Delivers paid intelligence on markets, crypto, prediction markets, maritime and space risks, domain and wallet exposure, sanction…

dMoERA Creator

io.github.CacheCarti/dmoera-creator

Supports crypto trading strategy discovery, validation, backtesting-related reporting, bot allocation, fund management, and live …

gateway

com.edgethirteen.www/gateway

Aggregates tools for web accessibility, AI compliance, financial analysis, API migration, software security, payment operations, …

mainstreet

io.github.philpof102-svg/mainstreet

Provides reputation, trust scoring, validation, consensus, routing, and payment-related tools for on-chain AI agents on Base.