io.github.JesseGdotIO由 GitHub 账号 JesseGdotIO 发布v2.0.2更新于 Oct 25, 2026
Preflight, approve, and prove consequential agent actions with signed evidence and x402 tools.
Hermes Plant 让助手在执行高风险操作前做安全预检、检查 x402 支付策略，并按次购买确定性的金融与风险评分服务。
Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.JesseGdotIO%2Fhermes-plant/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"hermes-plant-agent-commerce-assurance": {
"type": "http",
"url": "https://mcp.hermesplant.com/mcp"
}
}
}Runnable MCP server and integration examples for Hermes Plant, the Agent Commerce Assurance layer that lets AI agents preflight, approve, and prove consequential actions. Start with a one-cent action-safety check, route only high-risk actions into signed review evidence, and pay per call over x402.
What's here: a runnable stdio MCP bridge for registry crawlers and local clients, plus drop-in examples in curl, TypeScript, Python, CrewAI, LangChain, and MCP client configs for Claude Desktop / Cline / Cursor.
An agent receives approval for one action, its arguments change, and a retry after a timeout may execute it twice. What binds approval to the final action, prevents duplicates, and proves whether execution completed?
The sample findings memo walks through a synthetic example of these gaps, the available evidence, and a ranked fix plan. It is a demonstration, not a client result.
For technical founders and automation agencies with a working or near-launch agent, the $300 workflow review covers one workflow, a workflow map, ranked findings, and a practical fix plan. The three-hour cap includes calls, preparation, the memo, and one clarification round. We agree scope and timing in writing before billing. Implementation and production access require a separate agreement.
Install the public, fail-closed Action Safety skill for Codex, Claude Code, Cursor, and other Agent Skills-compatible clients:
The skill calls the one-cent quick gate before an exact consequential action, binds the result to that unchanged action, and escalates high or critical risk only when the additional $0.25 is authorized. Review triage is never treated as human approval and the skill never expands the caller's permissions.
Source: skills/protect-agent-action · Install guide and trust boundary
For the complete production tool surface, use the canonical Hermes Plant — Agent Commerce Assurance connector on Glama. It exposes Action Safety, Spend Assurance, signed evidence, payment-policy checks, and the component x402 tools through the live Streamable HTTP endpoint.
This repository is the portable, no-secret discovery bridge. It lets registry crawlers and local clients inspect the live catalog and payment contracts without signing a wallet message or spending funds. The hosted connector is the buyer-facing path for invoking the production tools.
[Hermes Plant MCP Server Glama card]
This repo is arranged for Glama to build and inspect the MCP server without secrets or funded wallets:
glama.json declares the GitHub maintainer.Dockerfile starts the stdio MCP server in mcp-server/.npm run smoke:mcp lists all local MCP tools and fetches the live x402 manifest.A Glama release is still an account-side action, not a GitHub release. After claiming the server in Glama, use the Dockerfile admin page to deploy the build, wait for the build test to pass, then publish a Glama release version. That release unlocks Glama's Server Coherence and Tool Definition Quality scoring.
Hermes Plant governs consequential actions and payments; these independent servers cover adjacent layers of an agent stack:
These links describe functional complementarity, not partnerships or endorsements.
Use the free API key for up to 250 calls/month, the $29/month Agent API Pass for regular volume, or per-call USDC on Base. Public proof and machine-readable contracts are available at hermesplant.com/proof and hermesplant.com/openapi.json.
Nineteen hosted x402 endpoints remain available as composable utilities:
Agents discover endpoints through OpenAPI, llms.txt, the x402 manifest, the API catalog, MCP metadata, or agent skills. The workflow links above identify this GitHub repository as their source; actual Glama placements use separate registry tags. Source tags are observational and do not establish buyer identity or a completed purchase.
402 Payment Required plus a PAYMENT-REQUIRED header carrying the price, network, asset, recipient, and timeout.PAYMENT-SIGNATURE header.200 OK with the result plus a PAYMENT-RESPONSE header.The full spec lives at github.com/x402-foundation/x402.
These let any agent or human self-onboard without help:
The runnable stdio server exposes five read-only discovery tools:
These local tools do not sign wallet messages, approve transactions, call paid endpoints, or spend USDC. They expose the discovery layer that clients need before invoking paid hosted tools.
Pick the runtime that matches your stack:
This repo includes a root glama.json and root Dockerfile for MCP registry crawlers:
The container starts the stdio MCP bridge in mcp-server/, which exposes Hermes Plant discovery tools and hosted MCP metadata without requiring API keys.
The curl, TypeScript, Python, CrewAI, and LangChain CashflowLens examples send
x-hermes-channel: github-mcp-repo, x-hermes-medium: repository, and
x-hermes-campaign: first-workflow. x-hermes-content identifies the runtime.
The paid clients pass these headers into the x402 request so the SDK retains them
when retrying after a 402 challenge. Curl only inspects the unpaid challenge.
If you publish an example in another placement, replace these labels with that
placement's source and campaign. Labels are caller-declared observations; they
do not verify buyer identity, revenue, or an unaffiliated customer. Owner QA must
also send x-hermes-probe: 1 so it is excluded from acquisition reporting.
The guarded paid-call examples require:
8453.EVM_PRIVATE_KEY plus the explicit opt-in HERMES_ALLOW_PAYMENT=1.The included CashflowLens clients cap payment requirements at $0.20 USDC and register only Base mainnet. Leave the opt-in unset for imports and tests. Never commit a private key. These production examples do not claim testnet support; use an x402 test resource server for testnet integration work.
These examples target the production deployment at hermesplant.com. Endpoint signatures may evolve, so cross-reference openapi.json and the /.well-known/x402 manifest before going to production.
Issues and PRs welcome. New runtime? New framework? Open a PR with one working example and a tight README.
MIT - see LICENSE.
来源：README.md，提交 0ec180e
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).
apiKey必填List products
List active products from the Hermes Plant catalog
无需输入参数。
Get product
Get a single product by slug
slug必填Get checkout policies
Return legal policy URLs required before checkout
无需输入参数。
Get x402 manifest
Return the live x402 manifest with paid endpoint prices, Bazaar metadata, and buyer policy checks
无需输入参数。
Start checkout
Start a Stripe checkout session for a product slug
slug必填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.
slug必填emailpayerapiKeychannelcampaignxPaymentactorTypesyntheticpaymentSignaturepaymentIdentifierAction 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.
cwdrepoactorpayerapiKeybranchintentchannelcommand必填campaigndiffStatxPayment另有 4 个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.
cwdrepoactorpayerapiKeybranchintentchannelcommand必填campaigndiffStatxPayment另有 4 个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.
repoactorpayerapiKeybranchreasonchannelcommand必填campaigndiffStatxPaymentactorType另有 3 个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.
cwdrepoactorpayerapiKeyintentchannelcommand必填campaigndiffStatxPaymentactorType另有 3 个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.
dcf必填payerapiKeychannelreturnscampaignxPaymentactorTypesyntheticwaterfallpaymentSignaturepaymentIdentifierCashflowLens — 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.
dcfnavpayerapiKeychannelcampaignxPaymentactorTypecashflows必填syntheticdiscountRateperiodsPerYear另有 2 个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 %.
payeryearsapiKeychannelcampaignxPaymentactorTypesyntheticcompoundingdistributable必填preferredRatecarryPercentage另有 5 个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.
spot必填payerapiKeystrike必填channelcampaignxPaymentactorTypesyntheticoptionTypevolatility必填riskFreeRate另有 4 个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.
payerpriceyieldapiKeychannelperiodscampaignxPaymentactorTypefaceValuefrequencyprincipal另有 6 个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.
payerapiKeychannelcampaignholdings必填xPaymentactorTypesyntheticriskFreeRateperiodReturnspaymentSignaturepaymentIdentifierWalletGuard — 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.
payerapiKeylabelswallet必填channelcampaignxPaymentactorTypeexposuressynthetictransferssanctionsHits另有 3 个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.
nameemail必填payerapiKeydomainchannelcampaignxPaymentactorTypemxPresentsyntheticpaymentSignature另有 1 个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.
payerapiKeychannelrecords必填campaignxPaymentactorTypesyntheticpaymentSignaturepaymentIdentifierMCP 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.
payertools必填apiKeyserverchannelcampaignxPaymentactorTypeauthModelsyntheticpriorToolspaymentSignature另有 1 个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.
tagsassetpayTopayerapiKeymethodschemechannelnetworkcampaignxPaymentactorType另有 9 个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.
payerapiKeypolicychannelsubjectcampaignxPaymentactorTypeartifacts必填syntheticpaymentSignaturepaymentIdentifierAssurance 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.
payerapiKeyintent必填policychanneloutcomesubject必填campaignprotocol必填xPaymentactorTypesynthetic另有 2 个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.
record必填integrity必填已满足适用检查项的 100%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
npx [email protected] add JesseGdotIO/hermesplant-mcp-server --skill protect-agent-actionClient Hermes Plant Facilitator | | | | POST /endpoint | | |--------------------------->| | | 402 Payment Required | | | + PAYMENT-REQUIRED | | |<---------------------------| | | sign payment locally | | | POST /endpoint | | | + PAYMENT-SIGNATURE | | |--------------------------->| verify signature | | |--------------------------->| | | ok | | |<---------------------------| | 200 OK + result | settle payment | |<---------------------------|--------------------------->|npm installnpm run smoke:mcpnpm startdocker build -t hermesplant-mcp-server .docker run --rm -i hermesplant-mcp-server