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

# Hermes

> Add Alchemist to Nous Research's Hermes Agent via MCP (OAuth or API key).

[Hermes Agent](https://github.com/NousResearch/hermes-agent) (Nous Research) has a built-in MCP client — it connects to remote MCP servers, discovers their tools, and registers them alongside its own. Point it at Alchemist and the `search_insights` / `get_document` tools appear in `hermes tools list`.

## OAuth (recommended)

Hermes signs in with your Alchemist account — no key to copy. Add the server, then run the login once.

```bash theme={null}
hermes mcp add alchemist --url https://api.askalchemist.com/mcp/ --auth oauth
hermes mcp login alchemist
```

`login` opens your browser (loopback callback) to sign in; Hermes handles discovery, dynamic client registration, and PKCE. Run it from a fresh terminal — it waits the full flow.

<Note>
  OAuth signs you in as an existing Alchemist user. Sign in once at [app.askalchemist.com](https://app.askalchemist.com) first, or the server returns `401` even after the flow completes.
</Note>

## API key

For headless runs, or to connect with one shared credential, add Alchemist to your Hermes `config.yaml` under `mcp_servers` with a bearer header:

```yaml theme={null}
mcp_servers:
  alchemist:
    url: "https://api.askalchemist.com/mcp/"
    headers:
      Authorization: "Bearer alch_YOUR_KEY"
```

Get a key at [app.askalchemist.com/settings/api-keys](https://app.askalchemist.com/settings/api-keys). Restart Hermes so it picks up the server on the next start.

## Verify

```bash theme={null}
hermes tools list
# → alchemist tools appear (search_insights, get_document, …)
```