MCPcopy Index your code
hub / github.com/amzn/selling-partner-api-samples

github.com/amzn/selling-partner-api-samples @mcp-server-v1.0.4

Chat with this repo
repository ↗ · DeepWiki ↗ · release mcp-server-v1.0.4 ↗ · + Follow
37,138 symbols 73,970 edges 3,962 files 18,382 documented · 49% ● updated 1d agomcp-server-v1.0.4 · 2026-06-24★ 177
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Amazon Selling Partner API Samples

This repository contains sample code in various programming languages for use cases supported by the Amazon Selling Partner API (SP-API).

[!IMPORTANT]
SP-API code samples are example code that demonstrates practical implementations of SP-APIs for specific use cases and scenarios.

These sample solutions are not supported products in their own right, but educational examples to help our customers use our products for their applications. As our customer, any applications you integrate these examples into should be thoroughly tested, secured, and optimized according to your business's security standards & policies before deploying to production or handling production workloads.

Table of Contents

About this Repo

This repository contains two types of sample code: - Code Recipes: Easy to read sample code for common use cases of Amazon Selling Partner API. Recipes are written in multiple programming languages, and you can read or browse through them and copy parts of them over into your codebase. - Sample Solutions: More complex solutions to demonstrate specific use cases in more detail. You can easily deploy them in AWS to learn and explore. - Labs: Hands-on resources to help you learn and master flows and scenarios through Jupyter code samples, guided tutorials, and full workshop challenges.

We welcome contributions to this repo in the form of fixes or improvements to existing content. For more information on contributing, please see the CONTRIBUTING guide.

This is considered an intermediate learning resource, and should typically be referenced after reading the SP-API Documentation. Please see Learning Resources for additional resources.

Local MCP for SP-API

The @amazon-sp-api-release/sp-api-dev-mcp package is a local MCP (Model Context Protocol) server for SP-API that bundles multiple developer tools into a single npm package. It is published from the sp-api-dev-mcp source in the selling-partner-api-samples GitHub repository.

Installation

npm install -g @amazon-sp-api-release/sp-api-dev-mcp

Available Servers

Server Command
SP-API Dev Assistant sp-api-dev-assistant-mcp-server
SP-API Workflow Builder sp-api-workflow-mcp

Usage with npx

npx -y @amazon-sp-api-release/sp-api-dev-mcp sp-api-dev-assistant-mcp-server
npx -y @amazon-sp-api-release/sp-api-dev-mcp sp-api-workflow-mcp-server

Required secret: NPM_TOKEN — a granular npm access token with read/write permission for @amazon-sp-api-release/sp-api-dev-mcp.

Learning Resources

Security

See CONTRIBUTING for more information.

License

This library is licensed under the MIT-0 License. See the LICENSE file.

Extension points exported contracts — how you extend this code

ProgressListener (Interface)
(no doc) [30 implementers]
use-cases/data-kiosk/code/java/src/main/java/io/swagger/client/ProgressResponseBody.java
ProgressListener (Interface)
(no doc) [30 implementers]
use-cases/merchant-fulfillment/code/java/src/main/java/io/swagger/client/ProgressResponseBody.java
DetectionStrategy (Interface)
(no doc) [18 implementers]
use-cases/sp-api-dev-mcp/sp-api-dev-assistant-mcp-server/src/tools/optimization-tools/types.ts
ProgressListener (Interface)
(no doc) [30 implementers]
use-cases/error-monitoring/code/java/src/main/java/io/swagger/client/ProgressResponseBody.java
ProgressListener (Interface)
(no doc) [30 implementers]
use-cases/pricing-b2b/code/java/src/main/java/io/swagger/client/ProgressResponseBody.java
ApiCredentialsProvider (Interface)
(no doc) [51 implementers]
use-cases/easy-ship/code/php/lambda/utils/interfaces/ApiCredentialsProvider.php
ProgressListener (Interface)
(no doc) [30 implementers]
use-cases/lwa-rotation/code/java/src/main/java/io/swagger/client/ProgressResponseBody.java
ProgressListener (Interface)
(no doc) [30 implementers]
use-cases/fulfillment-outbound/code/java/src/main/java/io/swagger/client/ProgressResponseBody.java

Core symbols most depended-on inside this repo

items
called by 1371
use-cases/shipping-v2/code/python/src/api_models/shipping_api/swagger_client/models/package.py
get
called by 1290
use-cases/sp-api-dev-mcp/sp-api-workflow-mcp/src/builder/workflow-store.js
body
called by 727
use-cases/pricing/code/java/src/main/java/io/swagger/client/model/pricing/ItemOffersResponse.java
info
called by 591
use-cases/sp-api-dev-mcp/sp-api-dev-assistant-mcp-server/src/utils/logger.ts
log
called by 516
use-cases/sp-api-dev-mcp/sp-api-dev-assistant-mcp-server/src/utils/logger.ts
format
called by 353
use-cases/shipping-v2/code/python/src/api_models/shipping_api/swagger_client/models/package_document.py
onUploadProgress
called by 326
use-cases/fulfillment-inbound/Small_Parcel_Delivery_with_Non_Partnered_Carrier/code/java/src/main/java/io/swagger/client/ApiCallback.java
onDownloadProgress
called by 326
use-cases/fulfillment-inbound/Small_Parcel_Delivery_with_Non_Partnered_Carrier/code/java/src/main/java/io/swagger/client/ApiCallback.java

Shape

Method 31,668
Class 3,925
Function 968
Enum 280
Interface 259
Route 38

Languages

Java68%
Python20%
TypeScript7%
C#4%
PHP1%

Modules by API surface

use-cases/fulfillment-inbound/Small_Parcel_Delivery_with_Non_Partnered_Carrier/code/java/src/main/java/io/swagger/client/api/fbav2024/FbaInboundApi.java230 symbols
use-cases/fulfillment-inbound/Small_Parcel_Delivery_with_Amazon_Partnered_Carrier/code/java/src/main/java/io/swagger/client/api/fbav2024/FbaInboundApi.java230 symbols
use-cases/fulfillment-inbound/Pack_Later_Flow_Carton_Unknown/code/java/src/main/java/io/swagger/client/api/fbav2024/FbaInboundApi.java230 symbols
use-cases/merchant-fulfillment/code/java/src/main/java/io/swagger/client/model/orders/Order.java186 symbols
use-cases/easy-ship/code/java/src/main/java/io/swagger/client/model/orders/Order.java186 symbols
use-cases/easy-ship/code/java/src/main/java/io/swagger/client/model/orders/OrderItem.java132 symbols
use-cases/merchant-fulfillment/code/java/src/main/java/io/swagger/client/model/orders/OrderItem.java129 symbols
use-cases/fulfillment-inbound/Small_Parcel_Delivery_with_Non_Partnered_Carrier/code/java/src/main/java/io/swagger/client/api/fbav0/FbaInboundApi.java95 symbols
use-cases/fulfillment-inbound/Small_Parcel_Delivery_with_Amazon_Partnered_Carrier/code/java/src/main/java/io/swagger/client/api/fbav0/FbaInboundApi.java95 symbols
use-cases/fulfillment-inbound/Pack_Later_Flow_Carton_Unknown/code/java/src/main/java/io/swagger/client/api/fbav0/FbaInboundApi.java95 symbols
use-cases/fulfillment-outbound/code/java/src/main/java/io/swagger/client/api/FbaOutboundApi.java80 symbols
use-cases/solicitations/code/csharp/src/sp-api-csharp-app/swagger_client/api/NotificationsApi.cs75 symbols

For agents

$ claude mcp add selling-partner-api-samples \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page