Spree Commerce: open-source B2B and marketplace ecommerce
Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
Descripción del creador (original en inglés)
MCP server for Amazon Selling Partner API (SP-API) — orders, listings, catalog, inventory, finances
Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.
Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.
Elige la app de IA que usas y copia la configuración.
AMAZON_LWA_CLIENT_ID, AMAZON_LWA_CLIENT_SECRET, AMAZON_REFRESH_TOKEN, AMAZON_MARKETPLACE_ID, AMAZON_REGION, AMAZON_SELLER_IDLos valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.
Necesitas
¿Qué app usas?
Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.
Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json
{
"mcpServers": {
"amazon": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-amazon"
],
"env": {
"AMAZON_LWA_CLIENT_ID": "your-value",
"AMAZON_LWA_CLIENT_SECRET": "your-value",
"AMAZON_REFRESH_TOKEN": "your-value",
"AMAZON_MARKETPLACE_ID": "your-value",
"AMAZON_REGION": "your-value",
"AMAZON_SELLER_ID": "your-value"
}
}
}
}Ejecuta esto en tu terminal
claude mcp add amazon --env AMAZON_LWA_CLIENT_ID=your-value --env AMAZON_LWA_CLIENT_SECRET=your-value --env AMAZON_REFRESH_TOKEN=your-value --env AMAZON_MARKETPLACE_ID=your-value --env AMAZON_REGION=your-value --env AMAZON_SELLER_ID=your-value -- npx -y @codespar/mcp-amazonCompleta los valores vacíos antes de ejecutarlo.
Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json
{
"mcpServers": {
"amazon": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-amazon"
],
"env": {
"AMAZON_LWA_CLIENT_ID": "your-value",
"AMAZON_LWA_CLIENT_SECRET": "your-value",
"AMAZON_REFRESH_TOKEN": "your-value",
"AMAZON_MARKETPLACE_ID": "your-value",
"AMAZON_REGION": "your-value",
"AMAZON_SELLER_ID": "your-value"
}
}
}
}Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.
Pégalo en .vscode/mcp.json de tu proyecto
{
"servers": {
"amazon": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-amazon"
],
"env": {
"AMAZON_LWA_CLIENT_ID": "your-value",
"AMAZON_LWA_CLIENT_SECRET": "your-value",
"AMAZON_REFRESH_TOKEN": "your-value",
"AMAZON_MARKETPLACE_ID": "your-value",
"AMAZON_REGION": "your-value",
"AMAZON_SELLER_ID": "your-value"
}
}
}
}Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.
Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.
Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.
AMAZON_REGION envAMAZON_SELLER_ID envEsta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 8 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub codespar, dueña del repo
Todavía no hemos leído este repo en GitHub
Todavía no hemos leído este repo en GitHub
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: AMAZON_LWA_CLIENT_ID, AMAZON_LWA_CLIENT_SECRET, AMAZON_REFRESH_TOKEN, AMAZON_MARKETPLACE_ID
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez –, y la última versión (0.2.0-alpha.3) llegó al registro hace 5 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
MCP server integrating with Stripe - tools for customers, products, payments, and more.
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
MCP server for the Amazon Selling Partner API (SP-API) — the biggest global marketplace, including Amazon BR, Amazon MX, Amazon US, and all EU/FE marketplaces.
For LatAm sellers, Amazon rounds out the marketplace trio already in this catalog:
@codespar/mcp-mercadolibre) — dominant in LatAm generally (BR, AR, MX, CO, CL).@codespar/mcp-shopee) — heavy in Brazil and rapidly growing regionally.Together these three cover essentially every marketplace where a LatAm merchant transacts meaningful GMV.
| Tool | Purpose |
|---|---|
list_orders | List orders from Amazon SP-API. |
get_order | Get one order by AmazonOrderId (e.g. |
get_order_items | Get the line items for an order by AmazonOrderId. |
get_listings_item | Get a single listing item for the seller by SKU. |
put_listings_item | Create or fully replace a listing item for the seller by SKU. |
delete_listings_item | Delete a listing item for the seller by SKU. |
search_catalog_items | Search the Amazon catalog for reference product data (ASIN, title, brand, images) by identifiers or keywords. |
get_inventory_summary | Get FBA inventory summaries (fulfillable, inbound, reserved, researching, unfulfillable quantities) for the... |
create_report | Request an SP-API report. |
get_report | Get a report's status and (when DONE) its reportDocumentId, which can then be fetched from the Reports docu... |
list_financial_events | List financial events (shipment, refund, service fee, adjustment, etc.) for reconciliation. |
get_order_shipment_status | Get shipment status for a shipment id via the Shipping API (Amazon Shipping / Buy Shipping labels). |
create_subscription | Create a Notifications API subscription for a given notificationType (webhook-equivalent for SP-API events,... |
patch_listings_item | Partially update a listing item for the seller by SKU using a JSON Patch list of operations. |
confirm_shipment | Confirm shipment of an order's items (Orders API v0). |
update_shipment_status | Update the shipment status of an order (Orders API v0). |
list_reports | List reports the seller has requested. |
cancel_report | Cancel a report that is IN_QUEUE and has not yet started processing. |
create_feed | Submit a feed to SP-API (e.g. |
get_feed | Get a feed's status and (when DONE) its resultFeedDocumentId — fetch the result from the Feed Document API... |
list_financial_events_by_order | List financial events scoped to a single order (shipment, refund, service fee, adjustment). |
get_my_fees_estimate_for_asin | Estimate referral fee + FBA fees for selling an ASIN at a given price. |
list_subscriptions | Get the current subscription for a notificationType (one subscription per notificationType per app). |
get_marketplace_participations | List all marketplaces the seller is registered to sell in (Sellers API). |
npm install @codespar/mcp-amazon@alpha
AMAZON_LWA_CLIENT_ID="amzn1.application-oa2-client....."
AMAZON_LWA_CLIENT_SECRET="..." AMAZON_REFRESH_TOKEN="Atzr|..." # long-lived, seller-authorized AMAZON_MARKETPLACE_ID="A2Q3Y263D00KWC" # BR; ATVPDKIKX0DER=US, A1AM78C64UM0Y8=MX AMAZON_REGION="na" # na | eu | fe (default na) AMAZON_SELLER_ID="A3..." # optional; default for Listings tools
| Marketplace | Id | Region |
|---|---|---|
| Brazil | A2Q3Y263D00KWC | na |
| United States | ATVPDKIKX0DER | na |
| Mexico | A1AM78C64UM0Y8 | na |
| Canada | A2EUQ1WTGCTBG2 | na |
| Spain | A1RKKUPIHCS9HS | eu |
| United Kingdom | A1F83G8C2ARO7P | eu |
| Germany | A1PA6795UKMFR9 | eu |
| Japan | A1VC38T7YXB528 | fe |
SP-API uses a dual-step Login with Amazon (LWA) flow:
https://api.amazon.com/auth/o2/token with grant_type=refresh_token and your client_id / client_secret / refresh_token. The result is cached in memory until ~1 minute before expiry.x-amz-access-token: plus Content-Type: application/json.AWS Signature v4 request signing was the historical requirement for SP-API. Amazon removed the SigV4 requirement in 2023 for most tenants, so this server uses LWA-only auth. If your seller is still flagged as requiring SigV4, you will need to wrap amazonRequest with a signer (@aws-sdk/signature-v4) — not included here.
https://sellingpartnerapi-na.amazon.comhttps://sellingpartnerapi-eu.amazon.comhttps://sellingpartnerapi-fe.amazon.comSelect with AMAZON_REGION. Brazil and the Americas use na.
# stdio (default — Claude Desktop, Cursor, etc)
npx @codespar/mcp-amazon
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-amazon
create_subscription is webhook-equivalent for SP-API. Amazon does not push HTTP webhooks directly — instead, you create a destination (SQS queue or EventBridge bus) via POST /notifications/v1/destinations first, then attach subscriptions to that destination. This package covers subscription creation; destination provisioning is a one-time setup typically done via the AWS Console or a deploy script.
0.1.0-alpha.1 — SP-API has 30+ product sections and this package covers the commerce-relevant subset (orders, listings, catalog, inventory, reports, finances, shipping, notifications). Endpoint paths and auth flow are implemented to the published spec; tool contracts should be integration-tested against real seller tokens before production use. The LWA refresh flow and x-amz-access-token header usage are confirmed against current SP-API docs.
Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
MIT