amazon-ads-mcp

List all Amazon Ads advertiser profiles (accounts) accessible to these credentials in the configured region. Returns profileId, marketplace, currency, timezone and account info. Call this first: the profileId scopes every other tool.

Verify credentials and connectivity: refreshes the LwA access token and lists profiles, reporting region, latency and configuration (secrets redacted). Use to diagnose auth/setup issues.

List Sponsored Products campaigns (v3) with budgets, states, targeting type and dates. Paginate with nextToken. For performance metrics, use create_report instead — entity endpoints return configuration, not spend/sales.

List Sponsored Products ad groups (v3), optionally filtered to specific campaigns. Paginate with nextToken.

List Sponsored Products keywords (v3) with match types, bids and states. Filter by campaignIds or adGroupIds; paginate with nextToken.

List Sponsored Products targeting clauses (v3): product, category and auto-targeting expressions with bids and states.

List Sponsored Products product ads (v3): which ASINs/SKUs are advertised in which ad groups, with states.

List Sponsored Brands campaigns (v4) with budgets, states and dates. Paginate with nextToken. Use create_report (adProduct SPONSORED_BRANDS) for performance metrics.

List Sponsored Brands ad groups (v4), optionally filtered by campaign ids.

List Sponsored Display campaigns with budgets, tactics and states. Uses startIndex/count pagination (not nextToken).

List Sponsored Display ad groups with bid optimization settings and states.

Request an async performance report (Reporting v3) for Sponsored Products, Brands or Display. Returns a reportId immediately; reports typically complete in 1–15 minutes (up to ~3h for large accounts). Poll with get_report_status, then fetch data with download_report. Common reportTypeIds: spCampaign…

Check the status of an async report created with create_report. Status flows PENDING → PROCESSING → COMPLETED (or FAILURE with a reason). When COMPLETED, use download_report.

Download a COMPLETED report, decompress it, run data-integrity checks (column presence, non-negative metrics, daily date coverage) and return reconciled totals plus a row sample. Large result sets are NOT dumped into chat: totals are computed server-side and the full dataset can be saved to a local …

List Amazon DSP orders (campaigns) for a DSP advertiser profile. REQUIRES DSP entity access on your API client — accounts without a DSP seat get HTTP 403 (an Amazon entitlement, not a server bug).

Request an async Amazon DSP report (impressions, viewability, conversions, etc.) for a DSP account. Requires DSP API access. Returns a reportId; poll with dsp_get_report until the report has a download location.

Check status of a DSP report. When complete, the response includes a signed download location URL valid for a limited time.

List Amazon Marketing Cloud instances for an AMC entity. REQUIRES a provisioned AMC instance with this API client allow-listed; otherwise returns 403 (an Amazon entitlement, not a server bug).

List saved AMC SQL workflows on an instance.

Save an AMC SQL workflow on an instance. AMC SQL queries clean-room event tables (impressions, clicks, conversions); aggregation thresholds apply — queries returning user-level data are rejected by AMC.

Start an execution of a saved AMC workflow over a time window. Returns an execution id; poll with amc_get_execution, then fetch results with amc_get_download_urls.

Check the status of an AMC workflow execution (PENDING/RUNNING/SUCCEEDED/FAILED).

Get signed download URLs (CSV) for a SUCCEEDED AMC workflow execution. URLs expire after a short period.