How to Connect Amazon Ads to Meta Muse via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Amazon Ads, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Amazon Ads + Meta Muse

Read Amazon Ads (Sponsored Products) accounts: advertising profiles, campaigns, ad groups, product ads, keywords, negative keywords and targets, and request Reporting v3 performance reports for Sponsored Products, Brands and Display. For sellers, vendors and agencies, in the NA, EU and FE regions.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

AMAZON_ADS_CLIENT_ID, AMAZON_ADS_CLIENT_SECRET, AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL, AMAZON_ADS_TOKEN_URL

Step 1 — Get credentials

1. Make sure you have Amazon Ads API access: an approved API application and a Login with Amazon (LWA) security profile linked to it. You apply for API access with Amazon Ads (Partner Network, or https://advertising.amazon.com/API). Without API approval the sign-in works, but Amazon refuses every call.

2. In the LWA console (https://developer.amazon.com, Login with Amazon) open the security profile, then Web Settings, and add https://cloud.anythingmcp.com/api/mcp-oauth/callback (if you host AnythingMCP yourself: <your AnythingMCP URL>/api/mcp-oauth/callback) under Allowed Return URLs.

3. Copy the Client ID and the Client Secret (Show Secret) from the same page into AMAZON_ADS_CLIENT_ID and AMAZON_ADS_CLIENT_SECRET. The client ID starts with amzn1.application-oa2-client..

4. Set AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL and AMAZON_ADS_TOKEN_URL for your region, in that order:

   • North America (US, CA, MX, BR): https://advertising-api.amazon.com, https://www.amazon.com/ap/oa, https://api.amazon.com/auth/o2/token
   • Europe (UK, DE, FR, IT, ES, NL, SE, PL, TR, AE, SA, EG, IN): https://advertising-api-eu.amazon.com, https://eu.account.amazon.com/ap/oa, https://api.amazon.co.uk/auth/o2/token
   • Far East (JP, AU, SG): https://advertising-api-fe.amazon.com, https://apac.account.amazon.com/ap/oa, https://api.amazon.co.jp/auth/o2/token

   A connector only sees the profiles of its region, so install it once per region if you advertise in several.

5. Leave AMAZON_ADS_REFRESH_TOKEN empty, unless you already authorized this security profile for the Amazon Ads API elsewhere (that token starts with Atzr|). Install the connector, click Authorize with Provider and sign in with the Amazon account that has access to the advertising accounts. The scope is advertising::campaign_management.

6. Run amazon_ads_list_profiles. A profile is one advertiser in one marketplace, and its id goes into every other tool. An empty list means the account has no advertising account in this region or never created a campaign.

Read-only: the AI lists Sponsored Products campaigns, ad groups, product ads (the advertised ASINs or SKUs), keywords with bids and match types, negative keywords and product, category and auto targets.

Performance comes from reports: impressions, clicks, cost, sales, ACOS and ROAS are only available as reports. amazon_ads_create_report starts a report job on Amazon's side (it changes no campaign) and amazon_ads_get_report checks its status. Reports usually finish within minutes but can take up to an hour at busy times. Most report types look back 95 days, and a DAILY report covers at most 31 days. Sponsored Brands and Sponsored Display campaigns are not listed, but their performance is available through reports.

The report file: a finished report is a download link to a gzip-compressed JSON file, valid for about an hour. The connector cannot unpack that file, so the AI hands you the link to download and open it yourself, or to pass to a tool that can decompress it. Costs are in the profile's currency.

Limits and errors: Amazon throttles per account and endpoint and answers 429 with a time to wait before retrying. Access tokens last one hour and are renewed automatically. 401: authorize again, and check that the client ID, sign-in URL and token URL belong to the same region as the API endpoint. 403: the Amazon account has no access to that profile, or the security profile is not approved for the Amazon Ads API. 425: the same report was already requested, and the answer carries its id.

The connector does not create or change campaigns, bids or budgets, and does not list Sponsored Brands or Sponsored Display campaigns.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Muse

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.

1. In Muse, open Settings → Connectors and choose Add custom connector.
2. Paste the MCP server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse opens the AnythingMCP sign-in page: sign in and approve access.
4. In a chat, ask Muse for something that needs the Amazon Ads tools.

You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.

Available tools

Example prompts

• "List our advertising profiles with their marketplace and currency."
• "Request a Sponsored Products report by campaign for the last 30 days and give me the download link when it is ready."
• "Which keywords in our manual campaigns use broad match, and what are their bids?"
• "Show the negative keywords of our biggest campaign so I can check for gaps before we add new ones."

FAQ

Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.

Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT