# Hermes

Add the Reduck MCP server to Hermes over OAuth, and point it at a model provider of your own, which Hermes needs and does not ship with.

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](https://docs.reduck.ai/#quick-start).

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

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

## Add the server

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

Then authorize:

```bash
hermes mcp login reduck
```

> [!WARNING]
> Run that in a real terminal. `hermes mcp login`, `hermes model` and `hermes tools` all refuse to
> run through a pipe or a script.

## Confirm it is connected

```bash
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:

```bash
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:

```yaml
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:

> Use Reduck to get me the weather in Paris for the next two weeks.

Reduck finds a script for the site, runs it, and hands back the result. The
[script catalogue](https://reduck.ai/explore/scripts) lists everything it can already do.