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.
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.
The @amazon-sp-api-release/sp-api-dev-mcp package is a consolidated MCP (Model Context Protocol) server that bundles multiple SP-API MCP servers into a single npm package.
npm install -g @amazon-sp-api-release/sp-api-dev-mcp| Server | Command |
|---|---|
| SP-API Dev Assistant | sp-api-dev-assistant-mcp-server |
| SP-API Workflow Builder | sp-api-workflow-mcp |
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-serverReleases are published automatically via the Consolidate MCP Servers GitHub Actions workflow. To trigger a release:
- Go to Actions → Consolidate MCP Servers → Run workflow
- Enter the new version number (e.g.
1.0.0) - The workflow will build, bundle, publish to npm, and create a GitHub release
Required secret: NPM_TOKEN — a granular npm access token with read/write permission for @amazon-sp-api-release/sp-api-dev-mcp.
See CONTRIBUTING for more information.
This library is licensed under the MIT-0 License. See the LICENSE file.