{"name":"io.github.codespar/mcp-amazon","slug":"codespar-mcp-amazon","title":null,"description":"MCP server for Amazon Selling Partner API (SP-API) — orders, listings, catalog, inventory, finances","url":"https://mcp.market/server/codespar-mcp-amazon","rating":null,"grade":"B","score":82,"certified":false,"status":"active","category":"ecommerce","tags":["ecommerce"],"presence":{"score":38,"stars":271,"forks":50,"downloads_week":null,"last_push_at":"2026-08-29T02:02:48.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/codespar/mcp-dev-latam","website":null,"version":"0.2.0-alpha.3","remotes":[],"packages":[{"registryType":"npm","identifier":"@codespar/mcp-amazon","version":"0.2.0-alpha.3","transport":{"type":"stdio"},"environmentVariables":[{"description":"Login with Amazon (LWA) client_id from Seller Central > Developer Central (SP-API app).","isRequired":true,"format":"string","name":"AMAZON_LWA_CLIENT_ID"},{"description":"LWA client_secret paired with AMAZON_LWA_CLIENT_ID.","isRequired":true,"format":"string","isSecret":true,"name":"AMAZON_LWA_CLIENT_SECRET"},{"description":"Long-lived seller-authorized refresh_token exchanged for 1-hour LWA access tokens used as x-amz-access-token.","isRequired":true,"format":"string","isSecret":true,"name":"AMAZON_REFRESH_TOKEN"},{"description":"Default marketplace id. BR: A2Q3Y263D00KWC, US: ATVPDKIKX0DER, MX: A1AM78C64UM0Y8, CA: A2EUQ1WTGCTBG2. Required by most endpoints; can be overridden per-call.","isRequired":true,"format":"string","name":"AMAZON_MARKETPLACE_ID"},{"description":"SP-API region: 'na' (default — Americas, incl. BR/US/MX/CA), 'eu' (Europe + India + MENA), 'fe' (Far East — JP/AU/SG).","format":"string","name":"AMAZON_REGION"},{"description":"Default sellerId (merchant token) used by Listings endpoints. Can be overridden per-call.","format":"string","name":"AMAZON_SELLER_ID"}]}],"tools":[{"name":"cancel_report","description":"Cancel a report that is IN_QUEUE and has not yet started processing. Reports that are IN_PROGRESS or DONE cannot be cancelled.","write_action":true,"price_micros":0,"input_schema":null},{"name":"confirm_shipment","description":"Confirm shipment of an order's items (Orders API v0). Required for MFN sellers to mark items as shipped and trigger customer notification + charge.","write_action":false,"price_micros":0,"input_schema":null},{"name":"create_feed","description":"Submit a feed to SP-API (e.g. POST_PRODUCT_DATA, POST_INVENTORY_AVAILABILITY_DATA, JSON_LISTINGS_FEED). Feed contents must first be uploaded via the Feed Document API to get an inputFeedDocumentId.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_report","description":"Request an SP-API report. Report is generated asynchronously — poll with get_report until processingStatus is DONE, then fetch the reportDocumentId.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_subscription","description":"Create a Notifications API subscription for a given notificationType (webhook-equivalent for SP-API events, delivered via SQS or EventBridge destination).","write_action":true,"price_micros":0,"input_schema":null},{"name":"delete_listings_item","description":"Delete a listing item for the seller by SKU.","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_feed","description":"Get a feed's status and (when DONE) its resultFeedDocumentId — fetch the result from the Feed Document API for processing details.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_inventory_summary","description":"Get FBA inventory summaries (fulfillable, inbound, reserved, researching, unfulfillable quantities) for the seller's SKUs.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_listings_item","description":"Get a single listing item for the seller by SKU.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_marketplace_participations","description":"List all marketplaces the seller is registered to sell in (Sellers API). Returns marketplace ids, names, default currency/language, and participation status. Use this to discover which marketplaces the authorized seller can transact in.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_my_fees_estimate_for_asin","description":"Estimate referral fee + FBA fees for selling an ASIN at a given price. Useful before creating a listing or when repricing.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_order","description":"Get one order by AmazonOrderId (e.g. '902-3159896-1390916').","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_order_items","description":"Get the line items for an order by AmazonOrderId. Returns ASIN, SellerSKU, quantity, item price, taxes, promotions.","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_order_shipment_status","description":"Get shipment status for a shipment id via the Shipping API (Amazon Shipping / Buy Shipping labels).","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_report","description":"Get a report's status and (when DONE) its reportDocumentId, which can then be fetched from the Reports document API.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_financial_events","description":"List financial events (shipment, refund, service fee, adjustment, etc.) for reconciliation. Filter by posted-time window or by AmazonOrderId.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_financial_events_by_order","description":"List financial events scoped to a single order (shipment, refund, service fee, adjustment). Cleaner than list_financial_events when reconciling one order.","write_action":true,"price_micros":0,"input_schema":null},{"name":"list_orders","description":"List orders from Amazon SP-API. Filters by marketplace, creation/update time, order status, fulfillment channel, etc. Returns a page of orders plus NextToken for pagination.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_reports","description":"List reports the seller has requested. Filter by reportTypes, processingStatuses, and created-time window.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_subscriptions","description":"Get the current subscription for a notificationType (one subscription per notificationType per app). Use to check whether a subscription already exists before creating one.","write_action":false,"price_micros":0,"input_schema":null},{"name":"patch_listings_item","description":"Partially update a listing item for the seller by SKU using a JSON Patch list of operations. Use this to change specific attributes without replacing the full listing.","write_action":true,"price_micros":0,"input_schema":null},{"name":"put_listings_item","description":"Create or fully replace a listing item for the seller by SKU. Body must be a Listings Items submission (productType + attributes).","write_action":true,"price_micros":0,"input_schema":null},{"name":"search_catalog_items","description":"Search the Amazon catalog for reference product data (ASIN, title, brand, images) by identifiers or keywords. Use this to map merchant SKUs to ASINs before creating listings.","write_action":false,"price_micros":0,"input_schema":null},{"name":"update_shipment_status","description":"Update the shipment status of an order (Orders API v0). Used to mark MFN orders as ReadyForPickup, PickedUp, or RefusedPickup.","write_action":true,"price_micros":0,"input_schema":null}],"scan":{"score":82,"grade":"B","scanned_at":"2026-09-26T21:19:18.889Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-26T21:19:18.771Z","components":{"code":{"score":25,"max":25,"notes":["5 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 29 days ago"]},"identity":{"score":7,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"@codespar/mcp-amazon","version":"0.2.0-alpha.3","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":1,"publishedAt":"2026-06-22T18:39:23.850Z"}],"repo":{"found":true,"owner":"codespar","repo":"mcp-dev-latam","archived":false,"pushedAt":"2026-08-29T02:02:48Z","stars":271,"forks":50,"openIssues":10,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/269058982?v=4","ownerCreatedAt":"2026-03-18T00:40:56Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/269058982?v=4&s=128","source":"github"},"presence":{"stars":271,"forks":50,"downloadsWeek":null,"license":"MIT","lastPushAt":"2026-08-29T02:02:48.000Z","score":38}}}},"grade_history":[],"reviews":[]}