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: 60Why 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.”