TikTok Shop
Read-only TikTok Shop Partner API access for orders, finance, products and analytics
TikTok Shop is a free MCP server for e-commerce. It runs locally on your machine and is started by your AI client.
- Pricing
- Free
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add tiktok-shop-mcp -- uvx tiktok-shop-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"tiktok-shop-mcp": {
"command": "uvx",
"args": [
"tiktok-shop-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tiktok-shop-mcp": {
"command": "uvx",
"args": [
"tiktok-shop-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tiktok-shop-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"tiktok-shop-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tiktok-shop-mcp": {
"command": "uvx",
"args": [
"tiktok-shop-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tiktok-shop-mcp": {
"command": "uvx",
"args": [
"tiktok-shop-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
TIKTOK_SHOP_CONFIGPath to shops.json (default ~/.config/tiktok-mcp/shops.json)TIKTOK_SHOP_BESTSELLERS_SHOPShop used by the bestselling tools when seller_name is omitted
About TikTok Shop
Built for sellers and agencies running one or many shops, the server answers questions such as yesterday's sales, trending SKUs or June settlement statements directly against the official Partner API rather than by browser scraping. Each shop is configured in a JSON file outside the repo, and every tool accepts an optional seller name to pick one. Dates can be given in readable form with a time zone, and expired access tokens are refreshed automatically.
Its 32 tools cover orders, returns and cancellations, finance statements and transactions, product catalogue and listing lookups, shop, video and SKU analytics, and affiliate best-sellers. Five product-writing tools exist but refuse to run until a shop is listed by exact name in an environment variable, and each defaults to a dry run. Requests retry with backoff on rate limits and errors.
It installs from PyPI and runs over stdio.
Tools this server provides (14)
Taken from the project documentation; the running server may differ.
- list_shops
- List configured shops
- refresh_token
- Refresh a shop's access token
- get_shop_orders
- List orders for a shop
- get_order_detail
- Details of one order
- search_returns
- Search returns
- search_cancellations
- Search cancellations
- get_shop_statements
- Settlement statements
- get_shop_transactions
- Transactions
- get_shop_products
- Product list
- get_product_detail
- Details of one product
- get_shop_performance
- Shop performance
- get_sku_performance
- SKU performance
- get_products_bestselling
- Best-selling products
- create_product
- Create a product (opt-in)
What it does
- Multi-shop support
- Configure any number of shops in one file.
- Order and finance reads
- Orders, returns, statements and transactions.
- Analytics
- Shop, video, product and SKU performance.
- Bestseller lists
- Affiliate videos, creators and products.
- Opt-in writes
- Product edits need an explicit per-shop gate and default to dry run.
- Token refresh
- Refreshes expired tokens and retries once.
Good for
- Ask what a US shop sold yesterday
- Pull settlement statements for a month
- Find trending SKUs this week
- Check returns and cancellations across shops
Pricing
Free
Free; requires TikTok Shop Partner API credentials
TikTok Shop FAQ
Is TikTok Shop read-only?
By default yes; product write tools refuse until a shop is listed by exact name and default to dry run.
What do I need?
App credentials from TikTok Shop Partner Center and authorised shops in a shops.json file.
How do I install TikTok Shop?
pip install tiktok-shop-mcp.
Does TikTok Shop scrape?
No. It uses the official Partner API.
Is TikTok Shop free?
Yes. TikTok Shop is free to use.
How do I add TikTok Shop to Claude Code?
Run this command in your terminal: claude mcp add tiktok-shop-mcp -- uvx tiktok-shop-mcp
What are the best alternatives to TikTok Shop?
The closest alternatives to TikTok Shop are TikTok Shop Scraper, TikTok GMV Max, GoAI Moat Tiktok Shop, Trenz and Tolstoy.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.