Skip to main content

​
Using Hermes Agent with Marrow

Hermes Agent is an open-source, self-hosted agent from Nous Research. Use it when you want a local agent (desktop, CLI, or TUI) that can call Marrow MCP as its data layer for synced store and ad data.

​
Prerequisites

​
Step 1: Get Marrow credentials

From AI Hub → AI Platforms:
  • MCP server URL: https://mcp.marrow.ai/mcp/v1
  • Create an MCP key and copy it (shown only once)
See also: MCP overview

​
Step 2: Add Marrow to Hermes MCP config

Hermes reads MCP servers from ~/.hermes/config.yaml. Remote HTTP servers use a url plus optional headers.
  1. Open ~/.hermes/config.yaml.
  2. Add or extend mcp_servers:
Replace YOUR_MCP_KEY with your key from AI Platforms.
  1. Save the file and restart Hermes (or run /reload-mcp in an active session if your Hermes build supports it).

​
Quick reference

​
Step 3: Verify the connection

Open a new Hermes chat (desktop UI or hermes chat) and ask:
Hermes should list Marrow MCP tools. If nothing appears, check YAML indentation, that the key is active, and that Hermes was restarted after the edit.

​
Step 4: Run a data prompt

If Hermes returns real numbers from your synced accounts, Marrow is connected.

​
Notes

  • Desktop UI and CLI share the same config.yaml and MCP setup.
  • Prefer keeping the key out of version control; treat it like a password.
  • Hermes MCP docs evolve quickly — if native url auth fails on your build, check the current Hermes MCP guide for your version.

​
Security

  • Marrow is read-only — it never posts or changes store/ad settings.
  • Rotate or revoke MCP keys from AI Platforms anytime.