Connect Hermes to Performance Hub

Instructions current as of 17 June 2026 (AEST). Vendor MCP support changes frequently - verify against the linked sources if something looks different.

Hermes can use remote MCP servers through its mcp_servers configuration.

Requirements

Hermes installed and configured.
A Performance Hub MCP key.
The Performance Hub MCP server URL:

https://app.performancehub.co/mcp

Recommended setup

Store the key in Hermes' .env file rather than directly in config.yaml.

Find the env file path:

hermes config env-path

Add your key:

PH_MCP_API_KEY=phk_your_key_here

Then edit the Hermes config:

hermes config edit

Add the server:

mcp_servers:
  performance-hub:
    url: "https://app.performancehub.co/mcp"
    headers:
      Authorization: "Bearer ${PH_MCP_API_KEY}"
    timeout: 180
    connect_timeout: 30

Hermes resolves ${PH_MCP_API_KEY} from the environment loaded at startup.

Alternative header

Performance Hub also accepts the x-mcp-api-key header:

mcp_servers:
  performance-hub:
    url: "https://app.performancehub.co/mcp"
    headers:
      x-mcp-api-key: "${PH_MCP_API_KEY}"
    timeout: 180
    connect_timeout: 30

Reload and test

Restart Hermes, or run this inside an active Hermes CLI session:

/reload-mcp

Then confirm the connection:

hermes mcp list
hermes mcp test performance-hub

If the connection succeeds, the Performance Hub MCP tools become available to Hermes as normal tools.

Troubleshooting

Problem	Check
No tools appear	Restart Hermes or run `/reload-mcp`; verify `mcp_servers` is under the top-level config.
Unauthorized	Check the key value and the header format.
Key leaked	Deactivate/delete the key in Performance Hub and create a replacement.
Missing specific tools	Your Performance Hub user may not have the required facility, module, or admin permissions.

Sources

Hermes CLI help (hermes config edit, hermes mcp list, hermes mcp test) and its MCP client implementation.
Performance Hub MCP: https://app.performancehub.co/mcp