Amazon MCP
Provides tools for managing Amazon Seller Central accounts (orders, FBA inventory, listings, sales, pricing, fees, invoices, settlements, inbound shipments, merchant fulfillment, feedback, and analytics reports) and Amazon Ads campaigns (Sponsored Products, Sponsored Brands, Sponsored Display) via Amazon's APIs.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Amazon MCPshow me my top selling products this month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Amazon MCP
MCP (Model Context Protocol) servers for Amazon Seller Central and Amazon Ads API. Enables AI assistants (Claude, Cursor, Windsurf, etc.) to manage your Amazon account using natural language.
amazon-mcp/
├── amazon-seller-mcp 118 tools - Seller Central (SP-API)
├── amazon-ads-mcp 110 tools - Ads API (SP, SB, SD)
└── amazon-mcp-common - Shared libraryTable of Contents
Related MCP server: agentcentral
What You Can Do
Seller Central (amazon-seller-mcp)
Query orders, FBA inventory, sales, and metrics
Manage listings (create, edit, delete) and check listing restrictions
Analyze competitive pricing and Buy Box (v0 and v2022-04-01)
Get FBA reimbursements, storage fees, and return reports
Create and manage inbound shipment plans to FBA (packing, placement, transportation)
Manage Multi-Channel Fulfillment (MCF) orders and returns
Generate invoices and download documents
Access Brand Analytics reports (search terms, market basket, repeat purchases)
Send review request to buyers
Submit and manage product feeds (batch operations)
Manage A+ Content documents and publish records
Subscribe to notifications and manage delivery destinations
Get product type definitions for listing attributes
Check marketplace participations and seller account info
Ads API (amazon-ads-mcp)
Manage Sponsored Products, Sponsored Brands, and Sponsored Display campaigns
Create and download performance reports
Optimize keywords, bids, and budgets (including negative keywords/targets)
Calculate ACoS, TACoS, and ROAS
Correlate ads data with Seller Central sales
Manage SB stores, landing pages, and media uploads (requires Brand Registry)
Get budget and bid recommendations for SP/SB/SD campaigns
Manage advertising portfolios
Prerequisites
Node.js >= 18
pnpm >= 9
LWA (Login with Amazon) credentials — obtain them from Seller Central → Developer section (Apps & Credentials)
For Seller Central: SP-API Refresh Token, Seller ID, Marketplace ID
For Ads API: Refresh Token with
advertising::campaign_managementscope, Profile ID
Installation
git clone https://github.com/jhrendon/amazon-mcp.git
cd amazon-mcp
pnpm install
cp .env.example .envConfiguration
Edit .env with your credentials. You only need to configure the package you plan to use.
Seller Central (amazon-seller-mcp)
LWA_CLIENT_ID=amzn1.application-oa2-client.xxxxxxxxxxxx
LWA_CLIENT_SECRET=amzn1.oa2-cs.xxxxxxxxxxxxxxxxxxxxxxxx
SELLER_REFRESH_TOKEN=Atzr|IwEBIxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
SELLER_ID=Axxxxxxxxxxxxxxx
MARKETPLACE_ID=ATVPDKIKX0DERVariable | Description |
| Your LWA application Client ID |
| Your LWA application Client Secret |
| Refresh Token obtained from SP-API with seller permissions |
| Your Merchant ID (Seller ID) on Amazon |
| Primary marketplace ID (e.g. |
Ads API (amazon-ads-mcp)
LWA_CLIENT_ID=amzn1.application-oa2-client.xxxxxxxxxxxx
LWA_CLIENT_SECRET=amzn1.oa2-cs.xxxxxxxxxxxxxxxxxxxxxxxx
ADS_REFRESH_TOKEN=Atzr|IwEBIxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
ADS_PROFILE_ID=1234567890
ADS_API_REGION=naVariable | Description |
| Refresh Token with |
| Your advertising profile ID |
| API region: |
Build
pnpm buildConnecting to AI Clients
Each MCP server communicates via stdio. Configure your AI client to run the corresponding server.
Claude Desktop
Edit claude_desktop_config.json:
{
"mcpServers": {
"amazon-seller": {
"command": "node",
"args": ["/path/to/amazon-mcp/packages/amazon-seller-mcp/dist/index.js"],
"env": {
"LWA_CLIENT_ID": "amzn1.application-oa2-client.xxxxxxxxxxxx",
"LWA_CLIENT_SECRET": "amzn1.oa2-cs.xxxxxxxxxxxxxxxxxxxxxxxx",
"SELLER_REFRESH_TOKEN": "Atzr|IwEBIxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"SELLER_ID": "Axxxxxxxxxxxxxxx",
"MARKETPLACE_ID": "ATVPDKIKX0DER"
}
},
"amazon-ads": {
"command": "node",
"args": ["/path/to/amazon-mcp/packages/amazon-ads-mcp/dist/index.js"],
"env": {
"LWA_CLIENT_ID": "amzn1.application-oa2-client.xxxxxxxxxxxx",
"LWA_CLIENT_SECRET": "amzn1.oa2-cs.xxxxxxxxxxxxxxxxxxxxxxxx",
"ADS_REFRESH_TOKEN": "Atzr|IwEBIxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ADS_PROFILE_ID": "1234567890",
"ADS_API_REGION": "na"
}
}
}
}Cursor / Windsurf
Add to .cursor/mcp.json or your editor's MCP configuration:
{
"mcpServers": {
"amazon-seller": {
"command": "node",
"args": ["/path/to/amazon-mcp/packages/amazon-seller-mcp/dist/index.js"]
}
}
}Environment variables are inherited from .env in the project root if running from there.
Development with tsx
For development without building:
{
"mcpServers": {
"amazon-seller": {
"command": "npx",
"args": ["tsx", "/path/to/amazon-mcp/packages/amazon-seller-mcp/src/index.ts"]
}
}
}amazon-seller-mcp - Tools
118 tools organized by category.
Orders (3)
Tool | Description |
| List orders with filters by date, status, and fulfillment channel |
| Full order detail (address, buyer, status). Requires RDT for PII |
| Order line items (ASIN, SKU, quantity, price, taxes) |
FBA Inventory (2)
Tool | Description |
| FBA inventory summary: available, reserved, inbound, unfulfillable |
| Deep breakdown: reservation reasons, damage types, researching quantities |
Sales (2)
Tool | Description |
| Aggregated sales metrics (Sales API). Best for 7+ day ranges. 24-48h delay |
| Real-time sales summary from orders data. Best for today/yesterday |
Catalog (2)
Tool | Description |
| Product info by ASIN: title, brand, BSR, images, bullet points |
| Search catalog by keywords or identifiers (ASIN, SKU, UPC, EAN) |
Listings (5)
Tool | Description |
| Full listing document by SKU: attributes, offers, issues |
| Search seller listings with filters (status, SKU, product type) |
| Create or fully replace a listing (destructive) |
| Partial update (JSON Merge Patch). Only changes provided fields |
| Permanent and irreversible listing deletion |
Pricing & Competition (2)
Tool | Description |
| Competitive pricing: featured offer, lowest price, Buy Box, offer count (up to 20 ASINs) |
| Expected Buy Box winning price (FOEP) for up to 40 SKUs |
Fees & Costs (5)
Tool | Description |
| Real-time FBA fee estimates by ASIN (up to 20). For repricing |
| Real-time FBA fee estimate by SKU with shipping speed |
| Point-in-time FBA fees by SKU: referral, fulfillment, pick-pack |
| Monthly FBA storage fees by SKU: cost, volume, utilization |
| Long-term storage fees (365+ days) by 6-month and 12-month tiers |
Finances (3)
Tool | Description |
| Financial events by date range: sales, refunds, fees, adjustments |
| Event groups (disbursements): transfers, balances, settlement periods |
| Financial breakdown for an order: sale, fees, taxes, shipping, adjustments |
Invoices (3)
Tool | Description |
| List shipment invoices in a date range with status filters |
| Download invoice PDF (base64 if < 1MB, URL if >= 1MB) |
| Generate invoice for an FBA shipment with line items. Permanent, has tax implications |
Settlements (1)
Tool | Description |
| Amazon-generated settlement reports: sales, refunds, fees, net per transaction |
FBA Inbound (34)
Tool | Description |
| List FBA inbound plans with pagination and filters |
| Detail of a specific inbound plan |
| Create inbound plan with origin address and items |
| List shipments within an inbound plan |
| Detail of a specific inbound shipment |
| List items in an inbound plan |
| List packing options for an inbound plan |
| Generate packing options for an inbound plan |
| Confirm a packing option for an inbound plan |
| Set packing information for an inbound plan |
| List placement options for an inbound plan |
| Generate placement options for an inbound plan |
| Confirm a placement option for an inbound plan |
| Get transportation options for an inbound plan |
| Generate transportation options for an inbound plan |
| Confirm transportation options for an inbound plan |
| Get shipment details |
| List items in a shipment |
| Get item compliance details |
| List item compliance for an inbound plan |
| Create market item labels for an inbound plan |
| Get status of an async inbound operation |
| Cancel an async inbound operation |
| List delivery window options for a shipment |
| Confirm delivery window options for a shipment |
| Generate delivery window options for a shipment |
| Get box contents for an inbound plan |
| Update box contents for an inbound plan |
| Get box contents for a shipment |
| Update box contents for a shipment |
| List transportation tracking details |
| Generate transportation tracking details |
| Cancel an inbound plan |
| Cancel a shipment within an inbound plan |
Merchant Fulfillment (4)
Tool | Description |
| Available shipping services for an MFN order with rates and delivery times |
| Create MFN shipment (purchase label) with selected service |
| MFN shipment detail: tracking and label info |
| Cancel MFN shipment before label is printed |
Feedback & Reviews (4)
Tool | Description |
| Feedback insights by ASIN: rating distribution and themes. Requires Brand Registry |
| Feedback insights by category. Requires Brand Registry |
| Available solicitation actions for an order (e.g. review request) |
| Request a review from the buyer of a delivered order |
FBA Reports (4)
Tool | Description |
| FBA reimbursements for lost, damaged, or returned inventory |
| FBA customer returns: reasons, quantities, affected SKUs |
| Inventory planning: days of supply, recommended replenishments |
| Inventory movements: receipts, shipments, returns, adjustments |
Analytics Reports (3)
Tool | Description |
| Sessions, page views, conversion rate, Buy Box %, sales by ASIN |
| Brand Analytics: top search terms, frequency, click/conversion share. Requires Brand Registry |
| Flat-file report of all orders: IDs, SKUs, quantities, prices, shipping |
Brand Analytics (2)
Tool | Description |
| Products frequently purchased together. Requires Brand Registry |
| Loyalty metrics: unique vs repeat customers by search term. Requires Brand Registry |
Data Kiosk (3)
Tool | Description |
| Create a Data Kiosk query with a GraphQL document |
| Get status and result of a Data Kiosk query |
| List Data Kiosk queries with pagination and filters |
Tokens (1)
Tool | Description |
| Create RDT to access PII (shipping address, buyer info) |
Feeds (6)
Tool | Description |
| List feeds with filters by feed type, processing status, and date range |
| Get details of a specific feed by ID |
| Create a new feed for batch operations (listings, inventory, prices) |
| Cancel a feed that has not yet started processing |
| Create a feed document and get upload URL |
| Get feed document download URL and result |
Fulfillment Outbound - MCF (12)
Tool | Description |
| Get fulfillment preview for Multi-Channel Fulfillment orders |
| List all MCF fulfillment orders |
| Get details of a specific MCF fulfillment order |
| Create a new MCF fulfillment order |
| Update an existing MCF fulfillment order |
| Cancel an MCF fulfillment order |
| Get package tracking details for MCF shipments |
| List return reasons for MCF returns |
| Create a return for an MCF fulfillment order |
| List returns for MCF fulfillment orders |
| Get details of a specific MCF shipment |
| Get available MCF features and eligibility |
Notifications (8)
Tool | Description |
| List all notification subscriptions |
| Get details of a specific notification subscription |
| Create a new notification subscription |
| Update an existing notification subscription |
| Delete a notification subscription |
| List all notification destinations |
| Create a new notification destination (SQS, EventBridge) |
| Delete a notification destination |
Product Pricing v0 (6)
Tool | Description |
| Get pricing information for ASINs or SKUs |
| Get competitive pricing for ASINs or SKUs |
| Get offers for a seller's listing by SKU |
| Get offers for an item by ASIN |
| Batch get offers for multiple items by ASIN |
| Batch get offers for multiple listings by SKU |
Product Type Definitions (2)
Tool | Description |
| Search product type definitions by keywords |
| Get full definition for a product type |
Listings Restrictions (1)
Tool | Description |
| Check listing restrictions for an ASIN |
Sellers (2)
Tool | Description |
| List marketplace participations for the seller |
| Get seller account information |
A+ Content (10)
Tool | Description |
| Search A+ content documents |
| Create a new A+ content document |
| Get details of an A+ content document |
| Update an existing A+ content document |
| List ASINs associated with an A+ content document |
| Update ASIN relations for an A+ content document |
| Validate ASIN relations for an A+ content document |
| Search publish records for A+ content |
| Submit A+ content document for approval |
| Suspend a published A+ content document |
amazon-ads-mcp - Tools
110 tools for advertising management. See the full documentation.
Summary by category:
Category | Tools | Description |
Profiles | 2 | List and get advertising profiles |
Sponsored Products | 10 | Campaigns, ad groups, keywords, targets, product ads |
Sponsored Brands | 6 | Campaigns, ad groups, keywords (requires Brand Registry) |
Sponsored Display | 6 | Campaigns, ad groups, targets |
Reports | 12 | Create, check status, download and read reports (4 per family) |
Writes | 18 | Update campaigns, keywords, bids (SP: 7, SB: 7, SD: 4) |
Optimization | 5 | Keyword suggestions, performance analysis, negative keywords, ACoS |
Cross-MCP | 3 | Ads/sales correlation, TACoS, organic vs ad sales |
Negative Keywords/Targets | 30 | Read and write negative keywords/targets for SP/SB/SD |
SB Creative/Stores/Video | 9 | Stores, landing pages, media uploads (requires Brand Registry) |
Budget/Bid Recommendations | 11 | Budget and bid recommendations for SP/SB/SD campaigns |
Portfolios | 5 | List, get, create, and update advertising portfolios |
amazon-mcp-common
Shared library used by both MCP servers:
Module | Description |
| LWA OAuth 2.0 with caching and auto-refresh |
| HTTP client with |
| Token bucket rate limiting per endpoint category |
| Async report polling with automatic decompression |
| Parse tab and comma-delimited reports |
| Zod-based configuration validation |
Development
# Install dependencies
pnpm install
# Type check
pnpm typecheck
# Lint
pnpm lint
# Tests
pnpm test
# Build all packages
pnpm build
# Clean artifacts
pnpm cleanProject Structure
amazon-mcp/
├── packages/
│ ├── amazon-mcp-common/ # Shared library
│ │ └── src/
│ │ ├── auth/ # Token management
│ │ ├── client/ # HTTP client and rate limiter
│ │ ├── config/ # Zod-based configuration
│ │ ├── mcp/ # MCP utilities
│ │ └── utils/ # CSV parser, report poller
│ │
│ ├── amazon-seller-mcp/ # Seller Central MCP (118 tools)
│ │ └── src/
│ │ ├── auth/ # Credential validation and RDT
│ │ ├── client/ # SP-API client and rate limiter
│ │ ├── config/ # Package-specific configuration
│ │ └── tools/ # SP-API tools
│ │ ├── orders.ts
│ │ ├── inventory.ts
│ │ ├── sales.ts
│ │ ├── catalog.ts
│ │ ├── listings.ts
│ │ ├── pricing.ts
│ │ ├── pricing-v0.ts
│ │ ├── finances.ts
│ │ ├── invoices.ts
│ │ ├── fees.ts
│ │ ├── feedback.ts
│ │ ├── solicitations.ts
│ │ ├── fba-inbound.ts
│ │ ├── fulfillment-outbound.ts
│ │ ├── merchant-fulfillment.ts
│ │ ├── feeds.ts
│ │ ├── notifications.ts
│ │ ├── product-type-definitions.ts
│ │ ├── listings-restrictions.ts
│ │ ├── sellers.ts
│ │ ├── aplus-content.ts
│ │ ├── data-kiosk.ts
│ │ ├── tokens.ts
│ │ └── reports/ # FBA reports, settlements, analytics
│ │
│ └── amazon-ads-mcp/ # Ads API MCP (110 tools)
│ └── src/tools/
│ ├── sp/ # Sponsored Products
│ ├── sb/ # Sponsored Brands
│ ├── sd/ # Sponsored Display
│ ├── reports/ # Async reports
│ ├── writes/ # Write operations
│ ├── optimization/ # Analysis and optimization
│ ├── negative.ts # Negative keywords/targets
│ ├── sb-creative.ts # SB stores, landing pages, media
│ ├── recommendations.ts # Budget/bid recommendations
│ ├── portfolios.ts # Portfolio management
│ └── cross-mcp/ # Integration with seller-mcp
│
├── docs/
│ ├── openspec/ # Tool specifications
│ └── adr/ # Architecture decisions
└── scripts/ # Versioning and publishing scriptsRun in Development Mode
# Seller Central
cd packages/amazon-seller-mcp && pnpm dev
# Ads API
cd packages/amazon-ads-mcp && pnpm devVersioning and Publishing
# Update version
node scripts/version.js 1.1.0
# Publish to npm (dry run)
node scripts/publish.js --dry-run
# Publish to npm
node scripts/publish.jsCI/CD with GitHub Actions runs on v* tag push: tests, build, npm publish, and GitHub Release creation.
Troubleshooting
Authentication Error
Authentication failed. Please check your LWA credentials.Verify
LWA_CLIENT_IDandLWA_CLIENT_SECRETare correctConfirm the refresh token has not expired (regenerate if needed)
For Seller Central: token must have SP-API scopes
For Ads API: token must have
advertising::campaign_managementscope
Rate Limiting
Rate limited by Amazon API. Please try again later.The client automatically retries with exponential backoff. If persistent, reduce call frequency.
Brand Registry Required
Sponsored Brands API requires Brand Registry.Sponsored Brands and some Brand Analytics tools require active Brand Registry in Seller Central.
Server Won't Start
Verify environment variables are set
Run
pnpm buildbefore usingnode dist/index.jsIn development use
pnpm dev(tsx) to skip buildingCheck stderr output: the server validates credentials against Amazon before accepting connections
Common Marketplace IDs
Country | Marketplace ID |
United States |
|
Mexico |
|
Canada |
|
Spain |
|
United Kingdom |
|
Germany |
|
France |
|
Italy |
|
Japan |
|
License
MIT
Links
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jhrendon/amazon-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server