ScaleSKUs MCP server

Connect Claude, ChatGPT or any other MCP client to your Amazon Advertising account. Ask about campaigns, search terms, keywords, budgets, products, Search Query Performance and profit in plain language — and, when you choose to, queue or apply changes through an audited approval pipeline.

Built by ScaleSKUs (ARTALLUR TECHNOLOGIES INDIA LLP), an Amazon Ads verified partner. Questions: support@scaleskus.com.

Before you start

You need a ScaleSKUs account with your Amazon Ads account connected — start a free trial. The assistant sees only the Amazon accounts your ScaleSKUs login can see. Step-by-step setup with screenshots for each assistant: Connect your AI.

Quick start

Add the connector in your assistant with the server URL https://scaleskus.com/mcp (Claude: add the ScaleSKUs plugin from Customize › Plugins, where it is listed in Claude’s plugin directory, or add a custom connector under Customize › Connectors; ChatGPT: Settings › Apps & Connectors; Amazon Quick: see below).
Sign in to ScaleSKUs when the assistant sends you to our authorization page (email, Google or Amazon).
Choose the organization and approve the access shown on the consent screen.
Start asking. A good first question: “Give me a briefing on my Amazon Ads account.”

Amazon Quick

An Amazon Quick administrator or Enterprise author adds ScaleSKUs once for the team; each person then signs in with their own ScaleSKUs login. Quick runs in us-east-1, us-west-2, eu-west-1, eu-west-2, eu-central-1, ap-southeast-2 and ap-northeast-1.

In Quick, open Connectors › Create for your team › Model Context Protocol and choose to create a new connector.
Name it ScaleSKUs, set the endpoint to https://scaleskus.com/mcp on the public network, and choose user authentication. ScaleSKUs registers Quick automatically, so there is no client ID or secret to enter.
Sign in to ScaleSKUs when asked and approve the access. We recommend setting the write tools to Ask each time, then publish the connector to your team.

Quick keeps the first 100 tools a server lists; ScaleSKUs lists its least-used tools last. A call that takes longer than 60 seconds shows as HTTP 424 in Quick — ask for a shorter date range. When we add tools, run Sync on the connector to pick them up (new tools arrive switched off).

What you can ask

“Which campaigns wasted the most spend last month, and why?”
“Show search terms that convert but aren't targeted yet.”
“Which campaigns ran out of budget this week and what did it cost me?”
“Compare this week's ACoS and TACoS with last week, by ad type.”
“Where is my share of voice slipping in Search Query Performance?”
“What was my profit per ASIN last month after fees and ad spend?”
“Queue a 10% bid cut on keywords above 60% ACoS for my approval.”

Connection details

Server URL	`https://scaleskus.com/mcp`
Transport	Streamable HTTP (JSON-RPC 2.0)
Authorization	OAuth 2.1 — authorization code with PKCE (S256); a client ID metadata document (an https URL as the client_id) for public clients, or dynamic client registration for public clients and for confidential ones (client_secret_basic / client_secret_post); the issuer is named in every authorization response (RFC 9207)
Discovery	`https://scaleskus.com/.well-known/oauth-protected-resource` `https://scaleskus.com/.well-known/oauth-authorization-server`
Scopes	`mcp:read` — read your accounts' data. `mcp:actions` — queue or apply changes (see below); an app we haven't verified must be granted this scope explicitly on the consent screen.
Tokens	Access tokens last 365 days and refresh tokens 730 days, so you don't have to reconnect every session. Revoke any time (below).

Changes and safety

Most tools only read. 22 write tools change your Amazon Ads account — bids, budgets, negatives, placements, new campaigns and keywords, automation rules, day-parting — and never call Amazon directly: every change goes through ScaleSKUs' tasks pipeline and is recorded in your account's audit log. 5 more change only what ScaleSKUs stores for you: team memory notes, product costs and tasks for your team.

Queued for approval by default. A change is saved as a pending task you approve in ScaleSKUs; nothing changes on Amazon until then.
Applying directly is opt-in. The assistant can apply a change immediately only when you ask it to and your login has two-factor verification (a verified phone). Without it, the change is queued instead.
Limits. At most 200 applied changes per Amazon account per day; anything beyond is queued for approval.
Your accounts only. Every call is checked against the accounts your login can access.

Data and privacy

The server answers from the Amazon Ads and Amazon Seller/Vendor Central data your ScaleSKUs account already syncs. What the assistant asks for is sent to it to answer you; ScaleSKUs does not sell your data or use it to train AI models. The assistant saves a note to your team memory only when you ask it to (or agree when it offers), and you can remove notes at any time. A large export goes to a Google Sheet in your own Google Drive, only when you ask for one and have connected your Google account in ScaleSKUs. Read the privacy policy and terms.

Troubleshooting

The assistant shows no ScaleSKUs tools. The connector needs an active ScaleSKUs plan with AI access; check Billing in ScaleSKUs, then reconnect.
No write tools. Changes are part of the Analysis + Actions plan; on other plans the assistant can read and recommend, and queue nothing.
“Session expired” or repeated sign-in. Remove the connector in your assistant and add it again, or revoke it on the Connect AI page first.
Numbers look partial. Ask “Is my data up to date?” — a newly connected account takes a few hours to sync, and Amazon's retail reports arrive 2–3 days behind ads data.
A change didn't happen on Amazon. It is probably waiting for approval: open Tasks in ScaleSKUs, or ask the assistant for your pending tasks.

Security

Tokens are scoped to the organization you chose on the consent screen and to the Amazon accounts your login can see; every tool call is logged. To report a vulnerability, write to support@scaleskus.com with “Security report” in the subject (security.txt).

Manage or disconnect

See every connected assistant and revoke access on the Connect AI page in ScaleSKUs, or remove the connector in your assistant's settings.

Tools (107)

77 tools only read; the 30 marked “changes data” create or change something. Write tools appear only when write actions are enabled for your organization. Tools marked “full access” aren't offered to the client-safe access tokens you can create on the Connect AI page; assistants that connect by signing in get them.

Getting started

list_profiles

Lists the Amazon Ads accounts (profiles) the user can access, sorted by name, one row per account.

get_profile_summary

Returns a high-level summary of an Amazon Ads account for a date range (default: the last 14 days through today): ad totals across SP, SB and SD (impressions, clicks, spend, sales, orders, ACoS, ROAS, CTR, CVR) with a breakdown by ad product (products with…

find_entity

Resolves a campaign, ad group, keyword or target to its opaque handle from the master (current-state) tables, including paused, zero-impression and no-report entities that performance reports omit.

get_sync_status

Reports whether the user's Amazon data is synced and up to date across Amazon Ads, SP-API and report data.

get_briefing

Returns a briefing on one account in one call: the headline, the trajectory (what changed), what is budget-capped right now, and the weakest audit areas, as a labelled bundle.

get_next_actions

Returns the value-ranked queue of next actions for one account: the top money moves (growth-audit findings, wasted spend to cut, search terms to harvest, budget-capped winners) in one prioritised list, for questions like "what should I do", "where do I star…

get_started

Returns an orientation for a new or unsure user: a plain-language welcome and how ScaleSKUs works, a live snapshot of the account (whether its data is ready; the last 30 days of ad spend, ad sales, ACoS, total sales and TACoS in the account currency), the o…

run_workflow

Runs a complete expert workflow on an account in a single run, for a short or goal-style request.

get_team_activity full access

Lists recent changes across every account the user can access, from Amazon's synced change history, for questions like "what did my team work on today", "what changed this week" or "recent activity"; profile_id narrows it to one account.

get_optimization_history

Returns the deduplicated optimization history of an account over a date window: every recorded change (bid, budget, placement, negative, keyword/target, pause/enable, new entity) merged from Amazon change history, ScaleSKUs change tasks, automation action l…

list_guides

Lists ScaleSKUs' built-in reference guides with each guide's guide_id, title, version and section outline — metadata only, not the text.

read_guide

Returns the text of one ScaleSKUs reference guide by guide_id, or one section of it, with the guide's version, updated_at and section outline.

search_guides

Searches ScaleSKUs' reference guides by keyword and returns the best-matching sections, ranked: guide_id, section heading and a short snippet for each — bounded snippets, not full text.

Products, sales & profit

get_account_daily_trend

Returns the day-by-day whole-business trend for an account, blending Amazon Sales & Traffic with advertising data: total, ad and organic sales, ad spend, total orders, sessions, page views, buy-box %, ACoS, TACoS, organic % and conversion rate, plus totals…

get_product_performance

Returns advertising performance per ASIN: impressions, clicks, spend, sales, orders, units, ACoS, ROAS, CTR, CVR, ad type and listing status.

get_product_taxonomy

Returns the account's products grouped by department › category › sub-category, with how many products and how many are advertised (an ENABLED Sponsored Products ad) in each.

get_product_health

Get product-health alerts: advertised ASINs that are out-of-stock, unbuyable, suppressed, or have lost the buy box — while ads keep spending on them.

get_asin_traffic

Get per-ASIN retail traffic and conversion from Amazon Sales & Traffic: sessions, page views, buy-box %, unit-session % (conversion rate), units ordered and total ordered-product sales.

get_inventory

Get FBA inventory levels per SKU (latest snapshot): sellable units (fulfillable + FC transfer — units moving between fulfilment centres, e.g.

list_creative_assets

Lists the account's Amazon Creative Asset Library: the images, brand logos and videos uploaded once and reused in Sponsored Display and Sponsored Brands creatives, such as the optional brand logo shown with a Sponsored Display headline.

get_profit_loss

Returns a profit and loss statement for an account: gross sales, refunds, referral, FBA fulfilment and storage fees, ad spend, reimbursements and net proceeds, plus the seller's own product cost (COGS), fixed costs and India GST where these have been entere…

set_product_costs changes data

Saves per-SKU product costs into an account's P&L in ScaleSKUs: COGS, any custom per-unit cost columns (e.g.

get_taxonomy_benchmarks

Returns Sponsored Products advertising performance per catalogue node — level sub_category (default), category or asin — over the last N days (default 30, range 7-90), from the daily advertised-product reports: products, spend and share of spend, sales, ord…

Campaigns & ad groups

get_campaign_performance

Returns campaign-level performance (impressions, clicks, spend, sales, orders, ACoS, ROAS, CTR, CVR) for one ad product per call: Sponsored Products (default), Sponsored Brands or Sponsored Display.

get_daily_trends

Get daily performance trends (spend, sales, ACoS, impressions, clicks, orders) over a date range for a profile.

get_campaign_structure

Returns per-campaign structure analysis: budget utilization, ad group, keyword, target and negative counts, a structure_score (0-100) with the issues found, and product_mix.

get_placement_performance

Get campaign-level placement performance for Sponsored Products: how spend, sales and orders split across Top-of-Search (TOS), Rest-of-Search (ROS) and Product-Pages (PDP).

get_adgroup_performance

Returns ad-group performance across SP, SB and SD: impressions, clicks, spend, sales, orders, ACoS, ROAS, CTR, CPC and CVR, with status, default bid and parent campaign, for ad groups with impressions in the window.

get_portfolios

Lists an account's advertising portfolios: portfolio_id (an opaque pfl_ handle), name, state, budget amount and budget policy.

Search terms, keywords & targets

get_search_term_analysis

Get search-term analysis with live classifications (waste, harvest_candidate, scaling, neutral), suggested actions, and estimated savings — computed LIVE from the daily search-term reports.

get_keyword_competition

Returns, per search term, a blend of four sources: market demand, the brand's impression and purchase share and the market median price (latest Search Query Performance week); the account's Sponsored Products spend, sales, ACoS and CVR from the search-term…

get_waste_search_terms

Lists search terms that spent with zero orders on at least min_clicks clicks (default 10), computed from the daily search-term reports and sorted by spend (highest first), with total wasted spend and net spend at risk (each term counted once across campaigns).

get_harvest_opportunities

Lists harvest candidates, computed from the daily search-term reports: search terms converting under a non-exact match (at least min_orders orders, default 2) within the ACoS ceiling, sorted by an ACoS-weighted harvest score.

get_keyword_efficiency

Returns keyword-level efficiency with bid suggestions, computed from the daily keyword reports (no live-stream blend; the reports have no row for today).

get_keyword_performance

Returns per-keyword advertising performance for Sponsored Products and Sponsored Brands: impressions, clicks, spend, sales, orders, ACoS, ROAS, CTR, CPC and CVR per keyword and match type, without bid suggestions or efficiency labels.

get_target_efficiency

Returns efficiency with bid suggestions for product, ASIN, category and auto targets (close-match, loose-match, substitutes, complements, keyword-group themes), computed from the daily targeting reports (no live-stream blend; the reports have no row for today).

get_target_performance

Returns per-target advertising performance across SP, SB and SD: product (ASIN), category, audience, keyword and auto targeting expressions with impressions, clicks, spend, sales, orders, ACoS, ROAS, CTR, CPC and CVR, as a straight targeting report without…

get_duplicate_targeting

Find self-competition: keywords or product targets that run in multiple campaigns at once, so your own campaigns bid against each other and inflate CPC.

Budgets & real-time data

get_budget_analysis

Returns per-campaign budget efficiency over a date window.

get_budget_constrained_campaigns

Lists Sponsored Products campaigns that Amazon recommends a budget increase for, with Amazon's estimates of missed impressions, clicks and sales, the current and suggested budget, the increase, average daily spend, utilization and days capped.

get_realtime_budget_usage

Returns current budget pacing per campaign from Amazon Marketing Stream: the latest budget, usage % of that budget, estimated spend (budget × usage %), ad product, campaign name and last update time.

Audits & opportunities

get_audit_scores

Get a LIVE account audit: an overall score (0-100) plus sub-scores (waste control, product readiness, budget efficiency, structure) and the top findings — each with the revenue impact and a recommended action — computed on demand from the current data.

get_audit_report

Returns a published ScaleSKUs audit report for an account (the level-by-level Owner Report): each level's findings with the logic behind every number, and the recommended changes in a ready-to-queue form.

get_negative_opportunities

Lists candidate negative keywords, computed live from the daily search-term reports: terms with spend and no orders (high_spend_no_conversion) or ACoS above 60% on at most one order (high_acos), each with at least min_clicks clicks.

check_negation_status

Reports whether search terms are already negated in a Sponsored Products account, checking both campaign-level and ad-group-level negatives.

get_sales_dips

Find where AD sales dropped and why.

get_growth_audit_findings

Returns a prioritised fix-list for an account, computed live from current data, with findings ranked by money impact in the account's currency.

Search Query Performance & Brand Analytics

get_sqp_performance

Get Search Query Performance (SQP) data showing organic and paid share metrics per search query.

get_sqp_share_of_voice

Get brand-wide search-query share of voice: for each search query, your impression/click/cart-add/purchase share of the total market, your query conversion rate, and the paid side (ad spend, sales, ACoS) on the same query — so you see organic vs paid together.

get_search_catalog_performance

Get the per-ASIN organic search funnel from Brand Analytics: search impressions, clicks, click-through rate, cart adds, purchases, conversion rate, search-traffic sales, and median click/purchase price.

get_market_basket

Get Market Basket Analysis (Amazon Brand Analytics, MONTHLY): the ASINs most often purchased together with your product in the same order, with the combination rate.

get_repeat_purchase

Get Repeat Purchase behaviour (Amazon Brand Analytics, MONTHLY) per ASIN: orders, unique customers, the % of customers who are repeat buyers, and repeat-purchase revenue.

More tools

get_shopper_insights

Amazon Marketing Cloud (AMC) shopper-level results for one account, one week (Monday–Sunday, the account's time zone): counts of unique people, which ad reports cannot give.

Intelligence

get_entity_tiers

Get the performance tiers for products or targets, computed LIVE from the daily fact tables (90-day sales contribution).

get_asin_competitors

For your advertised ASINs, returns the top competitor ASINs (rivals most clicked on the same top search terms), with shared_terms and each rival's click & conversion share vs yours — from the weekly Amazon Search Terms report.

get_strategies full access

List the optimization strategy templates — name, target ACoS, waste/scaling multipliers, whether default/system/custom, and how many accounts each is assigned to.

Agency workflow

get_tasks full access

List team tasks for the organization: title, type, priority, status, assignee, due date and whether overdue, plus KPI counts (open, in progress, completed today, overdue).

create_task changes data

Create a manual task in the account's tasks list (the same tasks spine the account manager works — /account/{profile}/tasks).

get_change_task

Returns one change task (a proposed, queued or executed change to an Amazon Ads entity) by its opaque handle (tsk_…).

get_commitments full access

List the commitments (measurable targets) set for an account and progress toward each: target metric/operator/value, baseline, current value, % to target, status (on_track/at_risk/behind/achieved/expired/withdrawn), deadline and days remaining.

get_agency_recommendations full access

List Amazon's partner opportunity recommendations across the accounts you manage: objective, advertiser, campaign, the current vs recommended value, confidence, estimated impact, apply method and status.

get_recommendations full access

Lists Amazon's unified account recommendations (the Amazon Ads v1 Recommendations feed, keyed on the global advertiser account) across the accounts the caller can access, including dismissed and expired ones: recommendation type, account, ad product, Amazon…

get_mis_overview full access

Get a management-information overview across the accounts you manage: per-account counts of bid/budget/status/negative/creation changes and how many were automation vs platform vs external, plus an average change-validity score — over a date window.

get_change_intelligence full access

Returns change-intelligence stories for an account: its Amazon Ads change history grouped into recognisable patterns (scaled winner, cut waster, bid stampede, budget burst, negative sweep, bulk create, status churn).

Data analyst (read-only SQL)

run_analysis_query

Run a read-only SQL SELECT against ScaleSKUs' analytics database (MySQL 8), which holds the Amazon Ads, Seller/Vendor Central and Brand Analytics data ScaleSKUs syncs.

list_data_tables

Lists the analytics tables open to analysis, with approximate row counts.

describe_table

Returns one analytics table's columns (name, type, nullable, key) and a few sample rows.

export_to_sheet changes data

Puts a result into a new Google Sheet in the user's own Google Drive, once, and returns the sheet's link.

schedule_sheet_report changes data

Sets up an automated Google Sheet report: a read-only SQL SELECT over ScaleSKUs' analytics database (MySQL 8) that the ScaleSKUs server re-runs on a schedule — hourly, daily, weekly or monthly at a set local time — and writes to a sheet in the user's own Go…

list_sheet_reports

Lists the automated Google Sheet reports set up in this workspace: for each, the report_id, title, status (active, paused, needs_google, no_access, failing), schedule, mode (replace / append), sheet URL, next and last run, rows written and the last error.

update_sheet_report changes data

Changes an automated Google Sheet report by report_id.

Automation

get_automation_rules full access

Get automation rules configured for a profile: bid rules, budget rules, status change rules, negative keyword rules.

get_automation_action_logs full access

Get automation action logs — the history of all automated changes made to campaigns, bids, budgets, and keywords.

preview_automation full access

Dry-runs an automation rule draft against the account as it is now; nothing is saved or changed.

get_automation_performance full access

Returns how an automation rule has done over the last N days (default 14, at most 90), worked out the same way on every call: activity (changes proposed, run on their own, run by a person, waiting for approval and why, closed, rejected, failed; direct write…

get_due_reviews full access

Lists the automation rules due or overdue for review, plus those falling due within the next N days: account, rule id and name, whether it is active, due date, days overdue, owner, review cadence, last verdict and review date, and whether it is in approval…

get_dayparting full access

Returns an account's day-parting: its schedules (id, name, ENABLED / PAUSED, mechanism bid | budget | state, scope, windows as hours of the week with their bid / budget change %, conflicts with other automations, source, last run, review date) and the windo…

list_automation_library

Returns automation recipes set from the account's own numbers — waste negatives, bid trims over target ACoS, zero-order cuts, bid raises on under-target winners, budget top-ups while profitable.

Change history

get_change_history full access

Returns an account's Amazon Ads change history, synced from Amazon's history API, so changes made anywhere (Amazon console, ScaleSKUs, other tools) are included: what changed, when, and the previous and new values.

Shared memory

memory_remember changes data

Saves a note the user asks to keep to the organization's shared team memory in ScaleSKUs, which the whole team can read back later from any connected client.

memory_recall

Search the shared, cross-platform team memory by keyword (matches title, content, and rationale) with optional filters.

memory_timeline

The shared team memory in chronological order — what happened and when (decisions taken, campaigns created, searches run, notes).

memory_forget changes data

Archives a saved team memory by its id, so it no longer appears in recall, the timeline or the shared team summary.

memory_stats

Summarize the shared team memory: total memories, counts by type (decision / discussion / search / campaign_event / fact / preference / note), and the latest timestamp.

memory_consolidate changes data

Rebuild the summary of your organization's team memory now — the consolidated notes that load at the start of every session.

Changes (write tools)

adjust_bid changes data

Sets a new bid on an existing keyword or target.

adjust_budget changes data

Sets a new daily budget on an SP, SB or SD campaign.

add_negative changes data

Adds a negative keyword to a campaign or ad group so its ads stop showing for a search term.

harvest_keyword changes data