Skip to main content
Glama

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 build

npm 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.js

Develop

npm run typecheck    # type-check src + scripts
npm test             # signing golden-vector tests

Project 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 flow

Adding a platform = implement Platform in src/platforms/<name>/ and register it. No tool changes.

Available Tools

32 tools
arrange_shipmentArrange shipmentA
Destructive

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 cancellationsB
Read-only

List buyer-initiated cancellation requests.

Inputs: limit, cursor, status, platform.

get_disputesGet disputesA
Read-only

List disputes/complaints/escalations needing seller input.

Inputs: limit, cursor, status, platform.

get_low_stock_itemsGet low-stock itemsA
Read-only

List items at or below a stock threshold (default 5).

Inputs: limit, cursor, platform, threshold.

get_messagesGet messagesA
Read-only

List buyer conversations, optionally only unread ones.

Inputs: limit, cursor, status, platform.

get_orderGet orderA
Read-only

Full detail for one order: line items, buyer, ship-to address, totals, and status.

Inputs: order_id (required), platform.

get_ordersGet ordersB
Read-only

List orders, optionally filtered by fulfillment status.

Inputs: limit, since, cursor, status, +1 more.

get_priceGet priceC
Read-only

Get the current price of a product and each of its variants.

Inputs: product_id (required), platform.

get_productsGet productsB
Read-only

List or search products in the shop, optionally filtered by status.

Inputs: limit, query, cursor, status, +1 more.

get_returnGet returnA
Read-only

Full detail of one return/refund request: reason, evidence, amount, buyer.

Inputs: return_id (required), platform.

get_returnsGet returnsB
Read-only

List buyer return/refund requests.

Inputs: limit, cursor, status, platform.

get_reviewsGet reviewsB
Read-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 infoB
Read-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 infoB
Read-only

Shop profile, region, status, and auth health.

Inputs: platform.

get_shop_performanceGet shop performanceC
Read-only

Shop KPIs: sales, orders, rating, response rate, penalties.

Inputs: period, metrics, platform.

get_stockGet stockB
Read-only

Get current stock for a product and each of its variants.

Inputs: product_id (required), platform.

get_vouchersGet vouchersA
Read-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 cancellationA
Destructive

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 disputeB
Destructive

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 returnA
Destructive

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 shipmentC
Read-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

    A3.7/5.0

    Scored across 32 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP 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.
      100
      111 npm
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      100
      20
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      MCP 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.
      53
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      100
      MIT