Shopee MCP server
MCP server for Shopee — LatAm marketplace Partner API v2 (orders, products, shipping, returns)
271 stars
Reviews
Write oneNobody has reviewed Shopee yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Shopee tools (22, 11 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
accept_return_offerAccept the buyer's return offer (proposed solution) for a return_sn, ending negotiation in the buyer's favor.
add_bundle_dealwrite actionCreate 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).
add_discountwrite actionCreate a new shop-level discount (promotion) with a time window. Add items/variations to it afterwards via the Shopee discount/add_discount_item endpoint.
add_itemwrite actionCreate 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.).
cancel_orderwrite actionCancel an order that has not yet shipped. Seller cancellations require a cancel_reason.
confirm_returnConfirm (accept) a buyer-initiated return request by return_sn.
delete_itemwrite actionDelete an item (product) from the shop by item_id. Irreversible — item moves to SELLER_DELETE status.
download_shipping_documentRequest 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.
get_order_detailwrite actionGet full detail for one or more orders by order_sn (comma-separated, up to 50).
get_product_detailGet detailed base info for up to 50 items by item_id.
get_return_listList return/refund requests on the shop, optionally filtered by status and time window.
get_shipment_listList orders currently in shipment (status SHIPPED or in-transit). Useful for reconciling tracking and delivery status.
get_shipping_parameterFetch 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.
get_shop_infoGet basic information about the authorized Shopee shop (shop_name, region, status, auth expiry).
get_tracking_numberGet the tracking number (and courier info when available) for a shipped order.
list_ordersList 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.
list_productsList items (products) in the shop with optional status filter. Returns item_id list which can be fed into get_product_detail.
send_chat_messagewrite actionSend 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).
ship_orderwrite actionArrange shipment for an order — either request pickup, drop off, or pass a tracking number depending on the logistics channel.
update_itemwrite actionUpdate 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).
update_product_pricewrite actionUpdate prices for an item (or its models/variants). Pass price_list entries with model_id 0 for single-SKU items.
update_product_stockwrite actionUpdate stock levels for an item (or its models/variants). Pass stock_list entries with model_id 0 for single-SKU items.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 29 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
How Shopee compares
Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 75% of 2,174 E-commerce servers
- Tools
- 22
- the typical E-commerce server has 6
- Tools that change things
- 50%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 271
- more than 95% of 1,047 E-commerce servers
What its tools let an agent do: 11 read · 3 create · 5 change · 2 delete · 1 send or post
Install Shopee in Claude Code, Cursor or VS Code
Runs npx -y @codespar/mcp-shopee on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-shopee -- npx -y @codespar/mcp-shopee
What the publisher says
From the Shopee repository's README, as published. We do not edit it. Read it on GitHub
MCP Dev LATAM 🌎 Every commerce API your AI agent needs to run a business in Latin America. Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols. MCP servers for LATAM commerce · live in the official MCP Registry · MIT License Machine-readable catalog: codespar.dev/api/servers Catalog · Quick Start · Agentic Protocols · All Servers · Contribute
The Problem
AI agents can write code, analyze data, and chat. But they can't operate a business — collect payments, issue invoices, ship products, or notify customers. Especially not in Latin America, where every service has its own API, auth pattern, and quirks (mTLS for BACEN Pix v2, JWT-RSA for STP-SPEI, AFIP web services, contract-gated developer portals, and on).
Meanwhile, four agentic payment protocols are shipping in parallel — checkout protocols (Stripe ACP, Google UCP), authorization layers (AP2), and micropayment rails (x402) — and none of them compose cleanly with each other or with the regional rails businesses actually run on.
MCP Dev LATAM bridges both gaps. Traditional LATAM services + the new agentic payment protocols, all accessible through a single MCP interface.
The Solution
Each MCP server in this repo wraps a real provider — payments, fiscal, logistics, messaging, banking, ERP, identity, fraud, crypto, and the agentic protocols — so your agent can operate a complete business workflow.
🛒 Customer places order
→ 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
→ 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
→ 📦 Agent generates shipping label (Melhor Envio / Skydropx)
→ 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
→ 📊 Agent records in ERP (Omie / Bling / Tiny)
→ 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)Six systems. Zero human intervention. One agent.
Agentic Payment Protocols
Four servers for the emerging agentic payment stack:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Shopee: common questions
- Is Shopee MCP server safe?
- Mostly: it is graded B (82/100). Read the Shopee safety report
- How do I install Shopee?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Shopee need an API key?
- Yes. The registry entry asks for
SHOPEE_PARTNER_KEY,SHOPEE_ACCESS_TOKEN. - Is Shopee maintained?
- The last commit was 67 days ago (2026-08-29). The latest release is v0.2.0-alpha.3.
- What can I use instead of Shopee?
- Servers from other publishers that do the same job: TikTok Shop MCP server, Idea Reality MCP server and WebCake Storefront MCP server. Compare all Shopee alternatives.
- How does Shopee compare with other E-commerce MCP servers?
- safety score 82/100 (higher than 75% of 2,174 E-commerce servers); tools 22 (the typical E-commerce server has 6); tools that change things 50% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Shopee
Same job from other publishers: the closest match first, then the best rated.
- TikTok ShopRead-only TikTok Shop Partner API: orders, finance, products and analytics across shops.not reviewedGrowingA
- Idea RealityPre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.not reviewedEstablishedB
- WebCake StorefrontBuild pages and manage products, orders, and content on the WebCake/StoreCake storefront builder.not reviewedGrowingA
Apiguru Amazon DataLive Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.not reviewedGrowingA- ShopwareQuery and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.not reviewedGrowingB