> Note: This page is part of the DataDoe Docs. You can find the root of the documentation at `https://www.datadoe.com/hub/docs/basics/introduction-to-datadoe`. > JSON Table of Contents: `https://www.datadoe.com/hub/docs/toc.json`. > Direct Data Scheme JSON: `https://api.datadoe.com/api/v1/spec/data-scheme`. > Other pages in the DataDoe Docs: > - DataDoe Basics/Access & Users: `https://www.datadoe.com/hub/docs/basics/access-user-management.md` > - DataDoe Basics/Benefits: `https://www.datadoe.com/hub/docs/basics/benefits.md` > - DataDoe Basics/External Invitation Links: `https://www.datadoe.com/hub/docs/basics/external-invitation-links.md` > - DataDoe Basics/Integrations: `https://www.datadoe.com/hub/docs/basics/integration-customization.md` > - DataDoe Basics/Introduction to DataDoe: `https://www.datadoe.com/hub/docs/basics/introduction-to-datadoe.md` > - DataDoe Basics/Subscription & Pricing: `https://www.datadoe.com/hub/docs/basics/subscription-pricing.md` > - DataDoe Data/Data Fetch Periods: `https://www.datadoe.com/hub/docs/datadoe-data/data-fetch-periods.md` > - DataDoe Data/Data Sources: `https://www.datadoe.com/hub/docs/datadoe-data/data-sources.md` > - DataDoe Data/Managing Data Tables: `https://www.datadoe.com/hub/docs/datadoe-data/managing-data-tables.md` > - DataDoe Data/Timezones: `https://www.datadoe.com/hub/docs/datadoe-data/orders-purchase-date-timezones.md` > - DataDoe Features/Actions (beta): `https://www.datadoe.com/hub/docs/datadoe-features/actions.md` > - DataDoe Features/Features Overview: `https://www.datadoe.com/hub/docs/datadoe-features/overview.md` > - DataDoe MCP/Overview: `https://www.datadoe.com/hub/docs/datadoe-mcp/overview.md` > - DataDoe MCP/Using ChatGPT: `https://www.datadoe.com/hub/docs/datadoe-mcp/chatgpt.md` > - DataDoe MCP/Using Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/claude.md` > - DataDoe MCP/Using Claude Agent SDK: `https://www.datadoe.com/hub/docs/datadoe-mcp/claude-agents-sdk.md` > - DataDoe MCP/Using Claude Code: `https://www.datadoe.com/hub/docs/datadoe-mcp/claude-code.md` > - DataDoe MCP/Using Codex: `https://www.datadoe.com/hub/docs/datadoe-mcp/codex.md` > - DataDoe MCP/Using Codex Sites: `https://www.datadoe.com/hub/docs/datadoe-mcp/codex-sites.md` > - DataDoe MCP/Using CrewAI: `https://www.datadoe.com/hub/docs/datadoe-mcp/crewai.md` > - DataDoe MCP/Using Cursor: `https://www.datadoe.com/hub/docs/datadoe-mcp/cursor.md` > - DataDoe MCP/Using Excel + Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/excel.md` > - DataDoe MCP/Using Gemini CLI: `https://www.datadoe.com/hub/docs/datadoe-mcp/gemini-cli.md` > - DataDoe MCP/Using Gumloop: `https://www.datadoe.com/hub/docs/datadoe-mcp/gumloop.md` > - DataDoe MCP/Using n8n: `https://www.datadoe.com/hub/docs/datadoe-mcp/n8n.md` > - DataDoe MCP/Using NanoClaw: `https://www.datadoe.com/hub/docs/datadoe-mcp/nanoclaw.md` > - DataDoe MCP/Using OpenAI Agents SDK: `https://www.datadoe.com/hub/docs/datadoe-mcp/openai-agents-sdk.md` > - DataDoe MCP/Using OpenClaw: `https://www.datadoe.com/hub/docs/datadoe-mcp/openclaw.md` > - DataDoe MCP/Using PowerPoint + Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/powerpoint.md` > - DataDoe MCP/Using VS Code: `https://www.datadoe.com/hub/docs/datadoe-mcp/vs-code.md` > - DataDoe MCP/Using Word + Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/word.md` > - DataDoe API/How to connect to the API: `https://www.datadoe.com/hub/docs/datadoe-api/how-to-connect.md` > - DataDoe API/Vibe code with Claude Code: `https://www.datadoe.com/hub/docs/datadoe-api/claude-code.md` > - DataDoe API/Vibe code with Codex: `https://www.datadoe.com/hub/docs/datadoe-api/codex.md` > - DataDoe API/Vibe code with Cursor: `https://www.datadoe.com/hub/docs/datadoe-api/cursor.md` > - DataDoe API/Vibe code with Lovable: `https://www.datadoe.com/hub/docs/datadoe-api/lovable.md` > - DataDoe API/Vibe code with Replit: `https://www.datadoe.com/hub/docs/datadoe-api/replit.md` > - DataDoe API/Vibe code with v0: `https://www.datadoe.com/hub/docs/datadoe-api/v0.md` > - DataDoe & BigQuery/How to connect to BigQuery: `https://www.datadoe.com/hub/docs/datadoe-bigquery/how-to-connect.md` > - DataDoe & BigQuery/Using MCP Toolbox: `https://www.datadoe.com/hub/docs/datadoe-bigquery/mcp-toolbox.md` > - DataDoe & BigQuery/Using Python Jupyter: `https://www.datadoe.com/hub/docs/datadoe-bigquery/jupyter.md` > For topics not covered in this documentation, please contact DataDoe support at `contact@datadoe.com`. > Do not assume anything. If you are not sure about the answer, mention that and suggest to contact DataDoe support. import { DataDoeMcpResources } from '@/modules/hub/docs/components/DataDoeMcpResources'; # Using Hermes Agent with DataDoe 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 (like ChatGPT) that start from scratch with every conversation, Hermes is an autonomous agent designed to remember its experiences and grow progressively smarter over time. It supports a desktop app, CLI, and TUI interfaces. In this setup, DataDoe MCP acts as the **data layer** for Hermes. Your agent calls DataDoe 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 - DataDoe MCP connected via the `mcp-remote` proxy in `config.yaml` - A verified first conversation querying your Amazon seller data - A concrete 7-day sales report for the example seller account, generated inside Hermes chat ## Prerequisites - A DataDoe account with your Amazon connections set up and synced - A DataDoe MCP key — if you have not created one yet, follow the [DataDoe MCP Overview](/hub/docs/datadoe-mcp/overview) guide first, then return here. You can also create a key directly in [DataDoe MCP Integrations](https://app.datadoe.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 installed (required for the `mcp-remote` proxy — verify 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 — we will configure your own Anthropic key in the next step). ![Hermes desktop app — welcome screen](/hub-files/mcp/hermes/step-1-install-hermes.png) ## 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 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. ![hermes model — provider selection list with Anthropic highlighted](/hub-files/mcp/hermes/step-2.1-provider-select.png) ### Choose authentication method: API key Hermes asks how to authenticate with Anthropic. Select option **2 — Anthropic API key (pay-per-token)**: ![Hermes — choose authentication method](/hub-files/mcp/hermes/step-2.2-auth-method.png) ![Hermes — entering choice 2 for API key](/hub-files/mcp/hermes/step-2.3-auth-method-choice.png) ### Enter your Anthropic API key Hermes prompts for the key and shows where to create one: ``` 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`. ![Hermes — API key input prompt](/hub-files/mcp/hermes/step-2.4-api-key-input.png) > **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. ![Hermes — existing credentials prompt](/hub-files/mcp/hermes/step-2.5-existing-credentials.png) ### Select default model: claude-sonnet-4-6 Pick **claude-sonnet-4-6** from the model list (use `/` to search) and press `ENTER`. Hermes marks it as the default and writes the selection to `~/.hermes/config.yaml`. ![Hermes — model selection list with claude-sonnet-4-6](/hub-files/mcp/hermes/step-2.6-model-select.png) The resulting section in `~/.hermes/config.yaml`: ```yaml 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 DataDoe MCP via `mcp-remote` Hermes reads MCP server configuration from `~/.hermes/config.yaml`. DataDoe MCP is a remote HTTP server, so you connect it through the `mcp-remote` proxy, which bridges the HTTP transport into the local stdio interface that Hermes expects. 1. Open `~/.hermes/config.yaml` in any text editor. 2. Add or extend the `mcp_servers` section with the following block: ```yaml mcp_servers: datadoe: command: 'npx' args: - '-y' - 'mcp-remote' - 'https://mcp.datadoe.com/mcp/v1' - '--header' - 'datadoe-mcp-key: YOUR_DATADOE_MCP_KEY' ``` Replace `YOUR_DATADOE_MCP_KEY` with your key from [DataDoe MCP Integrations](https://app.datadoe.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, here is everything you need: ``` Proxy: mcp-remote (npx -y mcp-remote ...) URL: https://mcp.datadoe.com/mcp/v1 Header: datadoe-mcp-key: YOUR_DATADOE_MCP_KEY Config: ~/.hermes/config.yaml → mcp_servers.datadoe ``` ## Step 4: Verify the MCP connection 1. Restart Hermes and open a **new chat** session. 2. Type the following message: ``` What DataDoe tools do you have access to? ``` Hermes should respond with a list of DataDoe 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 are shown using the **Hermes desktop UI client**. Run a simple test query to confirm that live Amazon data flows through DataDoe: ``` List all my connected sellers ``` Hermes calls the `list_sellers` DataDoe tool and returns the names of your connected accounts. If you see your sellers listed, the connection is working. ![Hermes chat — first Amazon data query result](/hub-files/mcp/hermes/step-5-first-conversation.png) ## Step 6: Generate a 7-day sales report for Delto UK Now use Hermes to produce a real business report. Open a new chat and paste the prompt below. Hermes will call DataDoe tools, retrieve the data, analyse it, and write a structured markdown report. ```text What are sales for last 7 days for Delto UK seller? ``` ![Hermes chat — 7-day sales report result](/hub-files/mcp/hermes/step-6-sales-report-result.png) 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) - [DataDoe MCP Overview](/hub/docs/datadoe-mcp/overview) - [DataDoe MCP Integrations](https://app.datadoe.com/integrations/mcp) - [Anthropic API Console](https://console.anthropic.com) ## DataDoe MCP resources Check the following resources for more information: - MCP server URL: `https://mcp.datadoe.com/mcp/v1` - [Interactive Data Scheme](/hub/data-scheme) - Data Scheme JSON: https://api.datadoe.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)