Skip to content
MCP server

TikTok Shop

Read-only TikTok Shop Partner API access for orders, finance, products and analytics

Runs locally
Install

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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tiktok-shop-mcp": {
      "command": "uvx",
      "args": [
        "tiktok-shop-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tiktok-shop-mcp": {
      "command": "uvx",
      "args": [
        "tiktok-shop-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers