Hermes Agent
Nous Research's Hermes Agent reads MCP servers straight out of its own config file. Connecting it to
gnt makes the 5 tools above available the same way they are anywhere else. The part that actually
matters is getting Hermes to call check_action before it acts, which the skill below does.
Connect it
gnt connect hermes looks for a local Hermes install (~/.hermes), shows you the exact block it
wants to add to ~/.hermes/config.yaml, and writes nothing until you say yes. Once you confirm, it
mints a fresh MCP key and prints it once for you to export. The key itself never touches the config
file, only a ${GNT_MCP_KEY} reference does.
Code
Or add it by hand
Hermes reads MCP servers from a top-level mcp_servers key in ~/.hermes/config.yaml. Paste the
block below as-is, including the ${GNT_MCP_KEY} reference. Don't inline a real key there. Get one
from gnt keys create, then export GNT_MCP_KEY=<that key> in your shell (or add it to
~/.hermes/.env, Hermes's own place for secrets) before starting Hermes, or /reload-mcp in a
running session.
Code
Install the skill
Connecting the MCP server only makes the tools available. Nothing makes Hermes call them before
acting on its own. The gnt-check-action skill closes that gap: it tells Hermes exactly when and how
to call check_action, in Hermes's own SKILL.md format, installable straight from a URL, no repo
clone required.
Code
Same instruction as the Enforce page's system prompt block, every surface teaches it the same way:
Code
For a standing instruction Hermes reads on every session in a given project rather than one it has to
decide to load, drop the same instruction in that project's own HERMES.md (or AGENTS.md, which
Hermes also reads) instead. See /skills/hermes/HERMES.md
for a ready-made one.
What Hermes calls these tools
Hermes registers MCP tools as mcp_<server>_<tool>. With the server named gnt (as above), that's
mcp_gnt_check_action, mcp_gnt_search_rules, mcp_gnt_get_rule, mcp_gnt_list_skill_packs, and
mcp_gnt_get_skill_pack. The skill above already accounts for the prefix.