Hermes

Publish, list and seal pagelets from Nous Research's Hermes Agent.

Hermes supports remote MCP servers with a URL plus headers — full Pagelet tool access.

Configure

~/.hermes/config.yaml

# ~/.hermes/config.yaml
mcp_servers:
  pagelet:
    url: "https://pagelet.link/mcp"
    headers:
      Authorization: "Bearer pgl_…"

Hermes resolves config as CLI args → config.yaml → .env → defaults. Keep the token out of shared dotfiles — ~/.hermes/config.yaml is user-private.

Pagelet exposes ~20 tools. Hermes encourages a minimal surface — whitelist what you'll use:

with a tool filter (optional)

mcp_servers:
  pagelet:
    url: "https://pagelet.link/mcp"
    headers:
      Authorization: "Bearer pgl_…"
    tools:
      include: [publish_pagelet, list_pagelets, render_pdf, get_capabilities]
      resources: false
      prompts: false

Verify it works

hermes mcp test pagelet — connects and reports the server's tools.
In a running session, /reload-mcp picks up config changes without a restart.
Ask "tell me which MCP-backed tools are available right now" — the Pagelet set should be listed.

First pagelet

Ask: "Make a pagelet daily briefing and publish it." Hermes callspublish_pagelet and returns a https://<slug>.usepagelet.com URL — open it to confirm.

Troubleshooting

Configured but nothing loads — check enabled: false isn't set, the URL is reachable, and the header value is exactly Bearer pgl_….
"Auth required" tool errors — token wrong or missing; fix config.yaml, then /reload-mcp.
Fewer tools than expected — your tools.include/exclude filter or disabled resources/prompts wrappers; that's the policy working.
MCP support missing entirely — reinstall with extras: uv pip install -e ".[mcp]" in ~/.hermes/hermes-agent (the standard installer includes it).

Source: Use MCP with Hermes (remote url + headers shape verified there).