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

# Hermes

> Add Lusor to Hermes Agent as a remote MCP server.

Hermes Agent connects to remote MCP servers with OAuth sign-in. No API key is needed.

**1. Add the server**

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

This writes the entry to `~/.hermes/config.yaml`:

```yaml theme={null}
mcp_servers:
  lusor:
    url: "https://mcp.lusor.ai/mcp"
    auth: oauth
```

**2. Sign in**

On first connect, Hermes opens the Lusor sign-in in your browser. Sign in and choose your organization. Hermes stores the token under `~/.hermes/mcp-tokens/` and refreshes it automatically.

On a remote host, open the printed link on your own machine and paste the redirected URL back into Hermes when it asks.

**3. Check the connection**

```bash theme={null}
hermes mcp test lusor
```

It lists Lusor's `search` and `execute` tools. In a running session, use `/reload-mcp` after changing the config.

## Use an API key instead

```yaml theme={null}
mcp_servers:
  lusor:
    url: "https://mcp.lusor.ai/mcp"
    headers:
      Authorization: "Bearer ${LUSOR_API_KEY}"
```

Use a key from your workspace's **API keys** page in the Lusor app, and keep it in an environment variable rather than in the file.

See [Connect an AI app](https://docs.lusor.ai/connect.md) for what Lusor allows over MCP.


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