> For the complete documentation index, see [llms.txt](https://docs.sellermagnet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sellermagnet.com/ppc-management-beta/ppc-manager-overview/ppc-mcp.md).

# PPC AI connections (MCP server)

Connect your own AI assistant (Claude, ChatGPT, Cursor, VS Code or any other MCP client) to your SellerMagnet account, area by area, inside limits you set.

{% hint style="info" %}
**Difficulty:** 🔴 Advanced · **Reading time:** \~14 min
{% endhint %}

{% hint style="success" icon="rocket" %}
**Open this page in your dashboard:** [**Go to Settings > AI connections →**](https://dashboard.sellermagnet.com/settings)
{% endhint %}

{% hint style="warning" icon="triangle-exclamation" %}
**BETA:** AI connections are in beta and open to accounts admitted from the waitlist first. Some behavior may still change. Report issues at <info@sellermagnet.com>.
{% endhint %}

## 📋 Overview

The **AI connections** feature lets you connect your own AI assistant, such as Claude, ChatGPT, Cursor or VS Code, to your SellerMagnet account through an open standard called **MCP (Model Context Protocol)**. It started as a PPC-only connection; it now covers every dashboard area - PPC, sales and orders, products and inventory, expenses and refunds, reimbursements and fee audit, the repricer, listings, Offer Watch, alerts and notifications, review requests, tags, and product research. You pick which areas the assistant may read, and, only if you allow it, what it may change in each, always inside the limits and guardrails you set.

![SellerMagnet MCP server landing page: connect your SellerMagnet account to Claude, ChatGPT or Cursor](https://4139654583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fih2knSvVpBcq5rIeXVjM%2Fuploads%2Fgit-blob-41f1491ad547514a89e7999f61588e494f1f088c%2Fppc-mcp-landing-overview.png?alt=media)

This is different from pasting a report into a chat window. An uploaded report is a one-off snapshot the assistant can only read. Through the MCP server the assistant reads the live data SellerMagnet keeps in sync with your Amazon account whenever you ask, and any change it proposes is checked and logged the same way a change you make by hand would be.

AI connections cost nothing extra: your assistant runs in your own AI app, so using it never spends SellerMagnet AI credits by itself. Letting it write optimized listing drafts is the one exception - that uses your normal AI credits, inside a daily limit you set, same as writing a draft in the dashboard.

***

## 🔒 Beta and whitelist access

AI connections ship behind a waitlist while the feature is in beta:

* If your account has not been admitted yet, Settings > AI connections and the consent screen shown to a connecting AI app both show **AI connections are in beta** with a **Request beta access** button instead of a server address.
* Press **Request beta access** once. The request is recorded; our team admits beta accounts one by one. You do not need to ask again - once your account is admitted, start the connection again from the AI app.
* Once admitted, Settings > AI connections shows the server address and the Copy button described below.

***

## 🔌 How to connect

### 1. Find the server address

Open **Settings > AI connections** (also reachable from the PPC menu's **AI connections** row, next to Approval Center and Activity Log). Once your account is admitted, you see the server address with a **Copy** button:

```
https://mcp.sellermagnet.com/mcp
```

### 2. Add it in your AI app

![Connect in two minutes: the server address and per-app steps for Claude, Claude Code, ChatGPT and Cursor/VS Code](https://4139654583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fih2knSvVpBcq5rIeXVjM%2Fuploads%2Fgit-blob-762541118c11664ae59884821db32ada4a0ed90f%2Fppc-mcp-connect-steps.png?alt=media)

| App                         | Steps                                                                                                       |
| --------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Claude** (web or desktop) | Settings > Connectors > Add custom connector, paste the address                                             |
| **Claude Code**             | `claude mcp add --transport http sellermagnet-ppc https://mcp.sellermagnet.com/mcp`, then `/mcp` to sign in |
| **ChatGPT**                 | Settings > Apps & Connectors > Create, paste the address                                                    |
| **Cursor / VS Code**        | Add it as a remote MCP server, paste the address                                                            |

Any other app that supports a remote MCP server with OAuth sign-in works the same way: paste the server address and sign in when prompted.

### 3. Sign in and give consent

The AI app opens the SellerMagnet consent page in your browser. Sign in with your SellerMagnet account (password or SSO - the page resumes after you log in), then choose, on the same page:

* **Project** - which SellerMagnet project the connection belongs to.
* **Areas** - one box per dashboard area (PPC, sales and orders, products, and so on). Ticking an area lets the app read it; the Amazon Ads profiles picker only appears inside the PPC area.
* **Permissions (scopes)** - what it may change in each ticked area, see the table below.
* **Write mode** - see below.
* **Safety limits** - see below.

Press **Allow** to finish, or **Deny** to stop. The page cannot be shown inside another site's frame, sends no referrer, and warns you not to continue if someone else sent you the link - only press Allow if you started the connection yourself, in your own AI app.

{% hint style="info" %}
**Verified vs. unverified apps:** the consent page labels an app **Verified app** only when it registered from a verified domain (Claude, ChatGPT, Cursor, VS Code and a short list of other known apps). A self-registered app, which anyone can name anything, always shows **Unverified app** together with the address it returns to. Check the label before you press Allow.
{% endhint %}

***

## 🔑 Permissions (scopes)

Tick an area to let the app read it, then tick which of its actions the app may also take. Every connection always sees the basics (the project, its Amazon connections and your usage) with no box to tick.

![Public overview of the MCP server's areas and tools (public landing page, Offer Watch and Alerts areas shown)](https://4139654583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fih2knSvVpBcq5rIeXVjM%2Fuploads%2Fgit-blob-79f58af458ed7a5154f6143ae593ba038bf26332%2Fppc-mcp-areas-tools.png?alt=media)

| Area                                               | Read                                                                                                                                                                                                                                                                                                                                                                                      | Write actions you can also grant                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Amazon Ads (PPC)** (`ppc.read`)                  | Campaigns, ad groups, keywords, targets, product ads, negatives, search terms, performance, budgets, recommendations, settings, placement and wasted-spend reports, TACoS, profit per advertised product, budget pacing, period-over-period comparisons, the protected list, brand terms, bid rules, the automation status and the change history of the Amazon Ads profiles you selected | Change bids (`ppc.bids.write`) · Pause and enable, protect a campaign or keyword from changes, and emergency-stop SellerMagnet's own PPC automation (`ppc.state.write`) · Change budgets (`ppc.budgets.write`) · Add keywords, negatives and brand terms, and negate wasteful search terms (`ppc.keywords.write`, incl. harvest) · Edit campaign settings (`ppc.campaigns.write`) · Handle and snooze recommendations (`ppc.approvals`)                                                                  |
| **Sales and orders** (`sales.read`)                | Sales, profit and fee figures, orders, payouts, transactions, account health, cancelled and returned orders, Subscribe & Save, on-time delivery performance                                                                                                                                                                                                                               | Read-only area, no write action                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Products and inventory** (`products.read`)       | Your product catalogue, product costs (COGS), per-product sales, inventory, stock forecast and restock rules, a SKU's ad-attributed vs. organic sales history, its Best Sellers Rank history, and products that used to sell and stopped                                                                                                                                                  | Edit product costs and stock rules (`products.write`): set product costs and cost batches, and change restock rules and stock alerts                                                                                                                                                                                                                                                                                                                                                                     |
| **Expenses and refunds** (`finance.read`)          | Expenses, the expense ledger, Amazon fees and refunds                                                                                                                                                                                                                                                                                                                                     | Edit expenses (`finance.write`): add, change and delete expenses, including how a one-time cost is spread over months (amortisation) and which marketplace or scope it counts against (allocation)                                                                                                                                                                                                                                                                                                       |
| **Reimbursements and fee audit** (`recovery.read`) | Lost & Found claims, reimbursements, the Fee Audit findings, reimbursement trends over time, and fee-change signals Amazon made on your products                                                                                                                                                                                                                                          | Work on claims (`recovery.write`): file a new Fee Audit claim, update claim and fee-audit statuses, notes and case ids, and undo a claim filed by mistake (within 5 minutes). Marking a claim reimbursed bills the Lost & Found success fee, so that step always needs a confirmation                                                                                                                                                                                                                    |
| **Repricer** (`repricer.read`)                     | Repriced listings, strategies, price history and activity, a dry-run simulation of what a repricer would do right now, and the sellers your repricers are set to ignore                                                                                                                                                                                                                   | Change the repricer (`repricer.write`): add, edit, start, stop and delete repricers, raise or lower their min/max price bands (with a preview; band changes can be undone), and make a repricer ignore, or stop ignoring, a seller's offers. The repricer never prices outside the band                                                                                                                                                                                                                  |
| **Listings** (`listings.read`)                     | Listing quality, the listing agent's findings, variations and keyword research                                                                                                                                                                                                                                                                                                            | Edit listings on Amazon (`listings.write`): change the title, bullet points, description and search keywords of a listing in one submission, checked with Amazon first, every change can be reverted · Use credits for listing drafts (`listings.ai`): write optimized drafts of a listing's title, bullets and description, and translate listing text for another marketplace, using your AI credits inside the daily limit below; drafts and translations are not published until a listing is edited |
| **Offer Watch** (`offerwatch.read`)                | Offer and Buy Box events, competing sellers, the watched catalogue, and how Offer Watch itself is set up (paused or not, thresholds, digest rhythm, muted ASINs)                                                                                                                                                                                                                          | Handle Offer Watch events (`offerwatch.write`): set events to open, pending or solved, mark sellers as authorised, and change the Offer Watch settings themselves: pause or resume it, ignore FBM offers, set the undercut threshold or digest rhythm, and mute or unmute ASINs                                                                                                                                                                                                                          |
| **Alerts and notifications** (`alerts.read`)       | Your competitor alerts, their logs, the alert types available, and your SellerMagnet notifications                                                                                                                                                                                                                                                                                        | Manage alerts (`alerts.write`): create a new competitor alert, edit an alert's conditions, start, stop and delete alerts, and mark notifications as read                                                                                                                                                                                                                                                                                                                                                 |
| **Review requests** (`reviews.read`)               | Orders eligible for a review request, sent requests and their statistics                                                                                                                                                                                                                                                                                                                  | Send review requests (`reviews.send`): ask Amazon to send review requests to buyers, inside the daily limit below. Requests cannot be withdrawn, so every send needs a confirmation                                                                                                                                                                                                                                                                                                                      |
| **Tags** (`tags.read`)                             | Your tags, tag groups, which products carry them, and the products that carry a given set of tags                                                                                                                                                                                                                                                                                         | Manage tags (`tags.write`): create and delete tags, rename or regroup an existing tag, create a tag group, and tag or untag products                                                                                                                                                                                                                                                                                                                                                                     |
| **Product research** (`research.read`)             | Your product lookup history and saved products                                                                                                                                                                                                                                                                                                                                            | Look up products (`research.lookup`): run product lookups (they use your monthly lookup allowance, inside the daily limit below) and save products                                                                                                                                                                                                                                                                                                                                                       |

Several areas can also filter by tag: orders, products, refunds, repricer items, review-request orders and Fee Audit signals can all be narrowed to products carrying specific tags, wherever that area's own read tool supports it.

If your role in the project is view-only, you can only grant the read side of each area - the consent page tells you so, and the app can only read.

***

## ✍️ Write mode

Only relevant if you granted at least one write action. Choose on the consent page, and change it later in Settings > AI connections:

| Mode                                           | What happens                                                                                                                                                                                                                                              |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Apply directly within the limits** (default) | Changes apply at once, inside your limits, your plan and SellerMagnet's guardrails. Actions that cannot be undone or cost money (for example sending review requests or marking a claim reimbursed) ask the app for a confirmation first                  |
| **I approve every change first**               | PPC bid, budget and pause/enable changes on campaigns, keywords and targets wait in your **Approval Center** (source "AI assistant") until you approve them. Changes that cannot wait there, including every change outside PPC, are refused in this mode |

In either mode, an action the AI app proposed can only be approved by you. Any member of the project may switch a connection to approval mode or revoke it; only the member who originally connected the app may switch it back to direct.

***

## 🛡️ Safety limits

Set on the consent page, changeable by revoking and reconnecting. They apply on top of your existing plan limits and SellerMagnet's own guardrails, not instead of them. A limit set to 0 switches that action off.

| Limit                                    | Applies to       | Default                                                                                                               |
| ---------------------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------- |
| Largest bid change per action            | PPC              | 50% (measured from the ad group's default bid when a keyword has no bid of its own)                                   |
| Highest bid                              | PPC              | 10 USD                                                                                                                |
| Largest budget change per action         | PPC              | 50%                                                                                                                   |
| Highest daily budget                     | PPC              | 500 USD                                                                                                               |
| Largest repricer price change per action | Repricer         | 50%                                                                                                                   |
| AI credits per day                       | Listing drafts   | set by you                                                                                                            |
| Product lookups per day                  | Product research | set by you                                                                                                            |
| Review requests per day                  | Review requests  | set by you                                                                                                            |
| Changes per day                          | Every area       | 300 entity changes sent or queued (a call with 40 bids counts 40; a call that would cross the limit is refused whole) |
| Items per call                           | Every area       | 50                                                                                                                    |

The money limits are set in US dollars and converted to each marketplace's own currency, so marketplaces that bill in yen or rupees work the same way.

{% hint style="warning" %}
**What the connection can touch.** A connection only ever sees the project (and, inside PPC, the Amazon Ads profiles) you chose at consent. Every id the app sends is checked against that project and those profiles before any read or write - your project membership, tool access and Amazon connection are re-checked on every call, so revoking access anywhere stops the connection working within seconds. Your **protected list** and a **Stop all automation** switch (project-level or account-wide) apply to every AI write exactly as they do to SellerMagnet's own automation.
{% endhint %}

***

## 📜 Activity, expiry and revoke

Settings > AI connections lists every app connected to the current project - every member of the project sees it, since an AI app acting on a shared account should never be invisible to the others. For each connection you see:

* **Connected by** - who gave consent, and when.
* **Permissions per area** - each area granted, with its allowed actions, or marked read only.
* **Amazon Ads profiles** - shown only when the connection includes the PPC area.
* **Valid until** - a connection expires 90 days after it was created (or after a reconnect).
* **Calls** - how many calls it has made in total; press **Activity** to open its recent call log.
* **How changes are made** - the write-mode selector described above (only shown when the connection has a write scope).

Press **Edit permissions** to untick an area or action the app should no longer have - narrowing only; to give it more, connect it again from the AI app and go through consent. At least one area must stay ticked, or revoke the connection instead. Press **Revoke** to end the connection and all its tokens at once; the app loses access immediately. Every call an AI app makes is also listed under **Activity**; PPC changes additionally appear in your **PPC Activity Log**, tagged with the source **AI assistant**, so you can audit AI-made changes the same way you audit your own.

***

## 🌐 The public pages

`sellermagnet.com/<lang>/amazon-seller-mcp-server` is the public landing page for the full, every-area MCP server. The earlier `sellermagnet.com/<lang>/amazon-ppc-mcp-server` page still exists side by side, focused on PPC and priced against the PPC Manager module; both are reachable while the feature is enabled. Their FAQs answer the questions sellers ask most before connecting:

* **What is an MCP server?** - the open standard AI apps use to call outside tools; the SellerMagnet server gives an assistant tools that read your data and, where you allow it, make changes, all limited to your own account.
* **Can the AI break my data?** - it can only do what you allowed, inside the limits you set. Writes go through the same checks as SellerMagnet's own automation, every change is logged, and in approval mode nothing goes live without you.
* **Does it cost extra?** - no, beyond your existing plan. Only listing drafts spend your normal AI credits, inside a daily limit you set.
* **Which marketplaces are covered?** - every Amazon marketplace connected to your SellerMagnet project.
* **How do I disconnect an app?** - open Settings > AI connections and press Revoke.

***

## ❓ FAQ

<details>

<summary><strong>Which AI apps can I connect?</strong></summary>

Any app that supports a remote MCP server with OAuth sign-in: Claude (web, desktop app and Claude Code), ChatGPT, Cursor, VS Code and others. Use the server address `https://mcp.sellermagnet.com/mcp` in each app's own "add a connector" or "add a remote MCP server" step.

</details>

<details>

<summary><strong>Can the AI see data from other projects or sellers?</strong></summary>

No. A connection belongs to one project and the areas (and, for PPC, the Amazon Ads profiles) you chose at consent, and every id the app sends is checked against that project on every call. The app never sees your password, payment data or other projects.

</details>

<details>

<summary><strong>What if I am not admitted to the beta yet?</strong></summary>

Press **Request beta access** on the consent page or in Settings > AI connections. Our team admits beta accounts one by one; you do not need to request again, just start the connection from the AI app once you are admitted.

</details>

<details>

<summary><strong>Does this use my SellerMagnet AI credits?</strong></summary>

Only for listing drafts, inside the daily credit limit you set. Every other area (PPC, sales, products, repricer, and so on) uses no SellerMagnet AI credits - the assistant runs in your own AI app.

</details>

<details>

<summary><strong>How is a change the AI makes different from one I make by hand?</strong></summary>

It goes through the same gates: your plan limits, your protected list (for PPC and the repricer), and the **Stop all automation** switch. It is also checked against the connection's own safety limits on top of those. Every call lands under Activity, PPC changes also land in your PPC Activity Log with the source **AI assistant**, and in approval mode a PPC change waits in your Approval Center like any other queued suggestion.

</details>

<details>

<summary><strong>What happens if I revoke a connection by mistake?</strong></summary>

The app loses access at once and its tokens stop working. There is no undo - reconnect the app from your AI app and go through consent again to restore access.

</details>

***

## ➡️ What's Next?

{% content-ref url="/pages/iWrHWpvfg4usrjbVNyFz" %}
[PPC Manager: Overview](https://docs.sellermagnet.com/ppc-management-beta/ppc-manager-overview.md)
{% endcontent-ref %}

{% content-ref url="/pages/kw3mb3OSwMEFnPlRPVag" %}
[PPC AI Optimizer](https://docs.sellermagnet.com/ppc-management-beta/ppc-manager-overview/ppc-ai-optimizer.md)
{% endcontent-ref %}

{% content-ref url="/pages/xUaJFWbcCTCya95L64xQ" %}
[PPC Approval Center](https://docs.sellermagnet.com/ppc-management-beta/ppc-manager-overview/ppc-approval-center.md)
{% endcontent-ref %}

{% content-ref url="/pages/UR1mVi1OEupeXaCZA7zK" %}
[PPC Activity Log](https://docs.sellermagnet.com/ppc-management-beta/ppc-manager-overview/ppc-activity-log.md)
{% endcontent-ref %}

{% content-ref url="/pages/gVXllc12Kbkb0xuLJfxw" %}
[PPC Settings](https://docs.sellermagnet.com/ppc-management-beta/ppc-manager-overview/ppc-settings.md)
{% endcontent-ref %}
