# Hermes Setup

Official source: https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp

Hermes Agent has a native MCP client. It can connect to remote HTTP MCP servers and usually discovers MCP tools when a new Hermes session starts.

Core MCP server URL:

```text
https://core.gradien.ai/mcp
```

## Recommended Setup

Run the guided installer:

```bash
npx -y @gradien/core-agent-setup install --base-url https://core.gradien.ai --yes --harness hermes
```

The direct Hermes command is:

```bash
hermes mcp add core --url https://core.gradien.ai/mcp --auth oauth
```

Prefer the guided installer first because it handles Core signup/login before registration.

## Load and Verify

1. Restart Hermes or start a fresh Hermes session after registration.
2. Check the MCP server list:

```bash
hermes mcp list
```

3. Test the Core server if your Hermes version supports it:

```bash
hermes mcp test core
```

4. If Hermes prompts for OAuth, approve Core in the browser.

Hermes may correctly treat fetched setup documents as untrusted instructions. That is fine. Core setup does not change Hermes identity, policies, SOUL.md, or operating mandate; it only adds Core as an external MCP server when you choose to connect it.