Hermes Agent

Hermes Agent is Nous Research’s local AI agent. It configures MCP servers in ~/.hermes/config.yaml under the mcp_servers key.

Install

Edit ~/.hermes/config.yaml and add a flora entry under mcp_servers:

mcp_servers:
  flora:
    command: npx
    args: ["-y", "mcp-remote", "https://agents.flora.ai/mcp"]
    enabled: true

Hermes Agent’s HTTP MCP transport only supports static bearer headers, not the OAuth 2.1 + PKCE flow FLORA MCP uses. The mcp-remote shim bridges Hermes’s stdio interface to FLORA’s hosted HTTP transport and handles the browser OAuth handshake. You’ll need Node.js 18+ on the machine.

Authorize

Reload MCP servers without restarting Hermes:

/reload-mcp

Then ask:

List my FLORA Techniques.

mcp-remote opens a browser for OAuth on first use. Sign in to FLORA and approve. The token is cached in ~/.mcp-auth/.

Verify

Confirm the server is connected:

hermes mcp list
hermes mcp test flora

You should see flora listed and the tools discovered.

Remove

Delete the flora entry from ~/.hermes/config.yaml and reload:

/reload-mcp

To clear the cached OAuth token: rm -rf ~/.mcp-auth/flora. Revoke server-side in FLORA → Settings → Connected apps.

Next

• Authentication details
• Tools reference
• Troubleshooting