Skip to main content
Glama
Amazon Ads MCP Server

Amazon Ads MCP Server

by get-mcp-ads

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
AMAZON_ADS_REGIONYes`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_IDYesClient ID of a Login with Amazon security profile that has Amazon Ads API access.
AMAZON_ADS_PROFILE_IDSYesRequired comma-separated advertising profile IDs. Every other profile is refused before any request, reads included.
AMAZON_ADS_CLIENT_SECRETYesClient secret of that Login with Amazon security profile.
AMAZON_ADS_ENABLE_WRITESNoDefaults to `false`. Only the exact value `true` exposes the 77 write tools.false
AMAZON_ADS_REFRESH_TOKENYesRefresh 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

CapabilityDetails
tools
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
Amazon Ads guideScope, pagination, attribution, preview and confirmation rules for this server.
Amazon Ads report catalogReport types, metric columns and grouping fields used by amazon_ads_create_report.
Amazon Ads write contractsThe pinned Amazon request contracts behind the Sponsored Brands and Display write tools.

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