Skip to main content
Glama
Amazon Ads MCP Server

Amazon Ads MCP Server

by get-mcp-ads

Amazon Ads MCP server

Bring your Amazon Ads profiles into your MCP client.

Read Sponsored Products, Brands and Display configuration, request performance reports and prepare changes for explicitly selected advertising profiles.

Release CI License: Apache 2.0 Node

Watch the film · What's new · Install · Tool reference · Try hosted getmcpads

Watch the getmcpads film: every ad account in one conversation with your AI assistant

Play the 45-second film

The film shows hosted getmcpads with sample data. Its MCP Apps, from creative galleries and alerts to Google Sheets exports and bulk launches, belong to the hosted product. This repository provides the standalone native API tools.

31 read tools · 77 write tools, disabled by default.

Run locally with your own Login with Amazon application and a client that supports stdio MCP, such as Claude Desktop, Claude Code or Cursor. Your requests go directly to the Amazon Ads API. For managed connections, including supported ChatGPT setups, use the hosted option.

What's new

v1.0.2: Maintainer metadata update · November 8, 2026

  • List the getmcpads team as maintainer in package.json, the README and SOURCE_SYNC.md.

  • No change to tools, parameters, descriptions or runtime behaviour.

Earlier releases

Version

Date

Highlights

1.0.1

October 26, 2026

Zod 4 security update

1.0.0

October 23, 2026

First standalone release

Full changelog · All releases

Source synchronization: SOURCE_SYNC.md.

Upgrade notes

Requires Node.js 22.23.4, 24.22.1, 26.12.1 or a newer release. These carry the October 2026 security fixes, and the server prints a warning on stderr when it runs on an older one. CI covers Node 22, 24 and 26.

This is the first release. Arguments saved from hosted getmcpads use region-qualified account IDs such as EU:1234567890; they are accepted when the region matches AMAZON_ADS_REGION.

Related MCP server: LinkedIn Ads MCP Toolkit

Install this release

This is a GitHub source release. npm and MCP Registry versions are published separately. The commands below select this exact version; unpinned npx examples later in this document select the version currently available on npm.

git clone --branch v1.0.2 --depth 1 https://github.com/get-mcp-ads/amazon-ads-mcp-server.git
cd amazon-ads-mcp-server
npm ci
npm run build

Configure your MCP client to run node with the absolute path to dist/cli.js and the credentials documented below.

Prefer a managed connection? Use Amazon Ads with hosted getmcpads. Connect your account, select the data your assistant may access and use the hosted MCP connection. See the site for current features and plans.

Configuration

Provide these environment variables through the client's secret configuration:

Variable

Purpose

AMAZON_ADS_CLIENT_ID

Client ID of a Login with Amazon security profile that has Amazon Ads API access.

AMAZON_ADS_CLIENT_SECRET

Client secret of that security profile.

AMAZON_ADS_REFRESH_TOKEN

Refresh token from the authorization grant. It starts with Atzr|. An access token (Atza|) is refused, because it expires after an hour.

AMAZON_ADS_REGION

NA, EU or FE. Selects the API host and the token URL. Use the region of the profiles below.

AMAZON_ADS_PROFILE_IDS

Required comma-separated advertising profile IDs. Every other profile is refused before any request, reads included.

AMAZON_ADS_ENABLE_WRITES

Defaults to false. Only the exact value true exposes the write tools.

To obtain these values, follow Amazon's own guides:

  1. Onboard to the Amazon Ads API and note the client ID and secret of your Login with Amazon security profile.

  2. Create an authorization grant with the scope advertising::campaign_management, then generate access and refresh tokens. Amazon documents that refresh tokens issued on or after July 30, 2026 expire 365 days after advertiser consent.

  3. Retrieve your profile IDs and list the ones this server may use in AMAZON_ADS_PROFILE_IDS.

This package does not run an OAuth browser flow. It exchanges the refresh token for access tokens in memory, renews them a minute before they expire and keeps any refresh token Amazon returns in memory only. When the refresh token is revoked or expires, authorize again, update the variable and restart the server.

A Claude Desktop entry looks like this:

{
  "mcpServers": {
    "amazon-ads": {
      "command": "npx",
      "args": ["-y", "@getmcpads/amazon-ads-mcp-server"],
      "env": {
        "AMAZON_ADS_CLIENT_ID": "amzn1.application-oa2-client.your-client-id",
        "AMAZON_ADS_CLIENT_SECRET": "your-client-secret",
        "AMAZON_ADS_REFRESH_TOKEN": "Atzr|your-refresh-token",
        "AMAZON_ADS_REGION": "EU",
        "AMAZON_ADS_PROFILE_IDS": "1234567890"
      }
    }
  }
}

With a source install, replace npx and its arguments with node and the absolute path to dist/cli.js. Run npm run doctor to check the configuration without contacting Amazon; it never prints a value.

Safety and coverage

Writes preview by default. Most writes return a previewToken bound to the exact change and to the entity as read from Amazon at preview time. Repeat the call with confirm: true and that token within ten minutes. A changed request, a changed entity or an expired token is refused before anything is sent. amazon_ads_update_campaign_status uses expectedStatus from its preview instead, and the rename tools need only confirm: true.

New Sponsored Products campaigns, ad groups, product ads, keywords and targets are created paused. Sponsored Brands and Display creates that carry a state must be paused, and creates without a state field require a paused parent. Negative keywords and targets start enabled because they suppress traffic. Previews mark a change that starts delivery with activationMaySpend. Archiving is irreversible.

An HTTP 207 response with any item error is reported as a failure. A change whose outcome is uncertain is never retried automatically; read the entity and reconcile it first. A read that receives HTTP 401 renews the access token once and repeats; a change does not. HTTP 429 responses report Amazon's Retry-After value and are not retried.

The profile allowlist is checked before every request, and amazon_ads_list_profiles returns only allowlisted profiles. Unknown arguments are refused. Amounts are in the profile currency, not micros. Large integer IDs are kept as strings so no digit is lost. Configuration lists return one page and say so with partial; follow nextToken or nextStartIndex.

Reports are asynchronous. amazon_ads_create_report returns a jobToken; call amazon_ads_get_report about 30 seconds later. A pending report is not an empty account. Sponsored Products purchases and sales use the click attribution window you choose. Brands and Display use their native 14-day attribution. Report files and asset uploads use signed Amazon S3 URLs, which must be HTTPS S3 hosts, are fetched without any Amazon credential and never follow a redirect.

This server covers Sponsored Products, Sponsored Brands, Sponsored Display, Reporting v3, the creative asset library and product metadata. It does not cover DSP, Amazon Marketing Cloud, billing, account management or portfolios. Hosted creative galleries, alerts, exports, the campaign launcher and MCP Apps UI are excluded. Use tools/list, server-card.json or the amazon-ads://write-contracts resource for exact schemas, and Amazon's API reference for provider details.

Amazon's own MCP server

Amazon announced the Amazon Ads MCP Server in open beta on February 2, 2026, for Amazon Ads partners with active API credentials. The comparison below uses only Amazon's own pages: the announcement, the overview, Connecting to the Amazon Ads MCP Server, the Lite version, Connecting using OAuth 2.1 and the MCP tool reference, as read on October 23, 2026.

Amazon Ads MCP Server

This server

Where it runs

Hosted by Amazon at regional endpoints such as https://advertising-ai.amazon.com/mcp, built and updated by Amazon Ads.

Runs on your machine over stdio and calls the Amazon Ads API directly.

Credentials

A Login with Amazon access token and client ID in request headers, or OAuth 2.1 with a browser login.

Client ID, client secret and refresh token in environment variables. Access tokens are renewed in memory.

Account selection

Dynamic mode, where the assistant supplies account identifiers, or fixed mode, where headers pin one account.

A fixed allowlist of profile IDs in one region, checked before every request.

Coverage

Tool groups for account management, campaign management, reporting, billing, Amazon Marketing Cloud, eligibility, users and more, plus skills and a Lite version with three discovery tools.

Sponsored Products, Brands and Display entities, Reporting v3, the creative asset library and product metadata, as 108 individual tools.

Writes

Campaign management tools that create, update and delete. Amazon's guide shows how to disable individual tools, such as delete_campaign, in the Kiro CLI configuration.

Off unless AMAZON_ADS_ENABLE_WRITES=true. Every write previews first, and new campaigns, ad groups and ads are created paused.

Use Amazon's server for DSP, Amazon Marketing Cloud, billing or account management, which this server does not cover.

Hosted option

getmcpads for Amazon Ads manages the hosted connection and account selection. Hosted and source releases can differ. Contact: hello@getmcpads.com.

Development

npm run typecheck
npm run lint
npm run build
npm test
npm run catalog

All tests run offline with a mocked fetch and synthetic responses. No live account is read or changed.

Tools

Every tool is listed below. See server-card.json for complete parameter and output schemas.

Profiles

Tool

Purpose

amazon_ads_list_profiles

List the advertising profiles in AMAZON_ADS_PROFILE_IDS that these credentials can reach in AMAZON_ADS_REGION, with marketplace, account type, currency and timezone.

amazon_ads_get_profile

Read the selected Amazon Ads profile: marketplace, account type, currency and timezone.

Sponsored Products configuration

Tool

Purpose

amazon_ads_get_campaigns

Read one page of Amazon Sponsored Products campaigns, including paused and archived entities by default.

amazon_ads_get_ad_groups

Read one page of Amazon Sponsored Products ad groups, including paused and archived entities by default.

amazon_ads_get_product_ads

Read one page of Amazon Sponsored Products product ads, including paused and archived entities by default.

amazon_ads_get_keywords

Read one page of Amazon Sponsored Products keywords, including paused and archived entities by default.

amazon_ads_get_targets

Read one page of Amazon Sponsored Products targets, including paused and archived entities by default.

amazon_ads_get_negative_keywords

Read one page of Amazon Sponsored Products negative keywords, including paused and archived entities by default.

amazon_ads_get_negative_targets

Read one page of Amazon Sponsored Products negative targets, including paused and archived entities by default.

amazon_ads_get_campaign_negative_keywords

Read one page of Amazon Sponsored Products campaign negative keywords, including paused and archived entities by default.

amazon_ads_get_campaign_negative_targets

Read one page of Amazon Sponsored Products campaign negative targets, including paused and archived entities by default.

Sponsored Brands configuration

Tool

Purpose

amazon_ads_get_brands

List brands eligible for Sponsored Brands in this selected profile.

amazon_ads_get_sb_campaigns

Read one page of Sponsored Brands campaigns.

amazon_ads_get_sb_ad_groups

Read one page of Sponsored Brands ad groups.

amazon_ads_get_sb_ads

Read one page of Sponsored Brands ads.

amazon_ads_get_sb_ad_creatives

Read native Sponsored Brands creative versions for one ad: headline, ASINs, brand logo and image or video asset references.

amazon_ads_get_sb_keywords

List one page of Sponsored Brands keywords, including archived entities.

amazon_ads_get_sb_negative_keywords

List one page of Sponsored Brands negative keywords, including archived entities.

amazon_ads_get_sb_targets

List one page of Sponsored Brands targets, including archived entities.

amazon_ads_get_sb_negative_targets

List one page of Sponsored Brands negative targets, including archived entities.

Sponsored Display configuration

Tool

Purpose

amazon_ads_get_sd_campaigns

Read one page of Sponsored Display campaigns.

amazon_ads_get_sd_ad_groups

Read one page of Sponsored Display ad groups.

amazon_ads_get_sd_product_ads

Read one page of Sponsored Display product ads.

amazon_ads_get_sd_targets

Read one page of Sponsored Display targets.

amazon_ads_get_sd_negative_targets

Read one page of Sponsored Display negative targets.

amazon_ads_get_sd_creatives

Read one page of Sponsored Display creatives.

Reporting

Tool

Purpose

amazon_ads_create_report

Request an asynchronous Amazon performance report: Sponsored Products campaigns, ad groups, placements, search terms or advertised products; Brands campaigns, ads or search terms; Display campaigns or products.

amazon_ads_get_report

Check an Amazon report once and, when complete, read its native rows.

Creative assets and catalog

Tool

Purpose

amazon_ads_list_creative_assets

Search the Amazon creative asset library: images, logos and videos, native download or playback URLs, sizes and moderation metadata.

amazon_ads_get_creative_asset

Refresh one native Amazon image or video asset in the selected profile.

amazon_ads_get_product_metadata

Read advertised product titles, native image URLs, stock, price and eligibility from the advertiser's Amazon catalog.

Registered only with AMAZON_ADS_ENABLE_WRITES=true. Every call previews unless confirm: true is passed, and most writes also need the previewToken from that preview.

Sponsored Products

Tool

Purpose

amazon_ads_create_campaign

Create one Sponsored Products campaign in PAUSED state.

amazon_ads_update_campaign

Update Sponsored Products campaign name, state, dates or bidding strategy.

amazon_ads_update_campaign_budget

Change one Sponsored Products daily budget in profile currency.

amazon_ads_update_campaign_status

Pause or enable one Amazon Sponsored Products campaign.

amazon_ads_create_ad_group

Create a PAUSED Sponsored Products ad group with a default bid in profile currency.

amazon_ads_update_ad_group

Update one Sponsored Products ad group: state and bid.

amazon_ads_create_product_ad

Create one Sponsored Products product ad.

amazon_ads_update_product_ad

Update one Sponsored Products product ad: state.

amazon_ads_create_keyword

Create one Sponsored Products keyword.

amazon_ads_update_keyword

Update one Sponsored Products keyword: state and bid.

amazon_ads_create_target

Create one Sponsored Products target.

amazon_ads_update_target

Update one Sponsored Products target: state and bid.

amazon_ads_create_negative_keyword

Create one Sponsored Products negative keyword.

amazon_ads_update_negative_keyword

Change the state of a Sponsored Products negative keyword.

amazon_ads_create_negative_target

Create one Sponsored Products negative target.

amazon_ads_update_negative_target

Change the state of a Sponsored Products negative target.

amazon_ads_create_campaign_negative_keyword

Create one Sponsored Products campaign negative keyword.

amazon_ads_update_campaign_negative_keyword

Change the state of a Sponsored Products campaign negative keyword.

amazon_ads_create_campaign_negative_target

Create one Sponsored Products campaign negative target.

amazon_ads_update_campaign_negative_target

Change the state of a Sponsored Products campaign negative target.

Sponsored Brands

Tool

Purpose

amazon_ads_create_sb_campaign

Create one Sponsored Brands campaign.

amazon_ads_update_sb_campaign

Update one Sponsored Brands campaign.

amazon_ads_create_sb_ad_group

Create one Sponsored Brands ad group.

amazon_ads_update_sb_ad_group

Update one Sponsored Brands ad group.

amazon_ads_update_sb_ad

Update one Sponsored Brands ad.

amazon_ads_create_sb_ad_product_collection

Create one Sponsored Brands product collection ad.

amazon_ads_create_sb_ad_product_collection_extended

Create one Sponsored Brands product collection extended ad.

amazon_ads_create_sb_ad_video

Create one Sponsored Brands video ad.

amazon_ads_create_sb_ad_brand_video

Create one Sponsored Brands brand video ad.

amazon_ads_create_sb_ad_store_spotlight

Create one Sponsored Brands store spotlight ad.

amazon_ads_create_sb_ad_auto_collection

Create one Sponsored Brands auto collection ad.

amazon_ads_create_sb_ad_manual_collection

Create one Sponsored Brands manual collection ad.

amazon_ads_update_sb_ad_creative_product_collection

Replace the creative of one Sponsored Brands product collection ad.

amazon_ads_update_sb_ad_creative_product_collection_extended

Replace the creative of one Sponsored Brands product collection extended ad.

amazon_ads_update_sb_ad_creative_video

Replace the creative of one Sponsored Brands video ad.

amazon_ads_update_sb_ad_creative_brand_video

Replace the creative of one Sponsored Brands brand video ad.

amazon_ads_update_sb_ad_creative_store_spotlight

Replace the creative of one Sponsored Brands store spotlight ad.

amazon_ads_update_sb_ad_creative_auto_collection

Replace the creative of one Sponsored Brands auto collection ad.

amazon_ads_update_sb_ad_creative_manual_collection

Replace the creative of one Sponsored Brands manual collection ad.

amazon_ads_create_sb_keyword

Create one Sponsored Brands keyword.

amazon_ads_update_sb_keyword

Update one Sponsored Brands keyword.

amazon_ads_create_sb_negative_keyword

Create one Sponsored Brands negative keyword.

amazon_ads_update_sb_negative_keyword

Update one Sponsored Brands negative keyword.

amazon_ads_create_sb_target

Create one Sponsored Brands target.

amazon_ads_update_sb_target

Update one Sponsored Brands target.

amazon_ads_create_sb_negative_target

Create one Sponsored Brands negative target.

amazon_ads_update_sb_negative_target

Update one Sponsored Brands negative target.

Sponsored Display

Tool

Purpose

amazon_ads_create_sd_campaign

Create one Sponsored Display campaign.

amazon_ads_update_sd_campaign

Update one Sponsored Display campaign.

amazon_ads_create_sd_ad_group

Create one Sponsored Display ad group.

amazon_ads_update_sd_ad_group

Update one Sponsored Display ad group.

amazon_ads_create_sd_product_ad

Create one Sponsored Display product ad.

amazon_ads_update_sd_product_ad

Update one Sponsored Display product ad.

amazon_ads_create_sd_target

Create one Sponsored Display target.

amazon_ads_update_sd_target

Update one Sponsored Display target.

amazon_ads_create_sd_negative_target

Create one Sponsored Display negative target.

amazon_ads_update_sd_negative_target

Update one Sponsored Display negative target.

amazon_ads_create_sd_creative

Create one Sponsored Display creative.

amazon_ads_update_sd_creative

Update one Sponsored Display creative.

Archive (irreversible)

Tool

Purpose

amazon_ads_archive_sb_campaign

Permanently archive one Sponsored Brands campaign.

amazon_ads_archive_sb_ad_group

Permanently archive one Sponsored Brands ad group.

amazon_ads_archive_sb_ad

Permanently archive one Sponsored Brands ad.

amazon_ads_archive_sb_keyword

Permanently archive one Sponsored Brands keyword.

amazon_ads_archive_sb_negative_keyword

Permanently archive one Sponsored Brands negative keyword.

amazon_ads_archive_sb_target

Permanently archive one Sponsored Brands target.

amazon_ads_archive_sb_negative_target

Permanently archive one Sponsored Brands negative target.

amazon_ads_archive_sd_campaign

Permanently archive one Sponsored Display campaign.

amazon_ads_archive_sd_ad_group

Permanently archive one Sponsored Display ad group.

amazon_ads_archive_sd_product_ad

Permanently archive one Sponsored Display product ad.

amazon_ads_archive_sd_target

Permanently archive one Sponsored Display target.

amazon_ads_archive_sd_negative_target

Permanently archive one Sponsored Display negative target.

Creative asset uploads

Tool

Purpose

amazon_ads_prepare_asset_upload

Prepare an Amazon image or video upload for this profile.

amazon_ads_upload_asset_bytes

Upload supplied image or video bytes to the native S3 URL bound to the opaque uploadToken from amazon_ads_prepare_asset_upload.

amazon_ads_register_uploaded_asset

Register bytes already uploaded to the Amazon URL from amazon_ads_prepare_asset_upload.

Renames

Tool

Purpose

amazon_ads_rename_campaign

Rename one Amazon Sponsored Products, Brands or Display campaign.

amazon_ads_rename_ad_group

Rename one Amazon Sponsored Products, Brands or Display ad group.

amazon_ads_rename_ad

Rename one Amazon Sponsored Brands ad.

Resources

Resource

Content

amazon-ads://guide

Scope, pagination, attribution, preview and confirmation rules, and the renaming matrix.

amazon-ads://report-catalog

Report types, metric columns and grouping fields used by amazon_ads_create_report.

amazon-ads://write-contracts

The 39 pinned Amazon request contracts behind the Sponsored Brands and Display write tools.

License

Apache License 2.0. See NOTICE.

More from getmcpads

Meta Ads · Google Ads · Google Analytics 4 · Google Search Console · TikTok Ads · Pinterest Ads · X Ads

Maintained by the getmcpads team at getmcpads. Questions: hello@getmcpads.com.

Available Tools

31 tools
amazon_ads_create_reportamazon ads create reportA
Read-onlyIdempotent

Request an asynchronous Amazon performance report: Sponsored Products campaigns, ad groups, placements, search terms or advertised products; Brands campaigns, ads or search terms; Display campaigns or products. Brands legacy campaign reports exclude multi-ad-group campaigns. Does not change advertising or budgets. Choose the attribution window explicitly, keep jobToken and call amazon_ads_get_report later. No polling loop, no cross-platform attribution and no automatic sums.

Inputs: endDate (required), accountId (required), startDate (required), attributionDays (required), +2 more. Returns: result

amazon_ads_get_ad_groupsamazon ads get ad groupsA
Read-onlyIdempotent

Read one page of Amazon Sponsored Products ad groups, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.

Inputs: accountId (required), states, nextToken, maxResults, +1 more. Returns: result

amazon_ads_get_brandsamazon ads get brandsA
Read-onlyIdempotent

List brands eligible for Sponsored Brands in this selected profile. Use the returned brandEntityId in campaign and creative configuration; never invent a brand ID.

Inputs: accountId (required). Returns: result

amazon_ads_get_campaign_negative_keywordsamazon ads get campaign negative keywordsA
Read-onlyIdempotent

Read one page of Amazon Sponsored Products campaign negative keywords, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.

Inputs: accountId (required), states, nextToken, maxResults, +1 more. Returns: result

amazon_ads_get_campaign_negative_targetsamazon ads get campaign negative targetsA
Read-onlyIdempotent

Read one page of Amazon Sponsored Products campaign negative targets, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.

Inputs: accountId (required), states, nextToken, maxResults, +1 more. Returns: result

amazon_ads_get_campaignsamazon ads get campaignsA
Read-onlyIdempotent

Read one page of Amazon Sponsored Products campaigns, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.

Inputs: accountId (required), states, nextToken, maxResults, +1 more. Returns: result

amazon_ads_get_creative_assetamazon ads get creative assetA
Read-onlyIdempotent

Refresh one native Amazon image or video asset in the selected profile. Returns every version and its files; no guessed URLs and no cross-profile fallback. Pass its native assetId from amazon_ads_list_creative_assets.

Inputs: assetId (required), accountId (required). Returns: result

amazon_ads_get_keywordsamazon ads get keywordsA
Read-onlyIdempotent

Read one page of Amazon Sponsored Products keywords, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.

Inputs: accountId (required), states, nextToken, maxResults, +1 more. Returns: result

amazon_ads_get_negative_keywordsamazon ads get negative keywordsA
Read-onlyIdempotent

Read one page of Amazon Sponsored Products negative keywords, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.

Inputs: accountId (required), states, nextToken, maxResults, +1 more. Returns: result

amazon_ads_get_negative_targetsamazon ads get negative targetsA
Read-onlyIdempotent

Read one page of Amazon Sponsored Products negative targets, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.

Inputs: accountId (required), states, nextToken, maxResults, +1 more. Returns: result

amazon_ads_get_product_adsamazon ads get product adsA
Read-onlyIdempotent

Read one page of Amazon Sponsored Products product ads, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.

Inputs: accountId (required), states, nextToken, maxResults, +1 more. Returns: result

amazon_ads_get_product_metadataamazon ads get product metadataA
Read-onlyIdempotent

Read advertised product titles, native image URLs, stock, price and eligibility from the advertiser's Amazon catalog. Retrieves Sponsored Products visuals without scraping retail pages. Page through pageIndex or Amazon's cursorToken; product images are not complete rendered ads.

Inputs: accountId (required), asins, limit, search, +3 more. Returns: result

amazon_ads_get_profileamazon ads get profileA
Read-onlyIdempotent

Read the selected Amazon Ads profile: marketplace, account type, currency and timezone. API access does not establish eligibility for Sponsored Brands, Display or DSP.

Inputs: accountId (required). Returns: result

amazon_ads_get_reportamazon ads get reportA
Read-onlyIdempotent

Check an Amazon report once and, when complete, read its native rows. Use only the jobToken returned by amazon_ads_create_report for this profile. Downloads are bounded; pagination returns row offsets and marks partial results. Expired reports must be requested again.

Inputs: jobToken (required), accountId (required), limit, offset. Returns: result

amazon_ads_get_sb_ad_creativesamazon ads get sb ad creativesA
Read-onlyIdempotent

Read native Sponsored Brands creative versions for one ad: headline, ASINs, brand logo and image or video asset references. Resolve asset IDs with amazon_ads_get_creative_asset and ASINs with amazon_ads_get_product_metadata. Requires Brands eligibility; no retail scraping.

Inputs: adId (required), accountId (required), nextToken, maxResults. Returns: result

amazon_ads_get_sb_ad_groupsamazon ads get sb ad groupsA
Read-onlyIdempotent

Read one page of Sponsored Brands ad groups. Requires Brands eligibility in this profile. Includes all states by default; follow nextToken. Configuration is not performance.

Inputs: accountId (required), states, nextToken, maxResults, +1 more. Returns: result

amazon_ads_get_sb_adsamazon ads get sb adsA
Read-onlyIdempotent

Read one page of Sponsored Brands ads. Requires Brands eligibility in this profile. Includes all states by default; follow nextToken. Configuration is not performance.

Inputs: accountId (required), adIds, states, nextToken, +2 more. Returns: result

amazon_ads_get_sb_campaignsamazon ads get sb campaignsA
Read-onlyIdempotent

Read one page of Sponsored Brands campaigns. Requires Brands eligibility in this profile. Includes all states by default; follow nextToken. Configuration is not performance.

Inputs: accountId (required), states, nextToken, maxResults, +1 more. Returns: result

amazon_ads_get_sb_keywordsamazon ads get sb keywordsA
Read-onlyIdempotent

List one page of Sponsored Brands keywords, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory.

Inputs: accountId (required), limit, states, adGroupIds, +2 more. Returns: result

amazon_ads_get_sb_negative_keywordsamazon ads get sb negative keywordsA
Read-onlyIdempotent

List one page of Sponsored Brands negative keywords, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory.

Inputs: accountId (required), limit, states, adGroupIds, +2 more. Returns: result

amazon_ads_get_sb_negative_targetsamazon ads get sb negative targetsA
Read-onlyIdempotent

List one page of Sponsored Brands negative targets, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory.

Inputs: accountId (required), limit, states, nextToken, +2 more. Returns: result

amazon_ads_get_sb_targetsamazon ads get sb targetsA
Read-onlyIdempotent

List one page of Sponsored Brands targets, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory.

Inputs: accountId (required), limit, states, nextToken, +2 more. Returns: result

amazon_ads_get_sd_ad_groupsamazon ads get sd ad groupsA
Read-onlyIdempotent

Read one page of Sponsored Display ad groups. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.

Inputs: accountId (required), count, startIndex. Returns: result

amazon_ads_get_sd_campaignsamazon ads get sd campaignsA
Read-onlyIdempotent

Read one page of Sponsored Display campaigns. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.

Inputs: accountId (required), count, startIndex. Returns: result

amazon_ads_get_sd_creativesamazon ads get sd creativesA
Read-onlyIdempotent

Read one page of Sponsored Display creatives. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.

Inputs: accountId (required), adGroupIds (required), count, startIndex. Returns: result

amazon_ads_get_sd_negative_targetsamazon ads get sd negative targetsA
Read-onlyIdempotent

Read one page of Sponsored Display negative targets. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.

Inputs: accountId (required), count, startIndex. Returns: result

amazon_ads_get_sd_product_adsamazon ads get sd product adsA
Read-onlyIdempotent

Read one page of Sponsored Display product ads. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.

Inputs: accountId (required), count, startIndex. Returns: result

amazon_ads_get_sd_targetsamazon ads get sd targetsA
Read-onlyIdempotent

Read one page of Sponsored Display targets. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.

Inputs: accountId (required), count, startIndex. Returns: result

amazon_ads_get_targetsamazon ads get targetsA
Read-onlyIdempotent

Read one page of Amazon Sponsored Products targets, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.

Inputs: accountId (required), states, nextToken, maxResults, +1 more. Returns: result

amazon_ads_list_creative_assetsamazon ads list creative assetsA
Read-onlyIdempotent

Search the Amazon creative asset library: images, logos and videos, native download or playback URLs, sizes and moderation metadata. One page; continue with nextToken using the same filters. Uploaded assets are not proof of campaign use or delivery. Sponsored Products images come from amazon_ads_get_product_metadata instead.

Inputs: accountId (required), text, limit, assetType, +1 more. Returns: result

amazon_ads_list_profilesamazon ads list profilesA
Read-onlyIdempotent

List the advertising profiles in AMAZON_ADS_PROFILE_IDS that these credentials can reach in AMAZON_ADS_REGION, with marketplace, account type, currency and timezone. Profiles outside the allowlist are never returned or counted. Configured IDs that Amazon does not return are listed in missingProfileIds.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 31 tools

    Disambiguation4/5

    Tools are separated by ad program (SP/SB/SD) plus entity type, and descriptions explicitly state which program each tool reads, so most selections are unambiguous. A few pairs still require careful reading: amazon_ads_get_negative_keywords vs amazon_ads_get_campaign_negative_keywords (ad-group vs campaign level), and the unprefixed tools (get_campaigns, get_targets, get_product_ads) implicitly mean Sponsored Products, which could be mistaken for the generic or SB/SD variants.

    Naming Consistency4/5

    All 31 tools use a uniform amazon_ads_ snake_case verb_noun pattern with program prefixes (sb_, sd_) and consistent entity suffixes (campaigns, ad_groups, targets, negative_keywords). The only deviation is the arbitrary mix of list_ and get_ for read operations (list_profiles, list_creative_assets vs get_brands, get_keywords), which is cosmetic rather than confusing.

    Tool Count3/5

    31 tools is on the heavy side, but the surface mirrors the genuine breadth of the Amazon Ads API (three ad programs × seven-plus entity types plus reporting). Each tool maps to a distinct resource, though several near-identical read tools could arguably be collapsed into one parameterized entity-listing tool.

    Completeness3/5

    Read coverage is broad across Sponsored Products, Brands and Display, and asynchronous reporting covers performance metrics. However, the surface is essentially read-only: there are no create/update/pause operations for campaigns, ad groups, keywords, targets or bids/budgets, and no DSP, portfolio or budget-management tools, so an agent can analyze but not act.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients to read App Store campaign and performance data and to prepare preview-first, opt-in changes for explicitly allowlisted ad accounts.
      354 npm
      Apache 2.0
    • A
      license
      B
      quality
      B
      maintenance
      Enables MCP clients to read Snapchat Ads campaigns and performance and to prepare preview-first changes for selected ad accounts, with opt-in write tools and explicit confirmation before applying updates.
      21
      328 npm
      Apache 2.0