Give Hermes Agent native access to 330+ APIs across 260+ providers — multi-engine web search, page extraction, audio transcription, SEC EDGAR filings, GitHub, LLMs, TTS, finance, science, and developer data — through one prepaid balance at 0% per-call markup.
- $1 free credit ≈ 1,000 Serper searches or 1,000 Exa scrapes at 0% markup (no credit card required; non-expiring top-up packs from
$5). - Deterministic
spend_limit_usdcaps per API key (server-enforced HTTP402before overspend). $0.00failed-call escrow: upstream failures never debit your balance.- Zero Python dependencies: pure Python standard library (
urllib.request), zero conflicts with Hermes's core lockfile.
hermes plugins install https://github.com/helve-dev/hermes-plugin --enableDuring install, Hermes prompts for HELVE_API_KEY (get a free sk_live_... key with $1.00 credit at helve.dev/signup). Discovery tools (helve_search_tools and helve_list_categories) work immediately even without an API key.
Prefer OAuth 2.1 instead of an API key? Add Helve's hosted Streamable HTTP MCP server to ~/.hermes/config.yaml:
mcp_servers:
helve:
url: https://helve.dev/mcp
auth: oauth
trust: untrustedThen authenticate once:
hermes mcp login helve| Surface | Auth Required | What It Does |
|---|---|---|
helve_search_tools |
None (free) | Search 330+ APIs by intent or category; returns exact tool_id, JSON input_schema, and upfront pricing_hint |
helve_list_categories |
None (free) | Browse all catalog categories with tool counts and sample tool_id values |
helve_call_tool |
HELVE_API_KEY |
Execute any discovered tool_id with arguments at 0% markup ($0.00 on free tools and failed calls) |
helve_request_tool |
HELVE_API_KEY |
Report a missing API or capability so Helve can prioritize onboarding it |
helve:helve (skill) |
— | Bundled workflow instructions (skill_view("helve:helve")) for schema inspection, cost confirmation, and budget caps |
Search Helve for SEC 10-K filing tools and pull NVIDIA's latest filings.
Use Helve to search for recent benchmarks on Hermes Agent plugins and extract the top 3 pages.
Helve (helve.dev, maintained by helve-dev) is a hosted third-party API gateway. Before installing, note:
- Network calls:
helve_search_toolsandhelve_list_categoriescallhttps://helve.dev/v1/tools*.helve_call_toolsends yourtool_idandargumentstohttps://helve.dev/v1/tools/calland on to the upstream provider. - Billing: Discovery and 300+ public-data tools cost
$0.00. Metered paid tools debit your prepaid Helve balance at exact upstream cost (0%per-call markup); failed calls debit$0.00. You can set hard per-keyspend_limit_usdcaps at helve.dev/dashboard. - Credentials:
HELVE_API_KEYis read exclusively via Hermes's profile-scopedagent.secret_scope.get_secret("HELVE_API_KEY"). The plugin never reads.envfiles, keychains, or other credential stores directly. - No hooks, telemetry, background processes, or self-updating code: This plugin registers four tools and one bundled skill. Updates reach users only through
hermes plugins update.
python3 -m unittest discover -s tests -v- helve-dev/helve-mcp — Hosted MCP server, npm/PyPI stdio bridges, framework adapters, and Agent Skills
- helve-dev/company-dossier — Runnable zero-dependency Company & SEC Research Dossier CLI
- helve-dev/langsmith-tool-gateway-starter — Runnable starter kit for LangSmith Tool Gateway + Helve
MIT — see LICENSE.