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

# Use Hermes Agent with Marrow MCP

# Use Hermes Agent with Marrow MCP

[Hermes Agent](https://hermes-agent.nousresearch.com) is an open-source, self-hosted AI agent created by [Nous Research](https://nousresearch.com). Unlike standard AI chat assistants, such as ChatGPT, that start from scratch with every conversation, Hermes is an autonomous agent designed to remember its experiences and learn over time. It supports a desktop app, CLI and TUI interfaces.

In this setup, Marrow MCP acts as the **data layer** for Hermes. Your agent calls Marrow tools to read live Amazon Seller, Vendor, and Ads data on demand, without manual exports or custom SP-API pipelines.

## What you will build

By the end of this tutorial, you will have:

* Hermes Agent installed and running on your machine with the desktop UI
* an Anthropic LLM configured with your own API key
* Marrow MCP connected through the `mcp-remote` proxy in `config.yaml`
* a verified first conversation that queries your Amazon seller data
* a concrete 7-day sales report for the example seller account, generated inside Hermes chat

## Prerequisites

* A Marrow account with your Amazon connections set up and synced.
* A Marrow MCP key. If you have not created one yet, follow the [Marrow MCP Overview](/hologrow-marrow-mcp/overview) guide first, then return here. You can also create a key directly in [Marrow MCP Integrations](https://app.marrow.com/integrations/mcp).
* An **Anthropic API key**. Sign up at [console.anthropic.com](https://console.anthropic.com) and create a key under **API Keys**.
* [Node.js](https://nodejs.org) 18 or later, which is required for the `mcp-remote` proxy. Verify your version with `node --version`.

## Step 1: Install Hermes

1. Download the Hermes desktop installer for your operating system from [hermes-agent.nousresearch.com](https://hermes-agent.nousresearch.com).
2. Run the installer and open the Hermes desktop app.
3. Follow the initial onboarding prompts. You can skip the Nous Portal step because you will configure your own Anthropic key in the next step.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/hologrowinc/hub-files/mcp/hermes/step-1-install-hermes.png" alt="Hermes desktop app - welcome screen" />

## Step 2: Configure an Anthropic LLM

Hermes supports many LLM providers. This tutorial uses **claude-sonnet-4-6** via a direct Anthropic API key, configured through the Hermes CLI.

In your terminal, run:

```bash theme={null}
hermes model
```

This launches the interactive model picker. Follow the steps below.

### Select provider: Anthropic

Use the arrow keys to navigate to **Anthropic (Claude models via API key or Claude Code)** and press `ENTER` to select it.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/hologrowinc/hub-files/mcp/hermes/step-2.1-provider-select.png" alt="hermes model - provider selection list with Anthropic highlighted" />

### Choose authentication method: API key

Hermes asks how to authenticate with Anthropic. Select option **2: Anthropic API key (pay-per-token)**.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/hologrowinc/hub-files/mcp/hermes/step-2.2-auth-method.png" alt="Hermes - choose authentication method" />

<img src="https://mintlify.s3.us-west-1.amazonaws.com/hologrowinc/hub-files/mcp/hermes/step-2.3-auth-method-choice.png" alt="Hermes - entering choice 2 for API key" />

### Enter your Anthropic API key

Hermes prompts for the key and shows where to create one:

```text theme={null}
Get an API key at: https://platform.claude.com/settings/keys
API key (sk-ant-...): _
```

Paste your key from [console.anthropic.com/settings/keys](https://console.anthropic.com/settings/keys) and press `ENTER`.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/hologrowinc/hub-files/mcp/hermes/step-2.4-api-key-input.png" alt="Hermes - API key input prompt" />

> **Already have credentials stored?** If you have previously authenticated, Hermes shows a **Use existing credentials / Reauthenticate** prompt instead. Choose **Use existing credentials** to skip re-entry.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/hologrowinc/hub-files/mcp/hermes/step-2.5-existing-credentials.png" alt="Hermes - existing credentials prompt" />

### Select the default model: claude-sonnet-4-6

Pick **claude-sonnet-4-6** from the model list, using `/` to search, and press `ENTER`. Hermes marks it as the default and writes the selection to `~/.hermes/config.yaml`.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/hologrowinc/hub-files/mcp/hermes/step-2.6-model-select.png" alt="Hermes - model selection list with claude-sonnet-4-6" />

The resulting section in `~/.hermes/config.yaml`:

```yaml theme={null}
model:
    provider: anthropic
    default: claude-sonnet-4-6
```

> **Already inside a Hermes chat?** Use `/model claude-sonnet-4-6 --provider anthropic --global` to hot-swap the running session and persist the change at the same time.

## Step 3: Connect Marrow MCP via `mcp-remote`

Hermes reads MCP server configuration from `~/.hermes/config.yaml`. Marrow MCP is a remote HTTP server, so you connect it through the `mcp-remote` proxy. The proxy bridges the HTTP transport into the local stdio interface that Hermes expects.

1. Open `~/.hermes/config.yaml` in a text editor.
2. Add or extend the `mcp_servers` section with the following block:

```yaml theme={null}
mcp_servers:
    marrow:
        command: 'npx'
        args:
            - '-y'
            - 'mcp-remote'
            - 'https://mcp.marrow.com/mcp/v1'
            - '--header'
            - 'marrow-mcp-key: YOUR_MARROW_MCP_KEY'
```

Replace `YOUR_MARROW_MCP_KEY` with your key from [Marrow MCP Integrations](https://app.marrow.com/integrations/mcp).

3. Save the file and **restart Hermes** (quit and reopen the desktop app).

### Quick setup reference

If you are already familiar with Hermes, use this setup reference:

```text theme={null}
Proxy:    mcp-remote  (npx -y mcp-remote ...)
URL:      https://mcp.marrow.com/mcp/v1
Header:   marrow-mcp-key: YOUR_MARROW_MCP_KEY
Config:   ~/.hermes/config.yaml  →  mcp_servers.marrow
```

## Step 4: Verify the MCP connection

1. Restart Hermes and open a **new chat**.
2. Type the following message:

```text theme={null}
What Marrow tools do you have access to?
```

Hermes should respond with a list of Marrow MCP tools, such as `list_sellers`, `query_table`, and others. If no tools appear, check that Node.js is installed and that the `mcp_servers` block in `config.yaml` is correctly indented.

## Step 5: First conversation with Amazon data

> **CLI or UI: your choice.** You can chat with Hermes from the terminal (`hermes chat`) or from the [Hermes desktop UI](https://hermes-agent.nousresearch.com). Both interfaces share the same `config.yaml` and MCP setup. The examples from this step onwards use the **Hermes desktop UI client**.

Run a simple test query to confirm that live Amazon data flows through Marrow:

```text theme={null}
List all my connected sellers
```

Hermes calls the `list_sellers` Marrow tool and returns the names of your connected accounts. If you see your sellers listed, the connection is working.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/hologrowinc/hub-files/mcp/hermes/step-5-first-conversation.png" alt="Hermes chat - first Amazon data query result" />

## Step 6: Generate a 7-day sales report for Delto UK

Now use Hermes to produce a business report. Open a new chat and paste the prompt below. Hermes will call Marrow tools, retrieve the data, analyse it, and write a structured markdown report.

```text theme={null}
What are sales for last 7 days for Delto UK seller?
```

<img src="https://mintlify.s3.us-west-1.amazonaws.com/hologrowinc/hub-files/mcp/hermes/step-6-sales-report-result.png" alt="Hermes chat - 7-day sales report result" />

Hermes will:

1. Call `list_sellers` to confirm the Delto UK account.
2. Query the `Profit by SKU & Date` table for the last 7 days.
3. Analyse the data and produce a structured markdown report with per-SKU breakdowns, daily rows, and executive KPIs.

***

## Related resources

* [Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs/user-guide/configuring-models)
* [mcp-remote on npm](https://www.npmjs.com/package/mcp-remote)
* [Marrow MCP Overview](/hologrow-marrow-mcp/overview)
* [Marrow MCP Integrations](https://app.marrow.com/integrations/mcp)
* [Anthropic API Console](https://console.anthropic.com)

## Marrow MCP resources

Check the following resources for more information:

* MCP server URL: `https://mcp.marrow.com/mcp/v1`
* [Interactive Data Scheme](/hub/data-scheme)
* Data Scheme JSON: [https://api.marrow.com/api/v1/spec/data-scheme](https://api.marrow.com/api/v1/spec/data-scheme)
* Need help? Use the [contact form](https://forms.clickup.com/9015200219/f/8cnj2ev-38615/AOYF9I35QFOXWJQXIG?type=Form\&source=hub-mcp-hermes-docs)