io.github.JesseGdotIOPublished by GitHub account JesseGdotIOv2.0.2Updated Oct 25, 2026
Preflight, approve, and prove consequential agent actions with signed evidence and x402 tools.
Hermes Plant lets an assistant preflight risky agent actions, check x402 payment policy, and buy deterministic finance and risk scoring calls per use.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.JesseGdotIO%2Fhermes-plant/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"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.
Source: README.md at commit 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).
apiKeyrequiredList products
List active products from the Hermes Plant catalog
Takes no parameters.
Get product
Get a single product by slug
slugrequiredGet checkout policies
Return legal policy URLs required before checkout
Takes no parameters.
Get x402 manifest
Return the live x402 manifest with paid endpoint prices, Bazaar metadata, and buyer policy checks
Takes no parameters.
Start checkout
Start a Stripe checkout session for a product slug
slugrequiredPurchase 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.
slugrequiredemailpayerapiKeychannelcampaignxPaymentactorTypesyntheticpaymentSignaturepaymentIdentifierAction 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.
cwdrepoactorpayerapiKeybranchintentchannelcommandrequiredcampaigndiffStatxPayment+4 moreAction 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.
cwdrepoactorpayerapiKeybranchintentchannelcommandrequiredcampaigndiffStatxPayment+4 moreReviewQueue — 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.
repoactorpayerapiKeybranchreasonchannelcommandrequiredcampaigndiffStatxPaymentactorType+3 moreDestructGuard — 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.
cwdrepoactorpayerapiKeyintentchannelcommandrequiredcampaigndiffStatxPaymentactorType+3 moreDealAnalyzer — 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.
dcfrequiredpayerapiKeychannelreturnscampaignxPaymentactorTypesyntheticwaterfallpaymentSignaturepaymentIdentifierCashflowLens — 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.
dcfnavpayerapiKeychannelcampaignxPaymentactorTypecashflowsrequiredsyntheticdiscountRateperiodsPerYear+2 moreWaterfallLens — 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 %.
payeryearsapiKeychannelcampaignxPaymentactorTypesyntheticcompoundingdistributablerequiredpreferredRatecarryPercentage+5 moreOptionLens — 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.
spotrequiredpayerapiKeystrikerequiredchannelcampaignxPaymentactorTypesyntheticoptionTypevolatilityrequiredriskFreeRate+4 moreBondLens — 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 morePortfolioGuard — portfolio risk
PortfolioGuard (x402-paid, $0.15): deterministic portfolio risk scoring from holdings — volatility, Sharpe, max drawdown, concentration (HHI), diversification, plus per-rule findings.
payerapiKeychannelcampaignholdingsrequiredxPaymentactorTypesyntheticriskFreeRateperiodReturnspaymentSignaturepaymentIdentifierWalletGuard — 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.
payerapiKeylabelswalletrequiredchannelcampaignxPaymentactorTypeexposuressynthetictransferssanctionsHits+3 moreEmailGuard — 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.
nameemailrequiredpayerapiKeydomainchannelcampaignxPaymentactorTypemxPresentsyntheticpaymentSignature+1 moreEmailGuard — 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.
payerapiKeychannelrecordsrequiredcampaignxPaymentactorTypesyntheticpaymentSignaturepaymentIdentifierMCP 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.
payertoolsrequiredapiKeyserverchannelcampaignxPaymentactorTypeauthModelsyntheticpriorToolspaymentSignature+1 morePayment 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 moreEvidence 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.
payerapiKeypolicychannelsubjectcampaignxPaymentactorTypeartifactsrequiredsyntheticpaymentSignaturepaymentIdentifierAssurance 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.
payerapiKeyintentrequiredpolicychanneloutcomesubjectrequiredcampaignprotocolrequiredxPaymentactorTypesynthetic+2 moreAssurance 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.
recordrequiredintegrityrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
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