Connect your Amazon seller data to ChatGPT in under 5 minutes.
Prerequisites
- A Kuudo account with a connected Amazon account.
- Your Kuudo API key from the dashboard.
- A ChatGPT Plus, Pro, Business, Enterprise, or Education account (MCP requires a paid plan).
Supported clients:
- ChatGPT
- OpenAI API
Add Kuudo as an MCP tool
Pass Kuudo as a remote MCP server in your Responses API request:
curl https://api.openai.com/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-5",
"tools": [
{
"type": "mcp",
"server_label": "Kuudo",
"server_url": "https://mcp.Kuudo.dev/mcp",
"server_description": "Amazon seller data: advertising, inventory, rankings, and more",
"headers": {
"Authorization": "Bearer YOUR_Kuudo_API_KEY"
},
"require_approval": "never"
}
],
"input": "Show me my top 5 campaigns by ACOS this week"
}'Replace YOUR_Kuudo_API_KEY with your Kuudo API key.
Tool approval
The require_approval field controls whether the model asks for confirmation before calling tools:
"never": Tools are called automatically (shown above)."always": Every tool call requires approval.
Kuudo also enforces its own guardrails on write tools: a $100 max bid cap, $0.02 minimum, and a warning when changes exceed 500% of the current value.
Troubleshooting
"Unauthorized" or 401 errors. Make sure you are using your Kuudo API key in the headers field, not your OpenAI key. The OpenAI key goes in the request's Authorization header.
Tools not discovered. Verify the server_url ends with /mcp. The model discovers available tools at request time via the MCP protocol.
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?"
- "Set 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
Kuudo exposes 87 domain-scoped data tools across eight 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, Brandations, budget recommendations, ad eligibility, audience segments |
| Ads (write) | 11 | Update bids, keyword state, archives, budgets, campaign state, audience bid adjustments, create keywords |
| Inventory (read) | 22 | FBA inventory, listing search, brand ASIN discovery, risk Kuudo, 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 ChatGPT: "List all available Kuudo tools."