# Isaac for Hermes Agent Portable [Hermes Agent](https://github.com/NousResearch/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`](https://github.com/newt-foundation/newton-agent-neobank/tree/main/integrations/hermes). The standalone [`isaac-hermes-plugin`](https://github.com/newt-foundation/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: ```bash npm install --global @newton-xyz/isaac-cli@0.1.0 isaac --version ``` ## Install Pin the plugin to a reviewed full commit SHA: ```bash hermes plugins install newt-foundation/isaac-hermes-plugin \ --ref \ --no-enable hermes plugins enable newton-isaac ``` Hermes stores this plugin's private runtime data under: ```text ~/.hermes/plugin-data/agent-plugin-newton-isaac-260c5e04/ ``` Pre-create `auth.json` with owner-only permissions before adding credentials: ```bash 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: ```json { "apiBaseUrl": "https://api.isaac.newton.xyz", "apiKey": "", "vaultAddress": "", "agentAddress": "", "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 ```bash 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](https://linear.app/newton-xyz/issue/NEWT-1285/d18-hermes-based-design-partner-demo).