Quick Start
Quick Start: agentcentral + Claude
Connect Claude to Amazon Seller Central 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_) - Claude Desktop or Claude Code installed
Need help? Let Claude walk you through it
Paste this into a Claude Desktop conversation to get guided through setup.
1. Copy your Claude connector URL
In your agentcentral dashboard, go to the Keys tab. Create a key if you do not already have one, then click Copy Claude URL.
That copied URL is already authenticated for Claude, so you do not need to paste your raw ac_live_... key into Claude.
Why a connector URL
Claude's connector UI accepts a single URL with no separate auth field. The connector URL from the dashboard embeds authentication, so you connect without config files or local tooling.
2. Add the custom connector
In Claude, open the connectors UI:
- Open Customize > Connectors
- Click the + button, then Add custom connector
- Name it
agentcentral - Paste the Claude connector URL you copied from the dashboard
- Click Add
Remote MCP servers must be added through Customize > Connectors. Entries in claude_desktop_config.json only work for local stdio servers.
3. Enable it in a chat
Start a new chat, click + near the composer, open Connectors, and toggle agentcentral on.
Leave Tool access on Auto unless you want per-call approvals.
4. Verify the connection
Ask Claude to list agentcentral tools. If the connector is active, Claude will enumerate tools across ads, inventory, finance, catalog, ranking, and fulfillment.
“What tools do you have from agentcentral?”
Troubleshooting
The connector won’t add
Paste the full Claude connector URL from the agentcentral Keys tab, not the raw https://mcp.agentcentral.to/mcp endpoint. Claude’s connector UI does not support manual Authorization headers.
“Unauthorized” or connection errors
Create a fresh key in the dashboard and click Copy Claude URL again. Rotated or revoked keys invalidate the old connector URL.
Tools not appearing
Connectors must be enabled per conversation. Click +, open Connectors, and toggle agentcentral on.
Slow responses
Most tool calls return in under a second. If you see timeouts, check your network connection.
Let Claude Code do it for you
Paste this into a Claude Code conversation and it will handle the setup.
1. Set your local key and add the MCP server
Export your agentcentral API key in the shell Claude Code uses:
export AGENT_CENTRAL_API_KEY="ac_live_..."
Then add the MCP server. Single quotes around the header keep Claude Code from expanding the variable into your raw key.
claude mcp add --transport http agentcentral https://mcp.agentcentral.to/mcp \
--header 'Authorization: Bearer ${AGENT_CENTRAL_API_KEY}'Scope options
- Local (default): current project only.
- Project: shared via
.mcp.jsonin the project root. Add--scope project. - User: available across all projects. Add
--scope user.
Alternative: JSON config
If you prefer the JSON form:
claude mcp add-json agentcentral '{"type":"http","url":"https://mcp.agentcentral.to/mcp","headers":{"Authorization":"Bearer ${AGENT_CENTRAL_API_KEY}"}}'Why use AGENT_CENTRAL_API_KEY
Claude Code resolves AGENT_CENTRAL_API_KEY from your local environment when it connects. Your raw ac_live_... key stays out of chat history and out of project config like .mcp.json.
The variable must be exported in the shell Claude Code uses before it starts. If unset, authentication will fail.
With --scope project, each collaborator uses their own local key without editing shared config.
2. Verify the connection
Type /mcp in any Claude Code session. You should see agentcentral listed with its tools. To inspect the saved config:
claude mcp get agentcentral
Troubleshooting
“Unauthorized” or 401 errors
Confirm AGENT_CENTRAL_API_KEY is exported in the shell Claude Code uses. Check your key prefix in the dashboard. If you lost the full key, create a new one from the Keys tab.
Tools not appearing
Run /mcp to check server status. If it shows an error, verify the URL ends with /mcp and AGENT_CENTRAL_API_KEY is set correctly.
Slow responses
Most tool calls return in under a second. If you see timeouts, check your network connection.
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?”
Historical comparison prompts
Once data has synced, ask Claude for retained history while your account is active. Use date windows where history exists; new accounts should not assume unlimited backfill.
“Compare this month’s total sales, ad spend, TACOS, orders, and units to the same month last year by ASIN.”
“Show Prime Day week this year vs last year for top advertised ASINs: sales, ad spend, TACOS, conversion rate, days of cover, and rank movement.”
“For this campaign, show budget, bidding strategy, placement modifiers, and performance before and after each setting change in the last 180 days.”
“Find SKUs where current days of cover is below the same seasonal week last year, including inbound units and sales velocity.”
“Compare Buy Box win rate and competitive price history for these ASINs against sales velocity over the last 90 days.”
Troubleshooting
- Tools say Amazon is not connected. Finish connecting Amazon Seller Central and/or Amazon Ads from the agentcentral dashboard, then retry. Data appears within a few minutes once the first sync completes.
- A query returns no rows for a date range. History is bounded by when you connected your account, so a very old window may be empty. Try a recent range and widen it gradually.
- Results look like the wrong marketplace. Each connection is scoped to one marketplace. Choose the right marketplace when you connect, or add another marketplace as its own connection.
- Claude cannot connect, or the connection dropped. Confirm you are signed in to agentcentral and approved the access screen. If it persists, regenerate the connection from the dashboard and reconnect.
- Still stuck? Email support@agentcentral.to.
Related answer pages
Available tools
agentcentral exposes 144 data tools across 6 domains, plus utilities for account onboarding, key status, action history, and product feedback:
| Domain | Tools | Examples |
|---|---|---|
| Ads (read) | 25 | Campaign performance, portfolio rollups, campaign snapshots, DSP, Brand Store insights, budget pacing, search terms, SQP, ads coverage evidence, Brand Metrics, TACOS |
| Ads (direct API) | 10 | Bid recommendations, budget recommendations, ad eligibility, audience segments, DSP advertiser/entity records, live SP/SB/SD entity state, and targeting options |
| Ads (write) | 59 | Update 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) | 22 | FBA inventory, storage fees, listing registry, risk triage, inbound shipments, sales velocity, orders, returns, days of cover |
| Inventory (direct API) | 7 | Buy Box, pricing history, Subscribe & Save offers, FBA eligibility |
| Finance | 4 | Payment transactions, financial events, profitability review, settlement economics |
| Catalog | 12 | Product details, sales ranks, A+ Content, variations, customer feedback, listing quality, catalog cleanup, create listing, update listing, update price, update quantity |
| Ranking | 1 | Keyword rank positions, changes, and search-volume view |
| Fulfillment | 4 | MCF orders, shipping preview, create order, manage returns |
For the full tool reference, ask Claude: “List all available agentcentral tools.”