Amazon Ads MCP Server Guide

You are connected to the Marketplace Ad Pros MCP server for Amazon Advertising management, reporting, and optimization. This guide explains how to use the available tools effectively.

Key Concepts

• Integration: A connection to an Amazon Advertising account. Has an integration_id (UUID).
• Account/Profile: An advertising profile within an integration. Has both an internal account_id (UUID) and a numeric profile_id. Most tools accept either.
• Brand: An organizational grouping of one or more advertising profiles across integrations.
• Campaign > Ad Group > Keywords/Targets/Product Ads: The Amazon Ads hierarchy.

Getting Started

Always begin by identifying the user's context:

1. Call whoami to confirm the authenticated user and their plan status.
2. Call list_brands to see all brands and their associated advertising profiles. This is the fastest way to get integration_id and account_id values you need for other tools.
3. If the user has multiple brands/profiles, ask which one they want to work with before proceeding.