Skip to main content
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. Hermes signs in with your Alchemist account — no key to copy. Add the server, then run the login once.
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.
OAuth signs you in as an existing Alchemist user. Sign in once at app.askalchemist.com first, or the server returns 401 even after the flow completes.

​
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:
Get a key at app.askalchemist.com/settings/api-keys. Restart Hermes so it picks up the server on the next start.

​
Verify