MCP.Market

TikTok Shop MCP server

by Buer2333·io.github.Buer2333/tiktok-shop-mcp·v0.3.0·7 stars
No reviews yet

Read-only TikTok Shop Partner API: orders, finance, products and analytics across shops.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

7 stars108 downloads/wk

Reviews

Write one

Nobody has reviewed TikTok Shop yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

TikTok Shop tools (22, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_account_video_gmv_tool

    Auto-paginate all shop videos and aggregate GMV by account username. Pass usernames as comma-separated string (e.g. 'dr.elise,dr.camila') to filter specific accounts. Returns per-account totals: gmv, orders, items_sold, video count.

  • get_creators_bestselling_tool

    Platform-wide TOP 100 bestselling creators (requires Bestsellers scope).

  • get_customer_service_performance_tool

    Get shop customer-service performance (after-sales handling time, IM dissatisfaction rate, etc.) over a custom date window.

  • get_order_detail_toolwrite action

    Get detailed information for specific TikTok Shop orders (max 50 IDs). Use seller_name to specify which shop.

  • get_product_detail_tool

    Get detailed product info including SKU prices. Use seller_name to specify which shop.

  • get_product_performance_tool

    Get single product performance with VIDEO/LIVE/PRODUCT_CARD breakdown. Use seller_name to specify shop.

  • get_products_bestselling_tool

    Platform-wide TOP 100 bestselling products (requires Bestsellers scope).

  • get_shop_orders_tool

    Search TikTok Shop orders. Use seller_name to specify which shop (partial match OK, e.g. 'US' matches 'My Brand US').

  • get_shop_performance_hourly_tool

    Get shop performance by hour for a specific date (YYYY-MM-DD). Use seller_name to specify shop.

  • get_shop_performance_tool

    Get shop-level sales performance (GMV, orders, customers) with VIDEO/LIVE/PRODUCT_CARD breakdown. Dates are YYYY-MM-DD. granularity: 'ALL' (aggregate) or '1D' (daily). Use seller_name to specify shop.

  • get_shop_products_performance_tool

    Get performance ranking for all products (GMV, orders, items_sold). Sort by gmv/items_sold/orders. Use seller_name to specify shop.

  • get_shop_products_tool

    Get TikTok Shop product listings. Use seller_name to specify which shop (partial match OK).

  • get_shop_statements_tool

    Get TikTok Shop financial statements (daily settlement records). Use seller_name to specify which shop.

  • get_shop_transactions_tool

    Get transaction details for a specific order or statement. Provide exactly one of order_id or statement_id. Use seller_name to specify which shop.

  • get_shop_videos_performance_tool

    Get performance ranking for all videos driving shop sales (GMV, views, click-through). account_type: ALL/SELF/AFFILIATE. Use seller_name to specify shop.

  • get_sku_performance_tool

    Get single SKU performance. Use seller_name to specify shop.

  • get_videos_bestselling_tool

    Platform-wide TOP 100 bestselling videos (requires Bestsellers scope).

  • list_shops_tool

    List all configured TikTok Shop accounts with their names and token expiry dates.

  • refresh_all_tokens_tool

    Refresh access tokens for ALL configured shops. Useful for batch renewal before expiry.

  • refresh_token_tool

    Refresh the TikTok Shop access token for a specific shop. Call when you get a 401/token expired error. New tokens are auto-saved to shops.json.

  • search_cancellations_tool

    Search cancelled orders with refund amounts and cancel reasons. Use start_date/end_date (YYYY-MM-DD) or raw timestamps.

  • search_returns_tool

    Search return/refund orders with refund amounts. Use start_date/end_date (YYYY-MM-DD) or raw timestamps.

Public scan report

scanner v0.1.10 · 2026-10-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan16 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 9 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How TikTok Shop compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 93% of 2,176 E-commerce servers
Tools
22
the typical E-commerce server has 7
Tools that change things
5%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
7
more than 89% of 1,044 E-commerce servers
Downloads a week
108
more than 70% of 403 E-commerce servers with a package

What its tools let an agent do: 21 read · 1 change

Install TikTok Shop in Claude Code, Cursor or VS Code

claude mcp add tiktok-shop-mcp -- uvx tiktok-shop-mcp
Add to Cursor

What the publisher says

From the TikTok Shop repository's README, as published. We do not edit it. Read it on GitHub

tiktok-shop-mcp

<!-- mcp-name: io.github.Buer2333/tiktok-shop-mcp -->

A Model Context Protocol (MCP) server for the TikTok Shop Partner API — query orders, finance, products, analytics, and affiliate performance across multiple shops from Claude, or any other MCP client.

Built for sellers and agencies who operate TikTok Shops and want their AI assistant to answer questions like "what did the US shop sell yesterday?", "which SKUs are trending this week?", or "pull the settlement statements for June" — directly against the official API, with no browser scraping.

Features

  • Multi-shop — configure any number of shops in one JSON file; every tool takes an optional seller_name (partial match) to pick the shop
  • 22 tools covering orders, finance, product catalog, shop/video/SKU analytics, affiliate best-sellers, and returns/cancellations
  • Human-friendly dates — pass start_date=2026-07-01 + an IANA timezone instead of unix timestamps; the server handles conversion
  • Token lifecycle — inspect expiry and refresh access tokens (single shop or all shops) without leaving the conversation
  • Resilient by default — all requests go through mcp-retry (exponential backoff + jitter on 429/5xx/network errors)
  • Read-only against your shop — no tool edits listings, creates products, or uploads files. The only thing the server writes is your own shops.json, when it refreshes tokens, with owner-only (0600) permissions. For defense in depth, authorize the Partner Center app with read scopes only

Tools

Installation

pip install tiktok-shop-mcp

Or from source, into a virtualenv, with the direct dependencies pinned to the versions the tests run against:

git clone https://github.com/Buer2333/tiktok-shop-mcp.git
cd tiktok-shop-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/pip install --no-deps -e .

requirements.txt pins the direct runtime dependencies to exact versions, including mcp-retry, which wraps every API call and so sees your tokens. Transitive dependencies (pydantic, starlette, and so on) are not pinned; for a fully reproducible install, generate a lock file with pip-compile --generate-hashes. Bump a pin only after reading what changed in that release.

Compatibility

Works with both mcp 1.x and 2.x. mcp 2.0 renamed FastMCP to MCPServer (mcp.server.mcpserver) and turned mcp.server.fastmcp into a raising stub; server.py imports via a try-v2-except-v1 shim. Tests pass on 1.28.1 and 2.1.1; requirements.txt pins 2.1.1.

Configuration

Credentials live in a JSON file outside the repo (default ~/.config/tiktok-mcp/shops.json, override with the TIKTOKSHOPCONFIG env var). The server never reads a shops.json from the project folder, so a copy there can't be picked up and synced or committed by accident. Keep the file owner-only:

chmod 700 ~/.config/tiktok-mcp && chmod 600 ~/.config/tiktok-mcp/shops.json

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

TikTok Shop: common questions

Is TikTok Shop MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the TikTok Shop safety report
How do I install TikTok Shop?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does TikTok Shop need an API key?
No secret keys are declared. It reads 2 settings from the environment.
Is TikTok Shop maintained?
The last commit was 14 days ago (2026-10-19). The latest release is v0.3.0.
What can I use instead of TikTok Shop?
Servers from other publishers that do the same job: Shopware MCP server, Shopee MCP server and PostHog MCP Server. Compare all TikTok Shop alternatives.
How does TikTok Shop compare with other E-commerce MCP servers?
safety score 92/100 (higher than 93% of 2,176 E-commerce servers); tools 22 (the typical E-commerce server has 7); tools that change things 5% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to TikTok Shop

Same job from other publishers: the closest match first, then the best rated.

All TikTok Shop alternatives →
  • Shopware
    Query and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.
    B
  • Shopee
    MCP server for Shopee — LatAm marketplace Partner API v2 (orders, products, shipping, returns)
    More from codespar →
    B
  • PostHog MCP Server
    Official PostHog MCP Server for product analytics, feature flags, experiments, and more.
    A
  • WebCake Storefront
    Build pages and manage products, orders, and content on the WebCake/StoreCake storefront builder.
    A
  • Apiguru Amazon Data
    Live Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.
    A