Hermes

Hermes installs from a script and reaches Reduck over OAuth.

Before you start

You need a Reduck account, and a paired browser if you want scripts to run on your own Chrome. Both are in the quick start.

Hermes needs a model provider of its own, and it ships with none.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Add the server

hermes mcp add reduck \
  --url https://mcp.reduck.ai \
  --auth oauth

Then authorize:

hermes mcp login reduck

Confirm it is connected

hermes mcp test reduck

It reports the server as connected and lists Reduck’s tools. Your agent sees each one as mcp__reduck__<tool>, such as mcp__reduck__run_script.

The OAuth flow signs you in as whichever Reduck account your browser is already using, which is not always the one you meant. Ask your agent to call whoami and read the handle back before you rely on it.

Choose which tools load

Hermes sends every enabled tool to the model on every call, so it pays to load only the ones you use. To run scripts, whoami, list_devices, list_scripts, read_script, run_script, list_runs, read_run_results and read_run_trace are enough. Turn on the authoring tools (start_session, exec_code, create_script, …) when you build scripts of your own:

hermes mcp configure reduck

Settings worth changing

Hermes picks its model provider from the credentials it finds. Choose one with hermes model. If it lists aggregator catalogues, or warns that there is no active subscription, name your provider in ~/.hermes/config.yaml and remove any base_url entry:

model:
    provider: anthropic

If it does not appear

The command was run through a pipe or a script. Hermes refuses several of its commands outside an interactive terminal.
Sign-in never finished. hermes mcp login reduck has to complete in the browser before any tool call works.
No model provider is set, so the agent answers nothing even with the tools connected. See above.

Try it

Ask for something on a real site, and let the agent pick the script:

Reduck finds a script for the site, runs it, and hands back the result. The script catalogue lists everything it can already do.