Skip to content
Agentmart
Submit a tool

TikTok Shop

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

Connector by Buer2333 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 7
Write a review

Chalk Labs

Need help deploying TikTok Shop?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/buer2333-tiktok-shop-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
20 read · 0 write · 0 delete · 2 not yet classified
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 22

Read from the source code; the running server may list different tools.

Read 20 · Look things up without changing anything.

  • get_account_video_gmv_tool
  • get_creators_bestselling_tool
  • get_customer_service_performance_tool
  • get_order_detail_tool
  • get_product_detail_tool
  • get_product_performance_tool
  • get_products_bestselling_tool
  • get_shop_orders_tool
  • get_shop_performance_hourly_tool
  • get_shop_performance_tool
  • get_shop_products_performance_tool
  • get_shop_products_tool
Show 8 more tools
  • get_shop_statements_tool
  • get_shop_transactions_tool
  • get_shop_videos_performance_tool
  • get_sku_performance_tool
  • get_videos_bestselling_tool
  • list_shops_tool
  • search_cancellations_tool
  • search_returns_tool

Not yet classified 2 · We could not tell from the name and description.

  • refresh_all_tokens_tool
  • refresh_token_tool

Secrets and settings it asks for

Other settings (environment variables or headers).

  • TIKTOK_SHOP_BESTSELLERS_SHOP
  • TIKTOK_SHOP_CONFIG

Network hosts it talks to 3

  • auth.tiktok-shops.com · found in code
  • github.com · found in code
  • open-api.tiktokglobalshop.com · found in code

Files it touches

  • Your home directory (~)

Tools (22)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • 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). date: reference date YYYY-MM-DD. time_slot: "7D" (default) or "30D". author_type: "ALL" / "AFFILIATE" / "OFFICIAL". Returns bucketed gmv_range per creator. Use for BD outreach discovery.

  • get_customer_service_performance_tool

    Get shop customer-service performance (after-sales handling time, IM dissatisfaction rate, etc.) over a custom date window. Dates are YYYY-MM-DD. support_date_ge inclusive, support_date_lt exclusive. Wraps GET /customer_service/202407/performance — replaces SPS-backend's locked 60-day window. Use seller_name to specify shop.

  • get_order_detail_tool

    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). date: reference date YYYY-MM-DD. time_slot: "7D" (default) or "30D". category_id: optional TikTok category filter. Returns bucketed gmv_range per product — use for competitor and category-trend scouting.

  • 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'). Date query options (choose one): - Raw unix timestamps: create_time_ge / create_time_lt - Human-friendly dates: start_date / end_date (YYYY-MM-DD) + timezone timezone: IANA timezone for date conversion. Use the timezone your reporting day follows, e.g. 'Etc/GMT+8' (fixed UTC-8) or 'America/New_York' (default). When start_date is provided, it overrides create_time_ge/create_time_lt. start_date = beginning of that day in the given timezone. end_date = end of that day (if omitt…

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

Show 7 more tools
  • 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). date: reference date YYYY-MM-DD. time_slot: "7D" (default) or "30D". Returns bucketed gmv_range per video — no exact GMV. Useful for trend-scouting and creator discovery.

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

Signals

Stars
7
Forks
1
Open issues
0
Weekly downloads
237
Last commit
Oct 19, 2026 (13 days ago)
Last release
Oct 19, 2026 (13 days ago)
Last package publish
Oct 19, 2026 (13 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.Buer2333/tiktok-shop-mcp
Version
0.3.0
Auth
No auth
Packages
pypi tiktok-shop-mcp
License
MIT
Repository
github.com/Buer2333/tiktok-shop-mcp
First seen
Oct 24, 2026
Last checked
Nov 1, 2026
Source
Official MCP Registrygithub-graphql

More from Buer2333

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped
50+
launches shipped
media placements
500+
media placements
founders on every account
2
founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get TikTok Shop running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Goes to the Chalk Labs founders, not the newsletter. Privacy

Need help deploying TikTok Shop?

CallGet help
Cite this page

TikTok Shop MCP server. Agent Mart. https://agentmart.dev/connectors/buer2333-tiktok-shop-mcp (last updated 2026-11-01)