Hermes Agent connection guide

These steps were last checked with Hermes Agent 0.22.6 on November 4, 2026. Check the current Hermes MCP reference if your version behaves differently.

Add this server entry to the active Hermes profile's config.yaml. Run hermes config path to find that file:

mcp_servers:
  agenticmailcenter:
    url: "https://YOUR_AGENTICMAILCENTER_ORIGIN/mcp"
    headers:
      Authorization: "Bearer ${AGENT_API_KEY}"
    enabled: true
    tools:
      resources: false
      prompts: false

Keep AGENT_API_KEY in the profile's .env file (run hermes config env-path to find it) or the process environment, never in source control. Start with a read-scoped key and use tool discovery to confirm the runtime catalog. Draft creation and sending require the corresponding scopes. send_with_policy requires approval and passing policy checks; the separately gated send_direct mode can send before review when enabled by the server.

Verification is non-production and read-only: connect to a test tenant, run hermes mcp test agenticmailcenter to confirm the connection and list the discovered tools, and revoke the short-lived key afterward. Do not send outbound email or use Production credentials during setup verification.