> ## Documentation Index
> Fetch the complete documentation index at: https://monitor-docs.solobiz.academy/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Hermes and GrokBot

> Hermes Agent (Nous Research) and GrokBot connect through standard MCP.

Both connect through standard MCP: Streamable HTTP, `url` plus header `Authorization: Bearer`. Syntax checked against the Hermes Agent MCP docs on 2026-11-20 (no version number is published on that page). Re-check if your Hermes version differs.

## Hermes Agent

1. Put the key in `~/.hermes/.env`:

   ```bash theme={null}
   SOCIAL_MONITOR_KEY=smk_xxxxxxxx_xxxxxxxx
   ```

2. Add to `~/.hermes/config.yaml`:

   ```yaml theme={null}
   mcp_servers:
     social_monitor:
       url: "https://monitor.solobiz.academy/api/mcp"
       headers:
         Authorization: "Bearer ${SOCIAL_MONITOR_KEY}"
   ```

   Hermes infers Streamable HTTP from `url`. Use underscores in the server name: tools are registered as `mcp_<server>_<tool>`, for example `mcp_social_monitor_list_channels`.

3. Verify:

   ```bash theme={null}
   hermes mcp test social_monitor
   ```

   In a running session run `/reload-mcp` to reload without restarting.

4. Ask the agent to call `list_channels`.

> [!NOTE]
>
> The Hermes docs show `${VAR}` expansion for some fields but do not state it for user-written `headers`. If `hermes mcp test` returns 401, write the literal value: `Authorization: "Bearer smk_..."`.

## GrokBot

Use the generic `mcpServers` block from [Connect via MCP JSON](https://monitor-docs.solobiz.academy/agents/connect-mcp-json.md) in GrokBot's MCP config. If your GrokBot build cannot send custom headers, use `mcp-remote --header` (same page) or the HTTP fallback.

## Fallback: HTTP

No MCP client or no header support: [HTTP bots](https://monitor-docs.solobiz.academy/agents/connect-http-bots.md).

| Symptom | Fix |
| - | - |
| 401 / 403 from `hermes mcp test` | Wrong or revoked key, header not expanded |
| Server not registered | Read `agent.log` startup summary, check YAML indentation |
| Tools not refreshed | `/reload-mcp` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.