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

# Hermes

> Connect Hermes to Datalayer with a remote MCP server and OAuth.

Connect Hermes with the remote MCP server. The server URL is
`https://mcp.datalayer.so/mcp`. Sign in with your Datalayer
account in the browser. Do not put an API key in the Hermes config file or in
chat.

**1. Add the remote server with OAuth**

From a terminal, add Datalayer and let Hermes open the browser:

```bash theme={null}
hermes mcp add --url https://mcp.datalayer.so/mcp --auth oauth datalayer
```

Complete Datalayer sign-in at [app.datalayer.so](https://app.datalayer.so).
Hermes should store the token outside `config.yaml`.

**2. Or edit the config yourself**

If you prefer to edit `~/.hermes/config.yaml`, add a `datalayer` entry under
`mcp_servers` with this URL and OAuth authentication:

```yaml theme={null}
mcp_servers:
  datalayer:
    url: https://mcp.datalayer.so/mcp
    auth: oauth
```

Do not put keys in the YAML. Keep any servers you already have.

**3. Reload and verify**

Start Hermes chat. Run `/reload-mcp` if the new server does not appear.
Ask which Datalayer tools are available and how many credits remain. The
account read is `get_account_details` and costs 0 credits.

You can also paste the [universal setup prompt](https://docs.datalayer.so/getting-started.md#copy-this-into-your-assistant)
and let Hermes drive the same add-and-sign-in flow when the client supports it.

## What success looks like

The connector is connected, the [fifteen tools](https://docs.datalayer.so/tools.md) are listed,
`get_account_details` returns your balance, and a Stripe company search returns
matches. A search with results uses 1 credit. If sign-in fails after a previous disconnect,
use **Finish disconnecting** in [Datalayer Connections](https://app.datalayer.so/#connect)
first. See [help](https://docs.datalayer.so/help.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.