How to connect Claude or ChatGPT to Amazon Seller Central with an SP-API MCP server

An Amazon SP-API MCP server wraps Selling Partner API operations as Model Context Protocol tools, so Claude, ChatGPT or Cursor can read orders, FBA stock, listings and fees and, after a person approves, change them. Amazon runs one behind its Claude plugin (beta, US). A custom server should hold the Login with Amazon credentials, respect Amazon's rate limits, keep buyer data out of the chat and log every write.
- The current MCP specification is version 2026-07-28, which made the protocol stateless. Anthropic donated MCP to the Agentic AI Foundation, a directed fund under the Linux Foundation, on December 9, 2025.
- Amazon's Selling Partner plugin, announced September 23, 2026, is in beta for sellers in Amazon's US stores; its Claude version connects to the Amazon Selling Partner Connector, a remote MCP server Amazon runs.
- Amazon's Local MCP for SP-API, posted May 28, 2026, is a developer toolkit published as sample code; the Amazon Ads MCP Server has been in open beta since February 2, 2026 for Ads API partners.
- SP-API rate limits are token buckets, mostly per seller-and-app pair: searchOrders defaults to 0.0056 requests per second with a burst of 20, about 20 calls an hour once the burst is spent.
- Amazon's Agent Policy took effect March 4, 2026: AI agents must identify themselves as automated systems, follow the policy at all times and stop if Amazon asks.
Connecting an AI assistant to an Amazon seller account now takes minutes. Making that connection safe to leave running takes engineering: the right SP-API roles, pacing against Amazon's rate limits, buyer data kept out of the chat, and a person approving anything that changes prices, stock or listings. This guide covers each part, with a table of which SP-API operations to expose, which to gate behind an approval, and which to keep away from the model, including their roles and default rate limits.
What is an SP-API MCP server?
The Model Context Protocol (MCP) is an open-source standard for connecting AI applications to outside systems. An MCP server publishes tools, each with a name, a description and an input schema. An MCP client such as Claude, ChatGPT or Cursor lets the model call those tools and reads back the results. Anthropic donated MCP to the Agentic AI Foundation, a directed fund under the Linux Foundation, on December 9, 2025.
An SP-API MCP server is an MCP server whose tools wrap operations of Amazon's Selling Partner API. A "check FBA stock" tool calls getInventorySummaries; an "update price" tool calls patchListingsItem. The server sits between the model and Amazon: it stores the seller's authorization, requests access tokens, paces calls and decides which operations the model may reach at all. The current specification is version 2026-07-28, which made MCP a stateless request and response protocol with no protocol-level session (checked September 25, 2026). Anything that must survive between calls, such as a pending price change, needs its own ID that the server stores.
Advertising is a separate API. Campaigns, bids and budgets live in the Amazon Ads API, not in SP-API, and Amazon Ads runs its own MCP server for that side. A server that answers "which SKUs are close to a stockout while we keep bidding on them" needs both connections, both sets of credentials and both sets of limits.
Which options exist today: Amazon's own tools, hosted MCP, open source or custom?
There are now six ways to put Seller Central data in front of a model. They differ in three ways that matter: who runs the server, whether it can change data, and whose rules decide what it may do. Facts below come from each provider's own pages, checked September 25, 2026.
| Option | What it is | Can it change data? | Fits when |
|---|---|---|---|
| Amazon Selling Partner plugin and Connector | Amazon's plugin for Amazon Quick and Claude, in beta for its US stores; the Claude version connects to a remote MCP server Amazon runs | Yes, after the seller approves each action | You sell mainly on Amazon US and want answers and approved fixes without building anything |
| Local MCP for SP-API | Amazon's developer toolkit, run on your machine: docs search, endpoint catalog, code generation, a workflow builder. Sample code, not a supported product | Yes, through its execute tool and workflows, with your own credentials | Your developers are building or migrating an SP-API integration |
| Amazon Ads MCP Server | Amazon Ads' server for Ads API work, in open beta | Yes: create, update or delete campaigns | You already hold Ads API access |
| Hosted MCP services | Third-party servers you subscribe to | Varies by vendor | You want a connection this week and accept the vendor's tools and rules |
| Open-source servers | Community code on GitHub that you run | Varies by repository | You have engineers to review, secure and maintain it |
| Custom server | Your SP-API app, your cloud, your tools and approval rules | Only through gates you define | You need other channels, your own business rules, logs you hold, or several brands |
Amazon announced the Selling Partner plugin on September 23, 2026, in beta for sellers in its US stores, with international expansion to follow; sellers review and approve actions before they run. The Claude plugin files Amazon published in its selling-partner-agentic-toolkit repository register the Amazon Selling Partner Connector at sellingpartner-ai.amazon.com/mcp. You authorize it through Seller Central OAuth consent, it can use only the tools your Seller Central roles allow, and writes are drafted for your approval (both checked September 25, 2026). Amazon decides which tools it offers and documents no other channels. Our plugin explainer covers what it reads and changes.
Amazon's Local MCP for SP-API, posted May 28, 2026 by its Selling Partner Developer Services team, is an npm package with two servers: a developer assistant (documentation search, code samples, an Orders v0 to v2026-01-01 migration helper) and a workflow builder. Most tools run without credentials; live calls need yours. It sits in Amazon's samples repository, whose README calls the samples "educational examples", not supported products, to be tested and secured before production. The Amazon Ads MCP Server has been in open beta since February 2, 2026, globally, for Amazon Ads partners with active API credentials (checked September 25, 2026).
Hosted services differ in how they treat writes. Agent Central says all writes preview before submission and it logs every change with before and after values, with plans from $39 a month for up to 1,000 orders a month. AnythingMCP says its v1 is "read-focused for safety" and leaves buyer PII out by design (both checked September 25, 2026). If you sell only on Amazon and your questions fit their tools, one of these, or Amazon's own plugin, is faster and cheaper than a build. Our comparison of agent platforms and custom agents goes further.
How does authorization work?
There are two hops, each with its own credentials. Between the AI client and your server, the MCP authorization spec applies: a remote server over HTTP that requires authorization acts as an OAuth 2.1 resource server and must check that each token was issued for it, while a local server over stdio should read credentials from its environment instead. The spec's security best practices rule out "token passthrough": a server must not accept tokens that were not issued for it. Never let an AI client hand your server a seller's Amazon token to forward.
Between your server and Amazon, SP-API uses Login with Amazon. The server exchanges a stored refresh token for an access token that lasts 3,600 seconds, and must send a user-agent header with at least the app's name, version and language on every request (Amazon's connection guide, checked September 25, 2026). Client secrets must be rotated every 180 days, or the app gets errors when it calls SP-API. Amazon sends a notice 90 days before the deadline; route it to your alerting, not to one person's inbox.
| Private application | Public application | |
|---|---|---|
| Who it serves | A single organization | Many selling partners |
| How it is authorized | The account's Primary User self-authorizes it | OAuth through Login with Amazon, from your website or the Appstore |
| Authorization limit | 10 self-authorizations | 25 OAuth authorizations for seller apps until listed in the Appstore, then unlimited |
| Reauthorization | Amazon's 365-day rule is written for public apps | Every 365 days, and whenever you add a role |
For one brand, a private application is usually right: the brand's Primary User self-authorizes it, and Amazon limits private applications to a single organization, so the server serves only that brand's accounts, up to the 10 self-authorizations Amazon allows. An agency or software vendor connecting other companies' accounts needs a public app, which each seller must reauthorize every 365 days. Registration steps are in how to register for Amazon SP-API. Request only the roles your tools need: each one widens what a confused model or a leaked token can reach.
How do you handle rate limits and restricted data?
SP-API usage plans are token buckets. Each operation has a rate (tokens added per second) and a burst (the bucket's size), most limits apply per selling partner and application pair, and an empty bucket returns HTTP 429, which is retryable with back-off. A chat model knows none of this. Ask it for "every order this quarter" and it will page through searchOrders, whose default is 0.0056 requests per second with a burst of 20: twenty quick calls, then about 20 an hour.
Sustained calls per hour = rate per second × 3,600 (after the burst is spent)
The MCP tools specification says servers must rate limit tool invocations. In practice that means a cache of recent reads, a queue that paces each operation against its own bucket, and tool results that tell the model when data is cached or queued, instead of a raw 429 it will retry. When Amazon returns the x-amzn-RateLimit-Limit header, pace against that value rather than the published default, because some usage plans are adjusted per seller. Route big questions to reports: createReport allows about 60 requests an hour and runs asynchronously, so the tool should return a job ID the model can check later.
Buyer names, addresses, emails and phone numbers are PII. In Orders API v0, restricted operations need a Restricted Data Token, and Amazon's reference example shows one lasting 3,600 seconds. The Orders API v2026-01-01 drops the RDT: buyer and recipient fields come back only when you request them with includedData=BUYER or RECIPIENT and hold a role that allows them, such as Direct-to-Consumer Shipping (Restricted). Orders v0 calls such as getOrders are scheduled for removal on March 27, 2027, so build new order tools on v2026-01-01.
The rule for MCP is simple: PII never enters the model's context. Leave BUYER and RECIPIENT out of every order tool, never expose the token call as a tool, and when a workflow needs an address, pass an order ID to a server-side step that reads it there. Whatever a tool returns can end up in the AI client's conversation history.
Which write actions are safe to expose, and how do you gate them?
An MCP server can expose any operation the API offers. The useful question is which calls a model may make alone, which need a person, and which should never be tools. This is how we sort them. Rates are Amazon's published defaults, checked September 25, 2026; your account's plan can be higher, and roles come from Amazon's role mappings.
Expose as tools: reads, paced and logged
| Operation | What the tool answers | Roles (need one) | Default rate, burst | PII and RDT |
|---|---|---|---|---|
| searchOrders | Which orders came in, by date and status | Any of 12, such as Inventory and Order Tracking | 0.0056/s, 20 | No RDT; leave BUYER and RECIPIENT out |
| getInventorySummaries | FBA stock by SKU | Amazon Fulfillment or Product Listing | 2/s, 2 | None |
| getListingsItem | A SKU's attributes, offer and issues | Product Listing or Inventory and Order Tracking | 5/s, 10 | None |
| getCompetitiveSummary | Featured offer and competing prices | Pricing | 0.033/s, 1 | None; cache results |
| listTransactions | Fees, refunds and reimbursements | Finance and Accounting | 0.5/s, 10 | None |
| createReport and getReportDocument | Bulk data for bigger questions | Depends on the report type | 0.0167/s, 15 each | Reports with PII need an RDT; expose non-PII types only |
Expose only behind an approval step
| Operation | What it changes | Roles (need one) | Default rate, burst | Gate |
|---|---|---|---|---|
| patchListingsItem | Price, quantity or attributes on one SKU | Product Listing or Inventory and Order Tracking | 5/s, 5 | Run with mode=VALIDATION_PREVIEW, show the diff, enforce price floor and ceiling |
| putListingsItem | Creates or replaces a whole listing | Product Listing or Inventory and Order Tracking | 5/s, 10 | Preview first, then approval of the full listing |
| createFeed (JSON listings feed) | Many SKUs at once | Depends on the feed type | 0.0083/s, 15 for createFeed; the JSON listings feed allows 5 feeds per 5 minutes, up to 25,000 messages each | Approve the whole change set; cap rows per feed |
| createInboundPlan | Starts an FBA inbound plan | Amazon Fulfillment | 2/s, 2 | Approval against capacity and the reorder plan |
| createFulfillmentOrder | Ships FBA stock to an address (MCF) | Amazon Fulfillment | 2/s, 30 | Approval; the address comes from your order system, never the chat |
| Review request | Asks a buyer for a review and feedback | Buyer Solicitation or Product Listing | 1/s, 5 | Approval or a fixed rule the brand signs off; one per order |
| Buyer messages (Messaging API) | Sends a message to a buyer | Buyer Communication or Product Listing | 1/s, 5 | A person approves every customer message |
| Ads API bids, budgets, campaign state | Ad spend | Ads API access, separate from SP-API | Ads API limits | Approval with hard limits on each change |
Never expose to the model
| Operation or asset | Why not |
|---|---|
| createRestrictedDataToken | It unlocks buyer PII; keep it inside server-side steps |
| getOrderAddress, getOrderBuyerInfo (Orders v0) | Puts buyer PII in the chat, and v0 is scheduled for removal on March 27, 2027 |
| deleteListingsItem | A model that picks the wrong SKU removes a live offer; keep deletes on a screen a person uses |
| rotateApplicationClientSecret, refresh tokens, client secrets | Credentials belong in a secrets manager, never in a prompt or a tool result |
| Scraping or clicking through Seller Central | Use official APIs only; browser automation is hard to identify, log and stop |
The MCP tools spec says there should always be a human in the loop with the ability to deny tool invocations, and that clients must treat tool annotations as untrusted unless they come from trusted servers. So do not rely on a client's confirm button to protect a seller account. Put the gate in the server: a write tool returns a proposal (Amazon's validation preview, before and after values, limit checks) plus an ID, and a separate approval step, in your app or Slack, executes it.
Two details keep that approval honest. The MCP security best practices say possession of such an ID must never count as authentication, so tie each proposal to the user who created it and check the approver's rights before the call runs. Attach an idempotency key so a retried call cannot apply the same change twice, and log who approved the change, when, and what Amazon returned.
Price tools are where limits matter most. The repricer we built is rule-based automation, not an agent: it reprices against the Buy Box or the lowest price within rules the seller sets, such as staying above a set price. An MCP price tool needs the same floor and ceiling in the server, so a suggestion outside them is refused before anyone is asked to approve it.
How do you stay within Amazon's Agent Policy and Data Protection Policy?
Amazon announced on February 17, 2026 a Business Solutions Agreement update with a new Agent Policy, effective March 4, 2026. AI agents must identify themselves as automated systems, follow the Agent Policy at all times and stop accessing Amazon's services if Amazon asks. The same update restricts using Amazon materials or services for AI development. Our reading for an MCP server: a named app and user-agent on every call, a stop switch that disables write tools and revokes the refresh token at once, a log of every tool call, and no model training on SP-API data. Our Agent Policy guide covers the policy in full; this is not legal advice, and the text in Seller Central governs.
Amazon's security control guidance for its Data Protection Policy (updated September 2026) sets hard numbers. Delete PII within 30 days after order delivery, unless the law requires you to keep it longer. Encrypt PII with AES-128 or RSA-2048 keys or stronger, and use TLS 1.2 or higher in transit. Encrypt SP-API keys and credentials and never expose them in plain text. Keep security logs for at least 12 months where PII is stored or processed. Notify security@amazon.com within 24 hours of detecting a security incident. MCP adds one more place data can leak, the chat transcript, which is the practical reason to keep PII out of tool results.
Build, host or buy?
| Your situation | Start with |
|---|---|
| Amazon US only; you want answers and approved fixes now | Amazon's Selling Partner plugin |
| Developers building or migrating an SP-API integration | Amazon's Local MCP for SP-API |
| An ads team that already holds Ads API credentials | Amazon Ads MCP Server |
| Amazon-only, standard questions, no engineers | A hosted MCP service |
| Engineers in house who can own security and upkeep | An open-source server you review, or your own build |
| Several channels, your own rules, logs you hold, or many brands | A custom server on your own accounts |
A custom server is a small SP-API project with an AI front end, so the usual cost drivers apply; our SP-API development cost guide breaks them down, and hiring an SP-API developer covers what to look for if you staff it yourself. If your team is prototyping with an AI coding assistant, read what breaks when you build Amazon seller tools with AI before you ship. Once the server exists, AI agents can run routine work on top of it within the rules you approve.
Marketplace and ads accounts connected by region
See Growth OS ↗Ecomsellertool has built on Amazon's seller APIs since 2017 and shipped 50+ tools. Through our SP-API development work, we build MCP servers on the brand's own SP-API application and cloud, scope the tools and approval gates with the team, and connect Walmart, Shopify and 3PL data through Growth OS. You keep your accounts, your data and the custom code we build; the Growth OS base is licensed to you.
To see what a connected assistant would flag first, start with the free 24-hour diagnostic: connect Amazon with Login with Amazon, no password shared, and get the report within 24 hours of connecting, on business days. We only read data; we never change listings, prices, stock or ads. To scope a server, schedule a call.
Frequently asked questions
Is there an official Amazon MCP server for Claude?
Yes. Amazon's Selling Partner plugin connects Claude (in beta, for sellers in Amazon's US stores) to the Amazon Selling Partner Connector, a remote MCP server Amazon runs, and every write is drafted for your approval. Amazon decides which tools that server offers; for your own tools you run a second server next to it. Amazon also publishes a Local MCP for SP-API for developers and runs the Amazon Ads MCP Server in open beta for Ads API partners.
Can Claude change my Amazon prices through an MCP server?
Yes, if the server offers a write tool. Amazon's Connector drafts a price change for your approval when you name the exact price. On a custom server the tool would call patchListingsItem, and the safe pattern is that it never writes directly: it validates the change with Amazon's preview mode, checks your price floor and ceiling, and waits for a person to approve before the call runs.
Do I need my own SP-API developer registration to run an MCP server?
For a custom server, yes. A single brand usually registers a private application and self-authorizes it as the account's Primary User. Amazon's plugin and hosted MCP services use their own registrations, so you authorize their app instead of building one.
Is it safe to give an AI tool my Seller Central password?
No. Connect through official APIs with Login with Amazon authorization, which never shares a password, and grant only the roles the tools need. Avoid tools that sign in to Seller Central as you or drive it through a browser.
Can one MCP server cover Amazon, Walmart and Shopify?
Yes, if it is built that way. A custom server can expose tools backed by each marketplace's own API, and MCP clients can also call several servers at once. Amazon documents only Amazon data for its plugin, so other channels need their own connection.
How much does a custom SP-API MCP server cost?
It depends on the number of tools, marketplaces and approval flows, and on where it is hosted. We scope custom modules and agents in an architecture document with a fixed price and a go-live date. Our SP-API development cost guide explains the main cost drivers.
How we research, fact-check and compare: our editorial standards. Spot an error? Email hello@ecomsellertool.com and we will correct it.
