Now Available: Local MCP for SP-API — AI-powered Selling Partner API development 🚀📦

[Tong8s]

AI coding assistants are transforming how developers build SP-API integrations. The Model Context Protocol (MCP) takes this further — it's an open standard that connects AI assistants to external tools and knowledge sources, enabling them to act on real data rather than relying solely on training knowledge. Local MCP for SP-API brings this to the SP-API ecosystem as a consolidated npm package bundling MCP servers for Amazon Selling Partner API development. Configure it in your MCP-compatible IDE, and your AI assistant is equipped with authoritative SP-API knowledge, actionable developer tools for code generation, optimization, and migration, and a workflow engine to build and execute multi-step API operations.

Authored by: Tong S. Solutions Architect, Selling Partner Developer Services

📺 Demo

Make sure to watch the following video on YouTube, which demonstrates the capabilities of the tool.

https://www.youtube.com/watch?v=9gJ0rXRAwfk

🧰 What's Included

Local MCP for SP-API ships two MCP servers in a single package — each can be used independently or together:

• 📦 npm: @amazon-sp-api-release/sp-api-dev-mcp
• 🔗 GitHub: sp-api-dev-mcp

---

1. sp-api-dev-assistant-mcp-server

Your AI-powered development companion for SP-API integration. This server equips your AI coding assistant with ground-truth SP-API knowledge and actionable developer tools — enabling natural language search over official documentation, SDK-based code generation in 5 languages, automated code optimization against 10 app quality pillars, and guided API version migrations.

Tool	Description
sp_api_reference	Search official SP-API documentation using natural language
sp_api_explore_catalog	Browse SP-API endpoint catalog (parameters, schemas, examples)
sp_api_execute	Execute live SP-API requests with auth and signing
sp_api_generate_code_sample	Generate code samples (Python, Java, JavaScript, C#, PHP)
sp_api_migration_assistant	Migrate between API versions (e.g., Orders v0 → v2026-01-01)
sp_api_optimize	Well-architected review of SP-API integration code

All tools run locally with no credentials required, except sp_api_execute, which needs SP-API credentials to make live API calls.

---

2. sp-api-workflow-mcp-server

Extends the local MCP for SP-API by enabling developers to build and execute multi-step SP-API workflows using natural language. Developers describe what they want; the AI discovers the right SP-API endpoints, builds the workflow step-by-step using an Amazon State Language based engine with Task, Choice, Wait, Pass, Succeed, and Fail states, and executes it deterministically with OAuth token management when ready.

Category	Capabilities
Builder	Create workflows, add task/fetch/choice/succeed/fail/wait/pass/input states, validate and manage workflows
Interpreter	Execute workflows, check status, list executions, abort/resume, tail events
Callback	List pending callbacks, get details, submit responses, extend timeouts

SP-API credentials are required for workflows that make live API calls.

🚀 Getting Started

Prerequisites: Node.js >= 20

Add the servers to your MCP client configuration (Claude Desktop, Kiro, Cursor, VS Code, etc.):

{
  "mcpServers": {
    "sp-api-dev-assistant": {
      "command": "npx",
      "args": ["-y", "@amazon-sp-api-release/sp-api-dev-mcp", "sp-api-dev-assistant-mcp-server"],
      "env": {
        "SP_API_CLIENT_ID": "your-client-id",
        "SP_API_CLIENT_SECRET": "your-client-secret",
        "SP_API_REFRESH_TOKEN": "your-refresh-token"
      }
    },
    "sp-api-workflow": {
      "command": "npx",
      "args": ["-y", "@amazon-sp-api-release/sp-api-dev-mcp", "sp-api-workflow-mcp-server"],
      "env": {
        "SP_API_CLIENT_ID": "your-client-id",
        "SP_API_CLIENT_SECRET": "your-client-secret",
        "SP_API_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Check our getting started video on Youtube: AI-Powered SP-API Development: Getting Started with Local MCP

💡 Use Cases

1. New Integration Q&A

Use sp_api_reference to discover endpoints, then sp_api_generate_code_sample to get exact SDK method signatures in your language of choice.

Example Prompts:

• "What SP-API endpoints are available for managing product listings?"
• "Generate a Python code sample to create a new product listing using the Listings Items API"

2. Code Review & Optimization

Run sp_api_optimize on your existing code to get severity-rated findings across 9 pillars (Scheduling, Error Handling, Rate Limiting, Batching, Pagination, Notifications, Reports, Caching, API Modernness).

Example Prompts:

• "Review my Orders API polling code and suggest optimizations"
• "Analyze my integration code for rate limiting best practices and caching opportunities"

3. API Migration

Use sp_api_migration_assistant for attribute-by-attribute mapping when upgrading API versions, with breaking change identification and refactored code.

Example Prompts:

• "Migrate my Orders API integration from v0 to v2026-01-01"
• "What are the breaking changes between Catalog Items API v0 and v2022-04-01?"

4. Workflow Automation

Chain multiple SP-API operations into automated ASL-format workflows using natural language with the workflow builder.

Example Prompts:

• "Build a workflow that checks inventory levels and automatically creates a replenishment shipment when stock drops below threshold"
• "Create a multi-step workflow: fetch new orders, update shipment status, then send shipping notifications"

📚 Related Resources

• 🐙 SP-API Dev MCP on GitHub
• 📦 @amazon-sp-api-release/sp-api-dev-mcp on npm
• 📖 SP-API Developer Documentation
• 🔌Model Context Protocol

---

Keywords: SP-API, MCP, ModelContextProtocol, AI-coding, developer-tools, workflow-automation

Last Updated: May 2026

Please note the publication date above. While we strive to keep our content current, the rapid evolution of this topic means some details may have changed since publication. For the most up-to-date information, we encourage readers to follow the announcements in SP-API developer documentation.