Adverso
Browse all topics

Quickstart

From nothing to your first answer in three steps.

You need an Adverso MCP account with Amazon Ads connected. If you do not have one yet, sign up in the dashboard: you sign in on Amazon, approve Adverso, and your accounts appear.

  1. Choose your marketplaces. In the dashboard, switch on the marketplaces you want your AI to read. Adverso copies their campaigns and reports from Amazon. Only the marketplaces you switch on are ever read.

  2. Create an API key. On the dashboard, under MCP access, choose Create API key. The key is shown once, together with a ready-made connector address and a command for Claude Code. Copy what you need straight away.

  3. Add the server to your AI client. Pick your client below.

The Claude apps take a server by its address. Your key is part of that address.

  1. Go to claude.ai or open the Claude desktop app.
  2. Open Customize → Connectors.
  3. Click Add, then Add custom connector.
  4. Set Name to Adverso MCP.
  5. In MCP server URL, paste your connector address (shown in the dashboard when you create the key).
  6. Click Continue. If Claude asks how to sign in, choose No sign-in: the key is already in the address.
  7. Click Add.

Team or Enterprise workspace. An Owner adds the connector once, under Organization settings → Connectors (Add → Custom → Web). It then appears for every member under Customize → Connectors. Everyone uses the key in that address.

One connector, every Claude app. Once added, it is there on the web, in the desktop app and on your phone.

Connector address
https://pcaaxwkkddgzmgptngdb.supabase.co/functions/v1/mcp?key=YOUR_API_KEY

Ask your first question

Start with this one. It makes your AI call list_accounts, which tells it which marketplaces it can read and which days have data.

Example
Which Amazon accounts can you see in Adverso MCP, and for which dates do you have data?

Then ask something real:

Example
Which search terms cost money last week without a single sale?

This is roughly what comes back:

Your AI client, connected to Adverso MCPExample data

Which search terms cost money last week without a single sale?

  • list_accounts
  • get_search_terms

From 11 to 17 November, 214 search terms had spend and no orders. Together they cost €96.40. The five most expensive:

Search termKeyword that caught itClicksCost
hiking boots men widehiking boots (broad)19€14.82
leather boot carehiking boots (broad)11€9.35
trekking shoes kidstrekking shoes (phrase)9€7.90
b0example02close match8€6.12
boots waterproof spraywaterproof boots (broad)7€5.48

The first three look unrelated to your product. They are candidates for negative keywords.

More ideas are in Example questions.

If it does not work

What you seeWhat to do
The client says it cannot connect, or shows 401The key is missing or wrong. Create a new key in the dashboard and use the address or command shown with it.
The AI says it has no data for your datesAsk for dates inside the range list_accounts reports.
The AI says a marketplace is not part of your planSwitch that marketplace on in the dashboard.

More cases are in Troubleshooting, and every message the server can send is in Limits and errors.