Connect Hermes Agent

Add the looot MCP server to Hermes Agent in its YAML config, sign in with the browser, and check it works.

Hermes Agent reaches looot’s catalog, balance and runs over MCP, through its config.yaml file.

Before you start you need a looot account. The runs you make spend the organization’s balance, so top up before your first paid run. See Before your first run.

Sign in with the browser

The server URL is https://api.looot.ai/mcp. Nothing to copy: you sign in on looot.ai, pick the organization to bill and click Connect.

~/.hermes/config.yaml

mcp_servers:
  looot:
    url: "https://api.looot.ai/mcp"
    auth: oauth

Sign in

hermes mcp login looot

Check the connection

hermes mcp test looot

Headless: a token in the header

Only for CI and machines with no browser. Create an agent token in Settings and send it as Authorization: Bearer <token>. Never commit it.

Headless: ~/.hermes/config.yaml with a header

mcp_servers:
  looot:
    url: "https://api.looot.ai/mcp"
    headers:
      Authorization: "Bearer <agent token from looot.ai Settings>"

Notes

• hermes mcp login prints an authorize URL, opens your browser and waits for the callback on a local port. Tokens go to ~/.hermes/mcp-tokens/, never into config.yaml.
• In a running session, type /reload-mcp to load the change. hermes mcp add looot is the interactive alternative to editing the file.
• Labels and the test output may differ slightly in your version.

Check it works

Ask Hermes Agent to call balance or catalog_overview. Both are free. A working connection answers with your available balance, or the catalog’s categories and job counts.

Let your AI guide you

Paste this into Claude Code or any AI assistant and it walks you through the setup.

Help me connect the looot MCP server https://api.looot.ai/mcp to Hermes Agent. Go one step at a time and wait for me to confirm. After each step, ask me for a screenshot, check it, and tell me exactly what to do next. Ask me to hide any token first. Check my config.yaml with me as we go. Steps: 1. Add looot to ~/.hermes/config.yaml under mcp_servers with the url and auth: oauth. 2. Run hermes mcp login looot and sign in on the looot page. 3. Run hermes mcp test looot. 4. In a running session, type /reload-mcp. Use browser sign-in. If it fails, tell me to make a token at looot.ai/connect under Advanced and keep it in the config file only, never in this chat. At the end, ask looot for my balance, run ipinfo-lite on 8.8.8.8, and tell me both results.

What you see when you connect

The browser opens looot.ai and shows the consent page: which organization to bill, which scopes to grant and how long to stay connected. See The consent page.