sellabot-mcp
Provides tools for marketplace seller operations on Shopee, including products, pricing, inventory, customer service, orders, returns, cancellations, disputes, promotions, and shop info.
Planned integration for TikTok Shop, following the same adapter pattern as Shopee to expose seller operations as tools.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sellabot-mcp Show me my top 10 best-selling products this month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
sellabot-mcp
An MCP server that exposes marketplace seller operations as tools Claude can call. Shopee first, designed to expand to Lazada and TikTok Shop via the same adapter contract.
Claude is the interface; sellabot-mcp is the automation layer. See CLAUDE.md for the full design.
What it can do
32 tools across products, pricing, inventory, customer service, orders & fulfillment, returns/cancellations/disputes, promotions, and shop info. The scope rule: anything a seller can do through the marketplace API that doesn't require physically moving goods.
Crucial actions (refunds, cancellations, disputes, booking shipments) are human-gated — the server previews the exact effect and waits for the seller's explicit approval before executing (see CLAUDE.md §3).
Related MCP server: MCP Shopline
Setup
npm install
cp .env.example .env # fill in SHOPEE_PARTNER_ID/KEY and a TOKEN_ENCRYPTION_KEY
npm run authorize # one-time: opens the Shopee OAuth flow, stores tokens
npm run buildnpm run authorize prints an authorization URL; approve it in the browser, and the local callback captures the code, exchanges it for tokens (stored encrypted), and prints the SHOPEE_SHOP_ID to add to .env.
Run
npm start # serves over stdio
npm run dev # watch mode (tsx)Set READ_ONLY=true to expose only the get_* tools — safe for testing against a live shop.
Connect to Claude
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"sellabot": {
"command": "node",
"args": ["C:\\Users\\Rexton\\sellabot_mcp\\dist\\index.js"],
"env": { "SHOPEE_PARTNER_ID": "…", "SHOPEE_PARTNER_KEY": "…", "SHOPEE_REGION": "MY", "SHOPEE_ENV": "production", "SHOPEE_SHOP_ID": "…", "TOKEN_ENCRYPTION_KEY": "…" }
}
}
}Claude Code:
claude mcp add sellabot -- node C:\Users\Rexton\sellabot_mcp\dist\index.jsDevelop
npm run typecheck # type-check src + scripts
npm test # signing golden-vector testsProject layout
src/
index.ts entry (stdio)
server.ts wiring + MCP elicitation bridge
config.ts env validation (Zod)
core/ models, errors, http, token-store, consent, audit, platform, registry
platforms/shopee/ sign, auth, client, mappers, adapter (the only Shopee-aware code)
tools/ platform-agnostic tool definitions
scripts/authorize.ts one-time OAuth flowAdding a platform = implement Platform in src/platforms/<name>/ and register it. No tool changes.
Available Tools
32 toolsarrange_shipmentArrange shipmentADestructive
Book courier pickup or drop-off for an order. This is the digital step — the seller still physically hands over the parcel.
[CRITICAL] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: method (required), order_id (required), platform, pickup_time, +1 more.
boost_listingBoost listingA
Boost/feature a listing where the platform supports it.
[SENSITIVE] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: product_id (required), platform, duration_hours, confirmation_token.
bulk_update_priceBulk update pricesA
Set prices for many products/variants in one call.
[SENSITIVE] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: updates (required), platform, confirmation_token.
create_listingCreate listingA
Create a new product listing in the shop.
[SENSITIVE] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: name (required), price (required), stock (required), images (required), +6 more.
create_voucherCreate voucherA
Create a shop or product voucher.
[SENSITIVE] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: name (required), end_at (required), start_at (required), discount_type (required), +9 more.
delete_listingDelete listingA
Remove a product. Defaults to unlisting (reversible) rather than permanent deletion.
[SENSITIVE] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: product_id (required), mode, platform, confirmation_token.
get_cancellationsGet cancellationsBRead-only
List buyer-initiated cancellation requests.
Inputs: limit, cursor, status, platform.
get_disputesGet disputesARead-only
List disputes/complaints/escalations needing seller input.
Inputs: limit, cursor, status, platform.
get_low_stock_itemsGet low-stock itemsARead-only
List items at or below a stock threshold (default 5).
Inputs: limit, cursor, platform, threshold.
get_messagesGet messagesARead-only
List buyer conversations, optionally only unread ones.
Inputs: limit, cursor, status, platform.
get_orderGet orderARead-only
Full detail for one order: line items, buyer, ship-to address, totals, and status.
Inputs: order_id (required), platform.
get_ordersGet ordersBRead-only
List orders, optionally filtered by fulfillment status.
Inputs: limit, since, cursor, status, +1 more.
get_priceGet priceCRead-only
Get the current price of a product and each of its variants.
Inputs: product_id (required), platform.
get_productsGet productsBRead-only
List or search products in the shop, optionally filtered by status.
Inputs: limit, query, cursor, status, +1 more.
get_returnGet returnARead-only
Full detail of one return/refund request: reason, evidence, amount, buyer.
Inputs: return_id (required), platform.
get_returnsGet returnsBRead-only
List buyer return/refund requests.
Inputs: limit, cursor, status, platform.
get_reviewsGet reviewsBRead-only
List product reviews/ratings, optionally filtered by product, rating, or reply state.
Inputs: limit, cursor, rating, replied, +2 more.
get_shipping_documentGet shipping documentA
Generate/fetch the shipping label (airway bill) for a confirmed shipment.
[ROUTINE] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: order_id (required), format, platform, confirmation_token.
get_shipping_infoGet shipping infoBRead-only
Shipping requirements for an order: carrier, pickup/drop-off, ship-by deadline, parcel specs, pickup address.
Inputs: order_id (required), platform.
get_shop_infoGet shop infoBRead-only
Shop profile, region, status, and auth health.
Inputs: platform.
get_shop_performanceGet shop performanceCRead-only
Shop KPIs: sales, orders, rating, response rate, penalties.
Inputs: period, metrics, platform.
get_stockGet stockBRead-only
Get current stock for a product and each of its variants.
Inputs: product_id (required), platform.
get_vouchersGet vouchersARead-only
List shop vouchers/discounts, optionally filtered by status.
Inputs: limit, cursor, status, platform.
reply_to_messageReply to messageA
Send a reply in a buyer conversation.
[ROUTINE] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: text (required), conversation_id (required), platform, attachments, +1 more.
reply_to_reviewReply to reviewB
Post a public seller reply to a product review.
[ROUTINE] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: text (required), review_id (required), platform, confirmation_token.
respond_to_cancellationRespond to cancellationADestructive
Accept or reject a buyer's cancellation request. Always requires the seller's explicit approval.
[CRITICAL] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: decision (required), cancellation_id (required), reason, platform, +1 more.
respond_to_disputeRespond to disputeBDestructive
Submit the seller's response/evidence to a dispute or complaint. Always requires the seller's explicit approval.
[CRITICAL] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: message (required), dispute_id (required), evidence, platform, +2 more.
respond_to_returnRespond to returnADestructive
Accept or reject a return/refund request (optionally a partial amount). Always requires the seller's explicit approval.
[CRITICAL] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: decision (required), return_id (required), reason, currency, +3 more.
track_shipmentTrack shipmentCRead-only
Current tracking status and checkpoints for a shipped order.
Inputs: order_id, platform, tracking_number.
update_listingUpdate listingA
Edit an existing listing's content (name, description, images, etc.).
[SENSITIVE] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: product_id (required), name, images, platform, +4 more.
update_priceUpdate priceA
Set the price for one product or a specific variant.
[SENSITIVE] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: price (required), product_id (required), currency, platform, +2 more.
update_stockUpdate stockA
Set the stock quantity for one product or a specific variant.
[ROUTINE] This action changes live shop data and requires the seller's explicit confirmation before it executes.
Inputs: stock (required), product_id (required), platform, variant_id, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 32 tools
Each tool targets a distinct operation or resource, with clear differentiation between similar actions (e.g., create_listing vs update_listing vs delete_listing, get_orders vs get_order). No overlapping purposes detected.
All tools follow a consistent verb_noun pattern in snake_case, using common verbs like get_, create_, update_, delete_, reply_to_, respond_to_, etc. No style mixing or ambiguous names.
32 tools is on the higher end but appropriate given the broad e-commerce domain covering listings, orders, shipping, messages, disputes, reviews, vouchers, and shop management. Each tool has a clear purpose, and the count feels well-scoped rather than bloated.
The tool set provides comprehensive CRUD and lifecycle coverage for product listings, orders, shipping, communications, disputes, returns, reviews, vouchers, and shop settings. Obvious gaps are minimal, and the surface aligns well with typical seller needs.
Maintenance
Related MCP Connectors
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Hosted MCP server for 3Dsellers, the multichannel selling platform. Connect Claude, ChatGPT, Cursor, VS Code or any MCP client and manage your eBay, Amazon, Walmart, Etsy, Shopify, WooCommerce and TikTok Shop stores in plain language: search and update products, publish listings, sync inventory, tag and track orders, run bulk actions and CSV imports, and reply to customer messages. 120+ tools. Sign in with OAuth or a personal token. No eBay developer account and nothing to install. Setup guides and config examples for every client: https://github.com/3dsellers/ebay-mcp-server
Hosted Shopify MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server for managing WooCommerce stores through AI assistants like Claude. Provides 101 tools covering products, orders, customers, coupons, shipping, taxes, webhooks, settings, reports, and more.100111 npm2MIT
- AlicenseAqualityDmaintenanceAn open-source MCP server that wraps the Shopline Open API into 143 AI-callable tools for e-commerce data analysis, enabling AI agents to query orders, products, inventory, customer behavior, and promotions from Shopline stores through natural language.10020MIT
- AlicenseCqualityDmaintenanceMCP server that exposes the Amazon Selling Partner API to Claude Desktop and any other MCP client. It wraps the python-amazon-sp-api SDK and ships 55+ tools across 19 SP-API scopes with automatic pagination, throttle-aware retry and multi-marketplace support.534MIT
- AlicenseAqualityDmaintenanceMCP server for the Shopline Open API. Exposes 140+ tools for querying and managing orders, products, customers, promotions, analytics, and store settings from your Shopline store via Claude.100MIT