Amazon Ads

com.getmcpadsPublished by getmcpads.comv1.0.1Updated Oct 26, 2026

Amazon Ads MCP server: 31 read tools, 77 opt-in preview-first writes.

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local stdio MCP server that lets an assistant read Amazon Ads Sponsored Products, Brands and Display data, pull reports, and prepare preview-first changes.

What you can do
  • List and read advertising profiles, including marketplace, currency and timezone
  • Read Sponsored Products campaigns, ad groups, product ads, keywords, targets and negatives
  • Read Sponsored Brands and Sponsored Display campaigns, ad groups, ads, creatives, keywords and targets
  • Request asynchronous performance reports and fetch their rows once complete
  • Search the creative asset library and read advertised product metadata
  • With writes enabled, create, update, rename, archive and upload creatives, each previewing before it applies
When to use it
Useful when you want an assistant to inspect Amazon advertising accounts and reporting inside a stdio-capable client such as Claude Desktop, Claude Code or Cursor, and optionally to stage campaign changes with a preview-and-confirm step. It suits advertisers who already have Amazon Ads API credentials and want a fixed, allowlisted set of profiles.
Requirements
Runs locally over stdio as an npm package, requiring Node.js 22.23.4, 24.22.1, 26.12.1 or newer. Needs a Login with Amazon application with Amazon Ads API access, supplied through AMAZON_ADS_CLIENT_ID, AMAZON_ADS_CLIENT_SECRET and AMAZON_ADS_REFRESH_TOKEN, plus AMAZON_ADS_REGION (NA, EU or FE) and AMAZON_ADS_PROFILE_IDS. No OAuth browser flow is included; network access to the Amazon Ads API is required.
Before you install
Requires a client secret and refresh token as environment variables; keep them out of shared configs. Write tools stay off unless AMAZON_ADS_ENABLE_WRITES is exactly true, and enabling them allows budget, bid, status and creative changes that can start delivery and spend money. Archiving is irreversible. Refresh tokens issued from July 30, 2026 expire after 365 days. Report files and asset uploads use signed S3 URLs.

Installation

In SourceWeft

  1. Open Amazon Ads in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.1: Zod 4 security update · October 26, 2026

  • Update zod to 4.6.7. Every Zod release before 4.6.6 is covered by the high-severity advisory GHSA-mrhx-c7xc-m3w5: validating an oversized constrained collection can exhaust memory, and no Zod 3 release carries the fix. npm audit --omit=dev reports no vulnerability again.
  • Keep the Zod 3 validation behaviour. A parameter default is still validated and completed before use, so an omitted object must still supply its required fields.
  • Keep each parameter's own description when the parameter is optional or has a default. Zod 4 stores a description on the wrapped schema only, so the shared fallback description could otherwise replace it.
  • Tool names, parameters and descriptions published over MCP are unchanged. server-card.json is regenerated with Zod 4's JSON Schema output, which spells some constraints differently.

Earlier releases

VersionDateHighlights
1.0.0October 23, 2026First 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.

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.

bash
git clone --branch v1.0.1 --depth 1 https://github.com/get-mcp-ads/amazon-ads-mcp-server.gitcd amazon-ads-mcp-servernpm cinpm 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:

VariablePurpose
AMAZON_ADS_CLIENT_IDClient ID of a Login with Amazon security profile that has Amazon Ads API access.
AMAZON_ADS_CLIENT_SECRETClient secret of that security profile.
AMAZON_ADS_REFRESH_TOKENRefresh token from the authorization grant. It starts with Atzr|. An access token (Atza|) is refused, because it expires after an hour.
AMAZON_ADS_REGIONNA, EU or FE. Selects the API host and the token URL. Use the region of the profiles below.
AMAZON_ADS_PROFILE_IDSRequired comma-separated advertising profile IDs. Every other profile is refused before any request, reads included.
AMAZON_ADS_ENABLE_WRITESDefaults 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:

json
{  "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 ServerThis server
Where it runsHosted 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.
CredentialsA 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 selectionDynamic 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.
CoverageTool 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.
WritesCampaign 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: [email protected].

Development

bash
npm run typechecknpm run lintnpm run buildnpm testnpm 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.

31 read tools

Profiles

ToolPurpose
amazon_ads_list_profilesList 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_profileRead the selected Amazon Ads profile: marketplace, account type, currency and timezone.

Sponsored Products configuration

ToolPurpose
amazon_ads_get_campaignsRead one page of Amazon Sponsored Products campaigns, including paused and archived entities by default.
amazon_ads_get_ad_groupsRead one page of Amazon Sponsored Products ad groups, including paused and archived entities by default.
amazon_ads_get_product_adsRead one page of Amazon Sponsored Products product ads, including paused and archived entities by default.
amazon_ads_get_keywordsRead one page of Amazon Sponsored Products keywords, including paused and archived entities by default.
amazon_ads_get_targetsRead one page of Amazon Sponsored Products targets, including paused and archived entities by default.
amazon_ads_get_negative_keywordsRead one page of Amazon Sponsored Products negative keywords, including paused and archived entities by default.
amazon_ads_get_negative_targetsRead one page of Amazon Sponsored Products negative targets, including paused and archived entities by default.
amazon_ads_get_campaign_negative_keywordsRead one page of Amazon Sponsored Products campaign negative keywords, including paused and archived entities by default.
amazon_ads_get_campaign_negative_targetsRead one page of Amazon Sponsored Products campaign negative targets, including paused and archived entities by default.

Sponsored Brands configuration

ToolPurpose
amazon_ads_get_brandsList brands eligible for Sponsored Brands in this selected profile.
amazon_ads_get_sb_campaignsRead one page of Sponsored Brands campaigns.
amazon_ads_get_sb_ad_groupsRead one page of Sponsored Brands ad groups.
amazon_ads_get_sb_adsRead one page of Sponsored Brands ads.
amazon_ads_get_sb_ad_creativesRead native Sponsored Brands creative versions for one ad: headline, ASINs, brand logo and image or video asset references.
amazon_ads_get_sb_keywordsList one page of Sponsored Brands keywords, including archived entities.
amazon_ads_get_sb_negative_keywordsList one page of Sponsored Brands negative keywords, including archived entities.
amazon_ads_get_sb_targetsList one page of Sponsored Brands targets, including archived entities.
amazon_ads_get_sb_negative_targetsList one page of Sponsored Brands negative targets, including archived entities.

Sponsored Display configuration

ToolPurpose
amazon_ads_get_sd_campaignsRead one page of Sponsored Display campaigns.
amazon_ads_get_sd_ad_groupsRead one page of Sponsored Display ad groups.
amazon_ads_get_sd_product_adsRead one page of Sponsored Display product ads.
amazon_ads_get_sd_targetsRead one page of Sponsored Display targets.
amazon_ads_get_sd_negative_targetsRead one page of Sponsored Display negative targets.
amazon_ads_get_sd_creativesRead one page of Sponsored Display creatives.

Reporting

ToolPurpose
amazon_ads_create_reportRequest 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_reportCheck an Amazon report once and, when complete, read its native rows.

Creative assets and catalog

ToolPurpose
amazon_ads_list_creative_assetsSearch the Amazon creative asset library: images, logos and videos, native download or playback URLs, sizes and moderation metadata.
amazon_ads_get_creative_assetRefresh one native Amazon image or video asset in the selected profile.
amazon_ads_get_product_metadataRead advertised product titles, native image URLs, stock, price and eligibility from the advertiser's Amazon catalog.
77 write tools

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

ToolPurpose
amazon_ads_create_campaignCreate one Sponsored Products campaign in PAUSED state.
amazon_ads_update_campaignUpdate Sponsored Products campaign name, state, dates or bidding strategy.
amazon_ads_update_campaign_budgetChange one Sponsored Products daily budget in profile currency.
amazon_ads_update_campaign_statusPause or enable one Amazon Sponsored Products campaign.
amazon_ads_create_ad_groupCreate a PAUSED Sponsored Products ad group with a default bid in profile currency.
amazon_ads_update_ad_groupUpdate one Sponsored Products ad group: state and bid.
amazon_ads_create_product_adCreate one Sponsored Products product ad.
amazon_ads_update_product_adUpdate one Sponsored Products product ad: state.
amazon_ads_create_keywordCreate one Sponsored Products keyword.
amazon_ads_update_keywordUpdate one Sponsored Products keyword: state and bid.
amazon_ads_create_targetCreate one Sponsored Products target.
amazon_ads_update_targetUpdate one Sponsored Products target: state and bid.
amazon_ads_create_negative_keywordCreate one Sponsored Products negative keyword.
amazon_ads_update_negative_keywordChange the state of a Sponsored Products negative keyword.
amazon_ads_create_negative_targetCreate one Sponsored Products negative target.
amazon_ads_update_negative_targetChange the state of a Sponsored Products negative target.
amazon_ads_create_campaign_negative_keywordCreate one Sponsored Products campaign negative keyword.
amazon_ads_update_campaign_negative_keywordChange the state of a Sponsored Products campaign negative keyword.
amazon_ads_create_campaign_negative_targetCreate one Sponsored Products campaign negative target.
amazon_ads_update_campaign_negative_targetChange the state of a Sponsored Products campaign negative target.

Sponsored Brands

ToolPurpose
amazon_ads_create_sb_campaignCreate one Sponsored Brands campaign.
amazon_ads_update_sb_campaignUpdate one Sponsored Brands campaign.
amazon_ads_create_sb_ad_groupCreate one Sponsored Brands ad group.
amazon_ads_update_sb_ad_groupUpdate one Sponsored Brands ad group.
amazon_ads_update_sb_adUpdate one Sponsored Brands ad.
amazon_ads_create_sb_ad_product_collectionCreate one Sponsored Brands product collection ad.
amazon_ads_create_sb_ad_product_collection_extendedCreate one Sponsored Brands product collection extended ad.
amazon_ads_create_sb_ad_videoCreate one Sponsored Brands video ad.
amazon_ads_create_sb_ad_brand_videoCreate one Sponsored Brands brand video ad.
amazon_ads_create_sb_ad_store_spotlightCreate one Sponsored Brands store spotlight ad.
amazon_ads_create_sb_ad_auto_collectionCreate one Sponsored Brands auto collection ad.
amazon_ads_create_sb_ad_manual_collectionCreate one Sponsored Brands manual collection ad.
amazon_ads_update_sb_ad_creative_product_collectionReplace the creative of one Sponsored Brands product collection ad.
amazon_ads_update_sb_ad_creative_product_collection_extendedReplace the creative of one Sponsored Brands product collection extended ad.
amazon_ads_update_sb_ad_creative_videoReplace the creative of one Sponsored Brands video ad.
amazon_ads_update_sb_ad_creative_brand_videoReplace the creative of one Sponsored Brands brand video ad.
amazon_ads_update_sb_ad_creative_store_spotlightReplace the creative of one Sponsored Brands store spotlight ad.
amazon_ads_update_sb_ad_creative_auto_collectionReplace the creative of one Sponsored Brands auto collection ad.
amazon_ads_update_sb_ad_creative_manual_collectionReplace the creative of one Sponsored Brands manual collection ad.
amazon_ads_create_sb_keywordCreate one Sponsored Brands keyword.
amazon_ads_update_sb_keywordUpdate one Sponsored Brands keyword.
amazon_ads_create_sb_negative_keywordCreate one Sponsored Brands negative keyword.
amazon_ads_update_sb_negative_keywordUpdate one Sponsored Brands negative keyword.
amazon_ads_create_sb_targetCreate one Sponsored Brands target.
amazon_ads_update_sb_targetUpdate one Sponsored Brands target.
amazon_ads_create_sb_negative_targetCreate one Sponsored Brands negative target.
amazon_ads_update_sb_negative_targetUpdate one Sponsored Brands negative target.

Sponsored Display

ToolPurpose
amazon_ads_create_sd_campaignCreate one Sponsored Display campaign.
amazon_ads_update_sd_campaignUpdate one Sponsored Display campaign.
amazon_ads_create_sd_ad_groupCreate one Sponsored Display ad group.
amazon_ads_update_sd_ad_groupUpdate one Sponsored Display ad group.
amazon_ads_create_sd_product_adCreate one Sponsored Display product ad.
amazon_ads_update_sd_product_adUpdate one Sponsored Display product ad.
amazon_ads_create_sd_targetCreate one Sponsored Display target.
amazon_ads_update_sd_targetUpdate one Sponsored Display target.
amazon_ads_create_sd_negative_targetCreate one Sponsored Display negative target.
amazon_ads_update_sd_negative_targetUpdate one Sponsored Display negative target.
amazon_ads_create_sd_creativeCreate one Sponsored Display creative.
amazon_ads_update_sd_creativeUpdate one Sponsored Display creative.

Archive (irreversible)

ToolPurpose
amazon_ads_archive_sb_campaignPermanently archive one Sponsored Brands campaign.
amazon_ads_archive_sb_ad_groupPermanently archive one Sponsored Brands ad group.
amazon_ads_archive_sb_adPermanently archive one Sponsored Brands ad.
amazon_ads_archive_sb_keywordPermanently archive one Sponsored Brands keyword.
amazon_ads_archive_sb_negative_keywordPermanently archive one Sponsored Brands negative keyword.
amazon_ads_archive_sb_targetPermanently archive one Sponsored Brands target.
amazon_ads_archive_sb_negative_targetPermanently archive one Sponsored Brands negative target.
amazon_ads_archive_sd_campaignPermanently archive one Sponsored Display campaign.
amazon_ads_archive_sd_ad_groupPermanently archive one Sponsored Display ad group.
amazon_ads_archive_sd_product_adPermanently archive one Sponsored Display product ad.
amazon_ads_archive_sd_targetPermanently archive one Sponsored Display target.
amazon_ads_archive_sd_negative_targetPermanently archive one Sponsored Display negative target.

Creative asset uploads

ToolPurpose
amazon_ads_prepare_asset_uploadPrepare an Amazon image or video upload for this profile.
amazon_ads_upload_asset_bytesUpload 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_assetRegister bytes already uploaded to the Amazon URL from amazon_ads_prepare_asset_upload.

Renames

ToolPurpose
amazon_ads_rename_campaignRename one Amazon Sponsored Products, Brands or Display campaign.
amazon_ads_rename_ad_groupRename one Amazon Sponsored Products, Brands or Display ad group.
amazon_ads_rename_adRename one Amazon Sponsored Brands ad.

Resources

ResourceContent
amazon-ads://guideScope, pagination, attribution, preview and confirmation rules, and the renaming matrix.
amazon-ads://report-catalogReport types, metric columns and grouping fields used by amazon_ads_create_report.
amazon-ads://write-contractsThe 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 Emmanuel at getmcpads. Questions: [email protected].

Source: README.md at commit 7d9ca80

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the server did not start.

Version history

2
  1. v1.0.1LatestOct 26, 2026
  2. v1.0.0Oct 23, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts