agentcentral
Start free trial
DocsHermes Agent

Quick Start

Quick Start: agentcentral + Hermes Agent

Connect your Amazon seller data to Hermes Agent in under 5 minutes.

Prerequisites

  • An agentcentral account with a connected Amazon account (all Amazon marketplaces supported)
  • An API key from the dashboard (starts with ac_live_)
  • Hermes Agent installed

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:

AGENT_CENTRAL_API_KEY=ac_live_...

You can also set the variable in the shell or service manager that launches Hermes. Hermes config uses ${VAR_NAME} syntax; 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 from ~/.hermes/.env or the environment that launched Hermes. Your raw ac_live_... key stays out of chat history and out of ~/.hermes/config.yaml.

If the variable is unset, authentication will fail.

3. Reload and verify

Restart Hermes or reload MCP from inside a Hermes session:

/reload-mcp

Then ask Hermes to list agentcentral tools. If the connection is working, Hermes will enumerate tools across ads, inventory, finance, catalog, ranking, and fulfillment.

“What tools do you have from agentcentral?”

Troubleshooting

“Unauthorized” or 401 errors

Confirm AGENT_CENTRAL_API_KEY is set in ~/.hermes/.env or in the environment that launches Hermes, then reload MCP or restart. 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 unset, the placeholder stays literal and authentication fails.

Tools not appearing

Confirm the server is under top-level mcp_servers, the URL ends with /mcp, and enabled is not false. Reload MCP after saving config changes.

Slow responses

Most tool calls return in under a second. If you see timeouts, check your network connection or increase the Hermes timeout value.

New to the platform? Read how agentcentral works.

Start using tools

Try these examples:

Advertising

“Show me my top 10 campaigns by ACOS for the last 7 days.”
“Which search terms drove the most ad spend last week with zero sales?”
“Lower the bid on keyword ‘dog treats’ to $1.50 in campaign ‘Pet Supplies SP’.”

Inventory

“What’s my current FBA inventory for ASIN B0EXAMPLE?”
“Which SKUs have fewer than 14 days of cover?”
“Show me today’s sales so far.”

Rankings

“How did my keyword rankings change yesterday for ‘wireless earbuds’?”
“Show me rank positions with search volume for my top keywords.”

Finance

“Break down the fees for ASIN B0EXAMPLE.”
“What’s the profitability on my top 5 SKUs?”

Available tools

agentcentral exposes 144 data tools across 6 domains, plus utilities for account onboarding, key status, action history, and product feedback:

DomainToolsExamples
Ads (read)25Campaign performance, portfolio rollups, campaign snapshots, DSP, Brand Store insights, budget pacing, search terms, SQP, ads coverage evidence, Brand Metrics, TACOS
Ads (direct API)10Bid recommendations, budget recommendations, ad eligibility, audience segments, DSP advertiser/entity records, live SP/SB/SD entity state, and targeting options
Ads (write)59Update keyword, target, ad group, campaign, budget, state, archive, audience bid adjustment, campaign/ad group/product ad/target creation, ad group/product ad lifecycle, SD archive operations, and negative targeting writes
Inventory (read)22FBA inventory, storage fees, listing registry, risk triage, inbound shipments, sales velocity, orders, returns, days of cover
Inventory (direct API)7Buy Box, pricing history, Subscribe & Save offers, FBA eligibility
Finance4Payment transactions, financial events, profitability review, settlement economics
Catalog12Product details, sales ranks, A+ Content, variations, customer feedback, listing quality, catalog cleanup, create listing, update listing, update price, update quantity
Ranking1Keyword rank positions, changes, and search-volume view
Fulfillment4MCF orders, shipping preview, create order, manage returns

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