Run Amazon Ads from Windsurf

Manage Amazon Ads campaigns inside Windsurf (IDE) — 61 tools, OAuth setup in about 5 minutes, no dashboard switching.

61 Amazon Ads tools, all in Windsurf
Paused-by-default. Cannot delete campaigns.
OAuth setup in ~2 minutes

See it in action

In Windsurf

›Pull my Amazon Ads performance for the last 30 days. Show impressions, clicks, spend, sales, ACOS, and ROAS. Which Sponsored Products campaigns have the lowest ACOS?

Amazon performance audit — ACOS/ROAS rollup that surfaces your most efficient Sponsored Products campaigns.

Overview

Adspirer is the MCP server that connects Windsurf (IDE) to your Amazon Ads ad accounts, turning campaign management into a chat conversation. Codeium Windsurf — IDE with native MCP support. On the platform side, 61 tools cover sponsored Products, Sponsored Brands, and Sponsored Display — created by ASIN and tracked on ACOS & ROAS. Adspirer reads and writes — pull performance reports, audit launch campaigns by asin, launch new campaigns, pause underperformers, and reallocate budget — all from chat. New campaigns are always created paused so you can review before they go live, Adspirer cannot delete existing campaigns by design, and the free tier (15 tool calls / month, no credit card) is enough to run a full audit before you pay. Setup takes about 5 minutes via a JSON config entry.

Safety guarantees

New campaigns always created paused for review
Adspirer cannot delete existing campaigns
Budget changes need explicit confirmation
OAuth 2.1 + PKCE — passwords never seen

How it works

Windsurf

You ask in chat

prompt

Adspirer

61 tools, paused-by-default

tool calls

Amazon Ads

Live data, paused for review

Step 01

Connect

Paste the MCP URL into Windsurf, OAuth into Amazon Ads.

Step 02

Manage

Ask in chat. Adspirer routes through 61 Amazon Ads tools.

Step 03

Scale

Switch accounts in chat. Same audits across every client.

What you can do

61 tools across Amazon Ads. The ones you'll use most:

Launch campaigns by ASIN — Build Sponsored Products, Brands, or Display campaigns from your ASINs and SKUs — `create_amazon_sp_campaign`, `create_amazon_sb_campaign`, and `create_amazon_sd_campaign` each create the campaign **PAUSED** so you review before it spends (there is no Amazon sandbox).
Get Amazon-native keyword & bid recommendations — `get_amazon_keyword_recommendations` and `get_amazon_bid_recommendations` surface suggested Sponsored Products keywords and bids for your ASINs; `get_amazon_sb_keyword_recommendations` and `get_amazon_sb_bid_recommendations` do the same for Sponsored Brands.
Track ACOS & ROAS — `get_amazon_campaign_performance` returns impressions, clicks, spend, sales, ACOS, and ROAS by campaign — the retail metrics Amazon advertisers actually optimize toward, tied to real attributed product sales.
Find & cut wasted spend — `analyze_amazon_wasted_spend` finds keywords and targets spending without converting, then `add_amazon_negative_keywords` blocks the irrelevant search terms so budget flows to what sells.
See per-ASIN & cross-sell performance — `get_amazon_product_performance` breaks results down per ASIN/SKU, and `get_amazon_purchased_products` shows what shoppers actually bought after clicking — even when it wasn't the advertised product.
Manage full Sponsored Products structure — Campaign → ad groups → product ads → keywords → targets → negatives, all in one conversation: `create_amazon_ad_groups`, `add_amazon_product_ads`, `add_amazon_keywords` (AUTO or MANUAL), and `add_amazon_targets` build the whole tree.
Pause, resume & reallocate budget — `pause_amazon_campaigns` and `resume_amazon_campaigns` control what's live, while `optimize_amazon_budget` recommends shifts based on ACOS and ROAS and `get_amazon_budget_usage` shows how much of each budget is being consumed.

Campaign types

Every Amazon Ads format Adspirer supports — request one in chat.

AUTO vs MANUAL targeting

Let Amazon match your ASINs automatically, or run MANUAL keyword and product targeting with your own bids and match types via `add_amazon_keywords` and `add_amazon_targets`.

Multi-region profiles (NA / EU / FE)

Adspirer discovers advertiser profiles across all three Amazon regions and routes each request to the right one — `list_amazon_profiles` lists them by `profile_id`, region, and active status.

Pick an intent

More prompts to try

Same as Cursor — useful for engineering teams that ship features and ads from one editor.

Find wasted spend — ACOS-based wasted-spend analysis with ready-to-add negative keyword suggestions.

Find wasted spend

Analyze my Amazon Ads for wasted spend over the last 60 days. Which keywords are spending with no sales or a very high ACOS? Suggest negative keywords I should add.

Per-ASIN & cross-sell breakdown — Per-ASIN profit view plus purchased-products cross-sell analysis in one pass.

Per-ASIN & cross-sell breakdown

Break down my Amazon Ads performance by ASIN for the last 30 days. Which products are actually selling from my ads versus just spending? Also show me what shoppers bought after clicking that wasn't the advertised ASIN, so I can spot cross-sell opportunities.

Pick your audience

Who this is for

In-house growth marketer running Amazon Ads solo

Each Monday, ask Windsurf to pull last week's Amazon Ads performance, surface campaigns running below your ROAS threshold, and recommend creative refreshes for fatigued ads.

Replaces a 60–90 minute manual review with a 5-minute chat, and surfaces problems before they tank ad-set performance.

Compare & decide

Compare

Adspirer vs alternatives

For running Amazon Ads from Windsurf.

	Adspirer	DIY MCP server	Legacy SaaS dashboard
Setup time	~5 minutes via a JSON config entry	2–4 hours building MCP server	30–60 min onboarding + sales call
Cost — entry tier	Free (15 calls / mo)	Hosting + maintenance	$200–500 / mo minimum
Works inside Windsurf	Yes — a JSON config entry	Yes (if you build it correctly)	No — external dashboard only
Multi-account	Yes — switch in chat	Manual per-account auth	Yes — but each account billed
Read + Write	Full read + write (create / pause / update)	Whatever you build	Mostly read-only or seat-gated writes
Safety: cannot delete	Hard-coded — no delete tool	Up to you	Varies
Pricing transparency	Public — $0 / $49 / $99 / $199	Self-hosted	Often quote-only

Cost

Pricing

If Adspirer wins for you, here's what it costs. Start free; upgrade if you outgrow it.

Free Forever

15 tool calls / mo

All platforms. ChatGPT & Claude access. No credit card.

Start free →

Best for Windsurf

Plus

$49 / mo

150 tool calls / mo

Performance analysis + standard campaigns.

Compare Plus →

Pro

$99 / mo

600 tool calls / mo

AI optimization, bulk ops, deeper diagnostics.

Compare Pro →

Max

$199 / mo

3,000 tool calls / mo

Priority support (24h SLA), custom integrations.

Compare Max →

Set up

Configure

Required: Windsurf Pro. Most users finish in about two minutes.

Show setup steps for Windsurf

Add Adspirer to Windsurf MCP config

In Windsurf settings, add an MCP server with URL https://mcp.adspirer.com/mcp and OAuth authentication.

Common questions

FAQ

Setup

Do I need a developer to set this up?

You'll edit a small JSON config entry to register the Adspirer MCP server (https://mcp.adspirer.com/mcp, transport http, OAuth). If you can edit a settings file in a code editor, you can do this. Total time: about 5 minutes.

Do I need Amazon Brand Registry?

Only for Sponsored Brands. Sponsored Products and Sponsored Display work without it. To run SB, enroll your brand in Brand Registry, supply the brand entity ID, and — for productCollection ads — upload a brand logo with upload_amazon_asset (or reference an existing one with search_amazon_assets) before creating the ad.

Capabilities

Can I switch from Windsurf to a different AI client later?

Yes. Your Adspirer account is independent of the AI client — sign up once, then connect the same MCP URL from ChatGPT, Claude, Cursor, Codex, Windsurf, or any supported client. Tool calls are pooled across clients on the same plan; switching costs you nothing.

What's the difference between Sponsored Products, Brands, and Display?

Sponsored Products (SP) are keyword- and product-targeted ads promoting individual listings in search and on product pages — the workhorse, no Brand Registry required. Sponsored Brands (SB) are brand-building ads (logo, custom headline, multiple products, or video) in prominent placements — requires Brand Registry and supports all 7 ad types. Sponsored Display (SD) uses audience and contextual targeting on and off Amazon — strong for retargeting and competitor-product placements.

What do ACOS and ROAS mean, and which should I optimize?

ACOS (advertising cost of sales) is ad spend ÷ attributed sales as a percentage — lower is better, and it's the metric most Amazon advertisers optimize toward. ROAS (return on ad spend) is its inverse, attributed sales ÷ ad spend — higher is better. Because Amazon attributes sales of your actual products, both are tied to real retail revenue. get_amazon_campaign_performance returns them by campaign.

Why was my Amazon campaign created but not spending?

This is expected. There's no Amazon sandbox, so campaigns run against production — Adspirer creates every campaign PAUSED so you can review it before it spends. When you're ready, ask the assistant to resume it with resume_amazon_campaigns.

Does Adspirer support multiple Amazon marketplaces and regions?

Yes. On connect, Adspirer discovers your advertiser profiles across all three Amazon regions — North America (NA), Europe (EU), and Far East (FE) — and routes each request to the correct region automatically. Every profile is imported as a separate ad account; use list_amazon_profiles to see them and target a specific one by its profile_id.

Workflows

Why is my Amazon report "still processing"?

Amazon Reporting v3 is asynchronous — Adspirer requests a report, polls Amazon until it's ready, and get_amazon_report retrieves it by report_id. Large date ranges take longer. The deeper analytics tools (wasted-spend, budget optimization, per-ASIN, purchased-products, targeting) serve instantly from a nightly-refreshed store, so only point-in-time get_amazon_report pulls wait on Amazon.

Compare

What's the read vs. write boundary on Amazon Ads?

Adspirer is full read and write. It can pull reports, audit performance, and analyze data (read), and it can launch new campaigns, pause underperformers, update budgets, and adjust targeting (write). Two safety guardrails are hard-coded: new campaigns are always created paused so you review before they go live, and Adspirer cannot delete existing campaigns. You keep full control.