{"name":"io.github.codespar/mcp-shopee","slug":"codespar-mcp-shopee","title":null,"description":"MCP server for Shopee — LatAm marketplace Partner API v2 (orders, products, shipping, returns)","url":"https://mcp.market/server/codespar-mcp-shopee","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-shopee","version":"0.2.0-alpha.3","transport":{"type":"stdio"},"environmentVariables":[{"description":"Shopee Open Platform partner_id (integer) assigned when the app is registered.","isRequired":true,"format":"string","name":"SHOPEE_PARTNER_ID"},{"description":"Shopee partner_key used as the secret for HMAC-SHA256 request signing.","isRequired":true,"format":"string","isSecret":true,"name":"SHOPEE_PARTNER_KEY"},{"description":"Merchant access_token obtained via the shop authorization OAuth flow (expires every 4 hours; refresh via refresh_token).","isRequired":true,"format":"string","isSecret":true,"name":"SHOPEE_ACCESS_TOKEN"},{"description":"Shop identifier (integer) returned after merchant authorization.","isRequired":true,"format":"string","name":"SHOPEE_SHOP_ID"},{"description":"Environment: 'sandbox' uses partner.test-stable.shopeemobile.com, 'production' (default) uses partner.shopeemobile.com.","format":"string","name":"SHOPEE_ENV"}]}],"tools":[{"name":"accept_return_offer","description":"Accept the buyer's return offer (proposed solution) for a return_sn, ending negotiation in the buyer's favor.","write_action":false,"price_micros":0,"input_schema":null},{"name":"add_bundle_deal","description":"Create a bundle-deal promotion (e.g. buy-N-for-X, buy-N-get-Y%-off, fixed-price bundle). Items are attached via add_bundle_deal_item (not exposed here).","write_action":true,"price_micros":0,"input_schema":null},{"name":"add_discount","description":"Create a new shop-level discount (promotion) with a time window. Add items/variations to it afterwards via the Shopee discount/add_discount_item endpoint.","write_action":true,"price_micros":0,"input_schema":null},{"name":"add_item","description":"Create a new product (item) in the shop. Expects full item payload per Shopee /product/add_item spec (category_id, item_name, description, price+stock via model list or tier_variation, image.image_id_list, weight, logistic_info, etc.).","write_action":true,"price_micros":0,"input_schema":null},{"name":"cancel_order","description":"Cancel an order that has not yet shipped. Seller cancellations require a cancel_reason.","write_action":true,"price_micros":0,"input_schema":null},{"name":"confirm_return","description":"Confirm (accept) a buyer-initiated return request by return_sn.","write_action":false,"price_micros":0,"input_schema":null},{"name":"delete_item","description":"Delete an item (product) from the shop by item_id. Irreversible — item moves to SELLER_DELETE status.","write_action":true,"price_micros":0,"input_schema":null},{"name":"download_shipping_document","description":"Request the shipping label / air waybill PDF for one or more orders. Returns a download URL or base64 document payload depending on channel. Call create_shipping_document first if your flow requires pre-generation.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_order_detail","description":"Get full detail for one or more orders by order_sn (comma-separated, up to 50).","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_product_detail","description":"Get detailed base info for up to 50 items by item_id.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_return_list","description":"List return/refund requests on the shop, optionally filtered by status and time window.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_shipment_list","description":"List orders currently in shipment (status SHIPPED or in-transit). Useful for reconciling tracking and delivery status.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_shipping_parameter","description":"Fetch the required shipping parameters for an order before calling ship_order. Returns which of pickup / dropoff / non_integrated is expected and lists valid address_id, pickup_time_id, branch_id, slug values for the order's logistics channel.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_shop_info","description":"Get basic information about the authorized Shopee shop (shop_name, region, status, auth expiry).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_tracking_number","description":"Get the tracking number (and courier info when available) for a shipped order.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_orders","description":"List orders within a time window, optionally filtered by order_status. Time window cannot exceed 15 days. Returns order_sn list which can be fed into get_order_detail.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_products","description":"List items (products) in the shop with optional status filter. Returns item_id list which can be fed into get_product_detail.","write_action":false,"price_micros":0,"input_schema":null},{"name":"send_chat_message","description":"Send a text or sticker message to a buyer in Shopee's seller chat. Requires the buyer's user_id (obtainable from order detail's buyer_user_id).","write_action":true,"price_micros":0,"input_schema":null},{"name":"ship_order","description":"Arrange shipment for an order — either request pickup, drop off, or pass a tracking number depending on the logistics channel.","write_action":true,"price_micros":0,"input_schema":null},{"name":"update_item","description":"Update an existing product. Only the provided fields on the item_id are changed. Use update_product_stock / update_product_price for SKU stock and price — this endpoint handles descriptive fields (name, description, images, attributes, logistics).","write_action":true,"price_micros":0,"input_schema":null},{"name":"update_product_price","description":"Update prices for an item (or its models/variants). Pass price_list entries with model_id 0 for single-SKU items.","write_action":true,"price_micros":0,"input_schema":null},{"name":"update_product_stock","description":"Update stock levels for an item (or its models/variants). Pass stock_list entries with model_id 0 for single-SKU items.","write_action":true,"price_micros":0,"input_schema":null}],"scan":{"score":82,"grade":"B","scanned_at":"2026-09-26T21:19:18.513Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-26T21:19:18.443Z","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-shopee","version":"0.2.0-alpha.3","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":1,"publishedAt":"2026-06-22T18:39:39.476Z"}],"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":[]}