shein-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
shein-mcp
SHEIN seller platform, exposed as a local stdio MCP server. Any MCP host can drive it — Orkas, Claude Code, Cursor, or anything that speaks MCP.
Manage products, prices, merchant inventory, orders, shipping, returns, certificates and finance through the SHEIN Open Platform API, for self-operated / semi-managed seller apps (application modes 1 and 5).
What's inside
129 reviewed actions: 8 hand-written legacy actions plus 121 documentation-pinned native contracts (snapshot
2026-09-30, generated offline from official docs — never from live responses).Six-umbrella tool surface:
list_capabilities/describe_action/execute_read/execute_write/execute_high_impact/execute_destructive. Every action is pinned to one lane by a reviewed risk entry (R/W/H/D); nothing discovers or widens scope at runtime.Risk metadata for hosts: every tool carries
_meta.orkas.actionPolicy({risk, confirmation, maxBatchSize}), which the Orkas host reads to apply preview / fresh / destructive confirmation — the same model used for its built-in connectors.Acknowledgement semantics: writes return
acknowledgedorpartial_or_failedwith structured failure records; submissions are never treated as review or fulfillment completion. A partial acknowledgement always tells you which resource to inspect before retrying.Output sanitization: credential values and sensitive provider fields are redacted before anything reaches the model context.
Related MCP server: Amazon Seller MCP
Requirements
Node.js 22.12+
A SHEIN Open Platform app (self-operated / semi-managed) with the API grants you need
Install
Human install from a checkout:
npm install
npm run buildFor an AI agent installing this on a machine: follow AGENTS.md. It is the exact sequence — clone to ~/.shein-mcp/app, build, verify 129 actions, register the stdio server with absolute paths, then stop for the user to finish SHEIN authorization. Do not invent credentials.
Authorize (two options)
Option A — guided exchange (recommended first time):
# 1. Print the authorization URL and the redirect URI to register on your SHEIN app
shein-mcp authorize --app-id APPID --app-secret SECRET
# 2. Register the shown redirect URI on the SHEIN Open Platform console, open the URL,
# approve with the shop main account; your callback receives a tempToken.
# 3. Exchange it (verifies identity, products, orders and warehouses before saving)
shein-mcp authorize --temp-token <TOKEN>The grant is written to ~/.shein-mcp/credentials.json (mode 0600).
Option B — manual: complete the exchange in your own tooling and provide the grant via environment variables:
SHEIN_APP_ID=... SHEIN_APP_SECRET=... \
SHEIN_OPEN_KEY_ID=... SHEIN_SECRET_KEY=... SHEIN_SUPPLIER_ID=... \
shein-mcp serveEnvironment variables win over the config file.
Run
shein-mcp serve # stdio MCP server (default command)
shein-mcp whoami # verify the binding, print seller identity and sites
shein-mcp list-actions # print the full reviewed action table (no network)Register with an MCP host
Orkas: Settings → Connectors → Add custom connector, stdio command:
shein-mcp serveClaude Code (claude mcp add / .mcp.json):
{
"mcpServers": {
"shein": {
"command": "shein-mcp",
"args": ["serve"],
"env": { "SHEIN_APP_ID": "...", "SHEIN_APP_SECRET": "...", "SHEIN_OPEN_KEY_ID": "...", "SHEIN_SECRET_KEY": "...", "SHEIN_SUPPLIER_ID": "..." }
}
}
}Usage model
list_capabilities— bind check + the full action table with risk lanes.describe_action— one action's exact parameter schema.execute_read/execute_write/execute_high_impact/execute_destructive— run{ action, parameters }. The tool lane must match the action's reviewed risk; mismatches are rejected.
Writes may await platform review: inspect the matching status action before retrying, never replay an uncertain write automatically. Inventory overwrite (legacy inventory.overwrite, POST /open-api/stock/change-inventory/v2) requires distinct SKUs and idempotency keys, and will not reduce below reserved/occupied stock.
Provenance & license
Adapted from the SHEIN seller adapter in the Orkas open-source repository (MIT), including its pinned contract generation discipline and acknowledgement semantics. This repository is MIT licensed.
Limitations
Feed document workflows (host-owned) and other application modes' APIs are not exposed (
list_capabilitiesreports them incoverage).Large uploads are capped at 256 KiB inline parameters; multipart uploads cap at 10 minutes.
Full API coverage is not claimed; see
coverage.other_application_methodsfor documented-but-unexposed methods.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
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
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Discover, plan and run tools across your connected business systems through one OAuth MCP endpoint
Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables managing Ozon Seller and Performance APIs through MCP, covering products, stocks, prices, orders, finance, analytics, advertising, reviews, and chat operations.MIT
- AlicenseAqualityBmaintenanceEnables managing Amazon seller listings, orders, pricing, inventory, and reports through the SP-API via MCP tools.1518 npm5MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to connect marketplace seller accounts, explore and call shop-level APIs, and manage orders, products, returns, inventory, pricing, and tracking with scoped read-only or read-write access.2MIT
- AlicenseAqualityCmaintenanceEnables MCP clients to search and call store operations and manage products, orders, pricing, promotions, reviews, returns, payouts, posts, and AI images, with sensitive changes requiring owner approval.5MIT