Skip to content

Agents · Architecture

Agent Architecture Guides

An Amazon agent setup combines account access, current and historical data, reusable Skills, and an execution policy. For technical teams, each layer answers a different question: what the agent can read, how it interprets the result, and what it may change. These guides connect API selection, freshness, lineage, tool context, and approval boundaries.

Explore the product

An Amazon agent needs access, context, and a method

The model supplies general reasoning. Account connections supply current state. Landed data supplies history and provenance. Skills supply repeatable methods and decision rules. Approval policy determines which proposed actions may execute. These parts solve different problems; connecting a tool alone does not supply the business context needed to interpret its output.

The AI data-moat essay explains the role of account knowledge and operator judgment. The agent-ready data architecture guide turns that premise into storage, freshness, lineage, and workload requirements. The essay is a positioning argument; the architecture guide develops the operating design.

Which connection supplies the data your agent needs?

The Amazon Ads API serves advertising operations and reporting. The Selling Partner API serves selling operations such as orders, listings, inventory, and payments. They have separate authorization and account-scoping requirements. The Ads API versus SP-API guide explains why access to one does not imply access to the other.

Design choiceQuestion to answerDeeper guide
Live tools or landed historyDo you need current state, a reproducible historical comparison, or both?Agent-ready data
Model prompt or reusable methodWhich checks and approvals must survive the next run?Amazon Skills for Claude
MCP tool exposureWhat does the client load at connection, and when does it load more?MCP connection context cost
A seller-assistant pluginDoes its documented access cover your actual account questions?Seller Assistant plugin

Why do freshness and tool scope matter to the answer?

A stale inventory snapshot and a live inventory response can support different decisions. Preserve the source and capture time with landed records, and identify the account and marketplace on live requests. A plausible answer without that context can be difficult to reproduce or approve.

Tool names also need careful interpretation. The seller Messaging API guide shows a concrete boundary: its messaging operations send supported order messages; they do not read a buyer inbox. Check the actions an order permits before constructing a message. A connection is not permission to perform every imagined workflow.

Keep method, context cost, and execution policy separate

A Skill preserves the workflow; it does not replace authorization or grant a write permission. Similarly, tool-definition overhead depends on the server and the client's loading behavior. The connection-cost guide records a specific comparison, not a universal token bill for every client or future release.

This collection covers selected architecture choices and integration examples. Agent decision rules develops the calculation and action gates, while the MCP overview explains the tool-access layer. Use the Skills reference to inspect a method's actual scope before assigning it recurring work.

8 guides in this group

Agents · Architecture

What Is a Weekly Business Review (WBR) at Amazon?

A weekly business review (WBR) is Amazon's weekly metrics meeting. See what goes in an Amazon WBR deck, where each number comes from and when it is final.

Kuudo
Kuudo
14 min read
Agents · Architecture

Amazon Ads API vs Selling Partner API: Separate Jobs

Yes: the Amazon Ads API is separate from the Selling Partner API, with its own app approval, profiles and endpoints. What each holds, and how to use both.

Kuudo
Thomas Spicer
7 min read
Agents · Architecture

How to Integrate Amazon Seller Messages API With AI

How to integrate Amazon seller messages API calls: check what an order allows, send permitted messages, request reviews once, route events to a helpdesk.

Kuudo
Thomas Spicer
6 min read
Agents · Architecture

Amazon Seller Central Claude Plugin: What It Does

The Amazon Seller Central Claude plugin puts your seller data and Amazon's skills in Claude and Quick: what it covers, what's unpublished, how to test it.

Kuudo
Thomas Spicer
13 min read
Agents · Architecture

Best Claude Skills for Amazon Ads and Operations

Claude Skills for Amazon: 20 public Skills for Ads, AMC, listings, FBA stock, returns and margins, which start without an account, and how to install them.

Kuudo
Thomas Spicer
13 min read
Agents · Architecture

Amazon Ads MCP Token Cost: Compare Tool Catalogs

Amazon Ads MCP token cost at connection: Amazon's official server loads 92,678 tokens of tool definitions; Kuudo's loads 388 before the first call.

Kuudo
Thomas Spicer
9 min read
Agents · Architecture

AI-Ready Data Architecture for Amazon Analytics

Build AI-ready data architecture for Amazon analytics with source-shaped data, freshness, lineage, Skills, and Agent Flow in customer-owned storage.

Kuudo
Thomas Spicer
10 min read
Agents · Architecture

Your AI Data Moat Is What Competitors Cannot Copy

Your AI data moat is the operator knowledge generic models lack: bid rules, playbooks, prompts, and account context your team keeps in its own cloud.

Kuudo
Thomas Spicer
11 min read