Skip to content

amzn/selling-partner-api-samples

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.