Hermes Agent

Hermes Agent connects to Unitley directly over HTTP. You keep the token in Hermes's .env file and point config.yaml at it, so the token never sits in the config itself.

Set it upCopy Anchor Link

1. Create a tokenCopy Anchor Link

   Open the Connect page and create a token for Hermes. Tick Let it log bets, settle them and save picks only if you want Hermes to use log_bet, settle_bet and save_recommendation. Unitley shows the token only once, and the Connect page fills it into the setup below while the page is open.

2. Save the token in .envCopy Anchor Link

   Add this line to ~/.hermes/.env, with your token in place of the placeholder:

   Copy Text

   UNITLEY_TOKEN=YOUR_UNITLEY_TOKEN

3. Add the server to config.yamlCopy Anchor Link

   Add this to ~/.hermes/config.yaml. If the file already has an mcp_servers section, add only the unitley entry under it.

   Copy Text

   mcp_servers:
     unitley:
       url: "https://console.unitley.com/api/mcp"
       headers:
         Authorization: "Bearer ${UNITLEY_TOKEN}"

   Hermes replaces ${UNITLEY_TOKEN} with the value from your environment when it connects. You can also run hermes mcp add unitley --url https://console.unitley.com/api/mcp --auth header and paste the token when asked; Hermes saves it in .env as MCP_UNITLEY_API_KEY. The steps here use your own variable name, UNITLEY_TOKEN, instead.

4. Test the connectionCopy Anchor Link

   Copy Text

   hermes mcp test unitley

   This reports what Unitley answered. A 401 means the token was refused: check that .env holds the whole token and that it has not expired or been revoked.

5. Reload a running sessionCopy Anchor Link

   If Hermes is already running, type /reload-mcp in the session. Hermes reloads its MCP servers from the config and refreshes the tool list.

Tool names in HermesCopy Anchor Link

Hermes prefixes every MCP tool with the server's name so it cannot collide with its own tools. Unitley's tools show up as mcp_unitley_ followed by the tool name, for example mcp_unitley_get_game_odds. The tool reference uses the names without the prefix.

Replace the tokenCopy Anchor Link

1. Create a new token on the Connect page.
2. Put it in place of the old one in ~/.hermes/.env.
3. Run hermes mcp test unitley, then /reload-mcp in any running session.
4. Revoke the old token on the Connect page.

Remove itCopy Anchor Link

Delete the unitley entry from config.yaml and the UNITLEY_TOKEN line from .env. Then revoke the token on the Connect page.

Learn moreCopy Anchor Link

• Troubleshooting covers a server that does not load.
• Tokens and security covers scopes, expiry and revoking.
• Nous Research's Hermes MCP guide (opens in a new tab) and configuration reference (opens in a new tab) cover the config format in full.