Hermes

Wire Hermes Agent (NousResearch) to agentry so the Hermes agent can create sandboxes, write files, run commands, and ship apps on your server — turning any sandbox into a clean, isolated machine it drives over MCP.

You'll need

• The agentry CLI installed and signed in. See Quick start, step 1–2.
• Hermes installed (hermes --version).
• ~3 minutes.

Add agentry as an MCP server

Hermes manages MCP servers from the CLI. agentry runs as a local stdio server, so register it with --command:

hermes mcp add agentry --command agentry --args mcp

That writes the server into your Hermes MCP config. List what's registered with:

hermes mcp list

Prefer editing config by hand?

hermes mcp add is the supported path, but the entry it writes is the standard MCP shape — a server name with a command and args. The agentry entry is always:

{
  "agentry": {
    "command": "agentry",
    "args": ["mcp"]
  }
}

Verify

Start Hermes and ask:

Which agentry tools do you have?

You should see tools like sandbox_create, app_probe, command_run, file_write, port_wait. If they show up, you're wired.

If not, see MCP wiring troubleshooting.

Try it

Use agentry to create a sandbox and build a hello-world homepage that says "Hello from Hermes". Start the dev server and tell me the port.

Hermes should call sandbox_create, scaffold the page, run the dev server, and report the port. Open the sandbox in the dashboard and click Share for a *.agentry.live preview URL.

Pin a server

agentry mcp uses your current server (agentry server use <name>). Pin one harness to a specific server with --server:

hermes mcp add agentry --command agentry --args mcp --server homelab

Path issues

If Hermes can't find agentry, register the absolute path:

which agentry
hermes mcp add agentry --command /Users/you/.local/bin/agentry --args mcp

This is the most common cause of "Hermes lists 0 agentry tools".

Notes

• Hermes can also be an MCP server (hermes mcp serve). That's the inverse of this guide — here Hermes is the client and agentry is the server it drives. The two are independent.
• agentry is a vanilla stdio MCP server with no Hermes-specific additions; anything in the generic MCP guide applies.

Next

• Prompting — get Hermes to follow the right patterns.
• Ship an app — go from prototype to production URL.