Skip to content

newt-foundation/newton-isaac

v0.1.0Apache-2.0

Use Newton Isaac governed commerce skills from Hermes Agent.

GitHubOpen Website

Isaac for Hermes Agent

Portable Hermes Agent plugin for Newton's Isaac commerce skills.

The plugin adds the existing isaac-fetch, isaac-research, and isaac-export Agent Skills and connects them to the existing Isaac MCP server. It contains no payment, custody, policy, or signing implementation.

Source

The canonical source lives in newton-agent-neobank/integrations/hermes. The standalone isaac-hermes-plugin repository is generated from a reviewed NeoBank commit. Changes to generated plugin files belong in NeoBank.

Requirements

  • Hermes Agent 0.20.1 or newer; validated against 0.20.5 (v2026.8.19).
  • macOS or Linux. Isaac credential files are not supported on Windows.
  • Node.js 20 or newer.
  • @newton-xyz/isaac-cli 0.1.0 installed so isaac is on PATH.
  • An owned Newton vault and agent plus an operator Platform API key.

Install the public Isaac CLI:

npm install --global @newton-xyz/isaac-cli@0.1.0
isaac --version

Install

Pin the plugin to a reviewed full commit SHA:

hermes plugins install newt-foundation/isaac-hermes-plugin \
  --ref <full-40-character-commit-sha> \
  --no-enable
hermes plugins enable newton-isaac

Hermes stores this plugin's private runtime data under:

~/.hermes/plugin-data/agent-plugin-newton-isaac-260c5e04/

Pre-create auth.json with owner-only permissions before adding credentials:

mkdir -p ~/.hermes/plugin-data/agent-plugin-newton-isaac-260c5e04
install -m 600 /dev/null ~/.hermes/plugin-data/agent-plugin-newton-isaac-260c5e04/auth.json

Then write:

{
  "apiBaseUrl": "https://api.isaac.newton.xyz",
  "apiKey": "<operator-platform-api-key>",
  "vaultAddress": "<owned-vault-address>",
  "agentAddress": "<active-agent-address>",
  "chainId": 84532
}

Restart Hermes after enabling the plugin. The Isaac business-tool surface is restricted to the seven tools required by the packaged skills; Hermes also registers its standard read-only MCP prompt and resource utilities:

  • skill_search
  • skill_fetch
  • skill_research_start
  • skill_research_get
  • skill_artifact_get
  • skill_export_create
  • skill_export_get

Verify

hermes plugins doctor . --ci
hermes plugins list

In a fresh Hermes session, ask it to list the installed Isaac skills, load isaac-fetch, and perform a read-only skill_search for the configured vault and agent before attempting a paid fetch.

Implementation and live evidence are tracked in NEWT-1285.