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