# TikTok Shop

> TikTok Shop is a free MCP server for e-commerce. Read-only TikTok Shop Partner API access for orders, finance, products and analytics. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, API
- **Repository:** https://github.com/buer2333/tiktok-shop-mcp
- **MCP Registry name:** io.github.Buer2333/tiktok-shop-mcp
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-16

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add tiktok-shop-mcp -- uvx tiktok-shop-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tiktok-shop-mcp": {
      "command": "uvx",
      "args": [
        "tiktok-shop-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tiktok-shop-mcp": {
      "command": "uvx",
      "args": [
        "tiktok-shop-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tiktok-shop-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tiktok-shop-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tiktok-shop-mcp": {
      "command": "uvx",
      "args": [
        "tiktok-shop-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tiktok-shop-mcp": {
      "command": "uvx",
      "args": [
        "tiktok-shop-mcp"
      ]
    }
  }
}
```

## Tools

- `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)

## 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.

## Alternatives

- [TikTok Shop Scraper](https://ai-powered.com/mcp/tiktok-shop-scraper): TikTok Shop Scraper is a paid MCP server for web search and scraping.
- [TikTok GMV Max](https://ai-powered.com/mcp/tiktok-gmv-max): TikTok GMV Max is an open-source MCP server for marketing and seo.
- [GoAI Moat Tiktok Shop](https://ai-powered.com/mcp/goai-moat-tiktok-shop): GoAI Moat Tiktok Shop is an MCP server for e-commerce.
- [Trenz](https://ai-powered.com/mcp/trenz): Trenz is a freemium MCP server for e-commerce.
- [Tolstoy](https://ai-powered.com/mcp/tolstoy): Tolstoy is a paid MCP server for e-commerce.
- [Shopware MCP](https://ai-powered.com/mcp/shopware-mcp): Shopware MCP is an open-source MCP server for e-commerce.
- [HashIQ](https://ai-powered.com/mcp/hashiq): HashIQ is a freemium MCP server for e-commerce.
- [cob-shopify-mcp](https://ai-powered.com/mcp/cob-shopify-mcp): cob-shopify-mcp is an open-source MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/tiktok-shop
