Quick Start

Hermes Agent quickstart

Connect Hermes Agent to agentcentral in under 5 minutes. Once connected, Hermes can query advertising performance, inventory levels, orders, catalog records, keyword rankings, finance, and fulfillment data through 92 domain-scoped data tools.

Prerequisites

An agentcentral account with a connected Amazon account
Your agentcentral API key from the dashboard Keys tab
Hermes Agent installed and configured

Let Hermes Agent walk you through it

Copy this prompt into Hermes Agent. It will set up the server and, if needed, tell you how to set AGENT_CENTRAL_API_KEY locally.

1. Store your key locally

Add your agentcentral API key to ~/.hermes/.env. Do not paste the raw key into a Hermes conversation or shared config.

AGENT_CENTRAL_API_KEY=ac_live_...

If you launch Hermes from a shell or service manager, you can also set AGENT_CENTRAL_API_KEY in that environment. Hermes uses ${VAR_NAME} syntax in config; bare $VAR_NAME is not expanded.

2. Add the MCP server

Add agentcentral under the top-level mcp_servers key in ~/.hermes/config.yaml:

mcp_servers:
  agentcentral:
    url: "https://mcp.agentcentral.to/mcp"
    headers:
      Authorization: "Bearer ${AGENT_CENTRAL_API_KEY}"
    enabled: true
    timeout: 120
    connect_timeout: 60

Why use AGENT_CENTRAL_API_KEY

Hermes resolves AGENT_CENTRAL_API_KEY locally from ~/.hermes/.env or the environment that launched Hermes. That keeps your raw ac_live_... key out of chat and out of ~/.hermes/config.yaml.

If the variable is unset, Hermes leaves the placeholder unresolved and agentcentral authentication will fail.

3. Reload and verify

After editing ~/.hermes/config.yaml, restart Hermes or reload MCP from inside Hermes where available:

/reload-mcp

Then ask Hermes to use the agentcentral MCP server. Do not include your API key in the message.

“Use agentcentral to list the seller data available for this account.”

If the connection is working, Hermes should discover agentcentral tools across advertising, inventory, catalog, ranking, finance, and fulfillment.

Troubleshooting

“Unauthorized” or 401 errors

Make sure AGENT_CENTRAL_API_KEY is set in ~/.hermes/.env or in the environment that launches Hermes, then reload MCP or restart Hermes. If you lost the full key, create a new one from the dashboard Keys tab.

Variable not resolving

Use ${AGENT_CENTRAL_API_KEY} in config.yaml, not $AGENT_CENTRAL_API_KEY. Hermes only expands the braced syntax. If the variable is unset, the placeholder remains literal and authentication fails.

Tools not appearing

Confirm the server is under top-level mcp_servers, the URL is exactly https://mcp.agentcentral.to/mcp, and enabled is not set to false. Reload MCP after saving config changes.

Slow responses

agentcentral queries pre-synced seller data, so most responses return in under a second. If you see timeouts, check network connectivity or increase the Hermes server timeout value.

Available tools

agentcentral exposes 92 domain-scoped data tools across 6 domains, plus get_account_data_tour for first-run evidence tours, create_shareable_report, update_shareable_report, and delete_shareable_report for explicit share-link requests, and submit_conversation_feedback for explicit user-confirmed product feedback:

Domain	Tools	Examples
Ads (read)	23	Campaign performance, portfolio rollups, campaign history, DSP, Brand Store insights, budget pacing, search terms, SQP, ads coverage evidence, Brand Metrics, TACOS
Ads (direct API)	4	Bid recommendations, budget recommendations, ad eligibility, audience segments
Ads (write)	12	Update keyword, target, ad group, campaign, budget, state, archive, audience bid adjustment, keyword creation, and negative keyword writes
Inventory (read)	22	FBA inventory, listing search, brand ASIN discovery, risk triage, inbound shipments, sales velocity, orders, returns, days of cover
Inventory (direct API)	7	Buy Box, pricing history, restock, FBA eligibility
Finance	4	Fee breakdown, profitability, profitability review, settlement economics
Catalog	13	Product details, sales ranks, A+ Content, variations, customer feedback, listing quality, catalog cleanup, create listing, update listing, update price, update quantity
Ranking	3	Keyword ranks, rank changes, rank with search volume
Fulfillment	4	MCF orders, shipping preview, create order, manage returns

For the full tool reference, ask Hermes Agent: “List all available agentcentral tools.”