Amazon Ads MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AMAZON_ADS_REGION | Yes | `NA`, `EU` or `FE`. Selects the API host and the token URL. Use the region of the profiles listed in AMAZON_ADS_PROFILE_IDS. | |
| AMAZON_ADS_CLIENT_ID | Yes | Client ID of a Login with Amazon security profile that has Amazon Ads API access. | |
| AMAZON_ADS_PROFILE_IDS | Yes | Required comma-separated advertising profile IDs. Every other profile is refused before any request, reads included. | |
| AMAZON_ADS_CLIENT_SECRET | Yes | Client secret of that Login with Amazon security profile. | |
| AMAZON_ADS_ENABLE_WRITES | No | Defaults to `false`. Only the exact value `true` exposes the 77 write tools. | false |
| AMAZON_ADS_REFRESH_TOKEN | Yes | Refresh token from the authorization grant. It starts with `Atzr|`. An access token (`Atza|`) is refused, because it expires after an hour. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| amazon_ads_list_profilesA | 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. |
| amazon_ads_list_creative_assetsA | 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. |
| amazon_ads_get_creative_assetA | 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. |
| amazon_ads_get_product_metadataA | 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. |
| amazon_ads_get_sb_campaignsA | Read one page of Sponsored Brands campaigns. Requires Brands eligibility in this profile. Includes all states by default; follow nextToken. Configuration is not performance. |
| amazon_ads_get_sb_ad_groupsA | 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. |
| amazon_ads_get_sb_adsA | Read one page of Sponsored Brands ads. Requires Brands eligibility in this profile. Includes all states by default; follow nextToken. Configuration is not performance. |
| amazon_ads_get_sb_ad_creativesA | 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. |
| amazon_ads_get_sd_campaignsA | 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. |
| amazon_ads_get_sd_ad_groupsA | 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. |
| amazon_ads_get_sd_product_adsA | 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. |
| amazon_ads_get_sd_targetsA | 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. |
| amazon_ads_get_sd_negative_targetsA | 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. |
| amazon_ads_get_sd_creativesA | 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. |
| amazon_ads_get_brandsA | List brands eligible for Sponsored Brands in this selected profile. Use the returned brandEntityId in campaign and creative configuration; never invent a brand ID. |
| amazon_ads_get_sb_keywordsA | List one page of Sponsored Brands keywords, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory. |
| amazon_ads_get_sb_negative_keywordsA | List one page of Sponsored Brands negative keywords, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory. |
| amazon_ads_get_sb_targetsA | List one page of Sponsored Brands targets, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory. |
| amazon_ads_get_sb_negative_targetsA | List one page of Sponsored Brands negative targets, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory. |
| amazon_ads_get_profileA | Read the selected Amazon Ads profile: marketplace, account type, currency and timezone. API access does not establish eligibility for Sponsored Brands, Display or DSP. |
| amazon_ads_get_campaignsA | 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. |
| amazon_ads_get_ad_groupsA | 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. |
| amazon_ads_get_product_adsA | 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. |
| amazon_ads_get_keywordsA | 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. |
| amazon_ads_get_targetsA | 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. |
| amazon_ads_get_negative_keywordsA | 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. |
| amazon_ads_get_negative_targetsA | 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. |
| amazon_ads_get_campaign_negative_keywordsA | 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. |
| amazon_ads_get_campaign_negative_targetsA | 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. |
| amazon_ads_create_reportA | 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. |
| amazon_ads_get_reportA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Amazon Ads guide | Scope, pagination, attribution, preview and confirmation rules for this server. |
| Amazon Ads report catalog | Report types, metric columns and grouping fields used by amazon_ads_create_report. |
| Amazon Ads write contracts | The pinned Amazon request contracts behind the Sponsored Brands and Display write tools. |
TDQS
Scored across 31 tools
Tools are largely partitioned by ad product (SP unprefixed, sb_*, sd_*) and by entity type (campaigns, ad groups, ads, targets, negatives), and descriptions explicitly disambiguate near-neighbors like get_creative_asset vs list_creative_assets and get_product_metadata vs creative assets. The main friction is that Sponsored Products tools carry no prefix, so an agent must read descriptions to know get_campaigns means SP while get_sb_campaigns/get_sd_campaigns are separate, and there are many closely-spaced negative target/keyword variants.
All names are snake_case with the amazon_ads_ prefix, which is good, but the verb set is mixed: 'list' is used for profiles and creative assets while 'get' is used for paginated entity listings (get_campaigns, get_sb_keywords), making list vs get semantically overloaded. The ad-product prefixing is also inconsistent, with Sponsored Products tools unprefixed while Brands and Display tools use sb_/sd_ prefixes.
31 tools exceeds the comfortable range and is driven by combinatorial fan-out across three ad products times roughly six entity types, which is defensible for the domain but heavy for an agent to navigate. Much of the surface is repetitive read-one-page variants that could plausibly be consolidated behind a product/entity parameter.
The read surface is thorough across Sponsored Products, Brands and Display entities plus reports and creative/product metadata, but there are no write operations for campaigns, ad groups, keywords, targets, bids or budgets, so the server cannot actually manage or optimize ads. Coverage is a complete read-only lifecycle with no update/delete, which will dead-end agents tasked with making changes.