MCP.Market

Shopee MCP server

by codespar·io.github.codespar/mcp-shopee·v0.2.0-alpha.3·271 stars

MCP server for Shopee — LatAm marketplace Partner API v2 (orders, products, shipping, returns)

B82/100grade B
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
Growing

271 stars

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • accept_return_offer

    Accept the buyer's return offer (proposed solution) for a return_sn, ending negotiation in the buyer's favor.

  • add_bundle_dealwrite action

    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).

  • add_discountwrite action

    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.

  • add_itemwrite action

    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.).

  • cancel_orderwrite action

    Cancel an order that has not yet shipped. Seller cancellations require a cancel_reason.

  • confirm_return

    Confirm (accept) a buyer-initiated return request by return_sn.

  • delete_itemwrite action

    Delete an item (product) from the shop by item_id. Irreversible — item moves to SELLER_DELETE status.

  • download_shipping_document

    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.

  • get_order_detailwrite action

    Get full detail for one or more orders by order_sn (comma-separated, up to 50).

  • get_product_detail

    Get detailed base info for up to 50 items by item_id.

  • get_return_list

    List return/refund requests on the shop, optionally filtered by status and time window.

  • get_shipment_list

    List orders currently in shipment (status SHIPPED or in-transit). Useful for reconciling tracking and delivery status.

  • get_shipping_parameter

    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.

  • get_shop_info

    Get basic information about the authorized Shopee shop (shop_name, region, status, auth expiry).

  • get_tracking_number

    Get the tracking number (and courier info when available) for a shipped order.

  • list_orders

    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.

  • list_products

    List items (products) in the shop with optional status filter. Returns item_id list which can be fed into get_product_detail.

  • send_chat_messagewrite action

    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).

  • ship_orderwrite action

    Arrange shipment for an order — either request pickup, drop off, or pass a tracking number depending on the logistics channel.

  • update_itemwrite action

    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).

  • update_product_pricewrite action

    Update prices for an item (or its models/variants). Pass price_list entries with model_id 0 for single-SKU items.

  • update_product_stockwrite action

    Update 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

no findings
  • 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
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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.

All Shopee alternatives →
  • TikTok Shop
    Read-only TikTok Shop Partner API: orders, finance, products and analytics across shops.
    A
  • Idea Reality
    Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.
    B
  • WebCake Storefront
    Build pages and manage products, orders, and content on the WebCake/StoreCake storefront builder.
    A
  • Apiguru Amazon Data
    Live Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.
    A
  • Shopware
    Query and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.
    B

More from codespar →