All docs
1 min read

Install for Hermes Agent

Hermes Agent loads MCP servers from ~/.hermes/config.yaml. Remote HTTP servers use url plus optional headers for bearer auth.

1. Mint a token

Open API tokens, create a token, copy the value (shown once).

Starter abilities:

forms:read, submissions:read, submissions:write, insights:read.

2. Add the server

Edit ~/.hermes/config.yaml:

yaml
mcp_servers:
  formspring:
    url: "https://formspring.io/mcp-server"
    headers:
      Authorization: "Bearer YOUR_TOKEN"
    tools:
      prompts: true
      resources: true

The tools block is optional. Use tools.include / tools.exclude to limit which Formspring tools Hermes exposes if you want a tighter surface.

You can also add servers with the CLI when available in your install:

bash
hermes mcp add formspring --url https://formspring.io/mcp-server --header "Authorization: Bearer YOUR_TOKEN"

3. Reload

In an active Hermes chat session:

text
/reload-mcp

Or start a new session:

bash
hermes chat

4. Test

text
Tell me which MCP-backed tools are available right now.

Then:

List my Formspring forms and summarize submission volume this week.

Related