TikTok GMV Max MCP server

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

• get_ad_groups_tool

  Get ad groups for a specific advertiser with optional filtering

• get_ads_range_report_tool

  Get Ads (manual bid) aggregate report for a date range (no timezone alignment). Returns cost, gmv, orders, roas.

• get_ads_report_aligned_tool

  Get Ads (manual bid) report aligned to shop timezone. Fetches hourly data and re-aggregates to match a shop-tz day. Returns cost, gmv, orders, and roas.

• get_ads_tool

  Get ads for a specific advertiser with optional filtering

• get_advertiser_balance_tool

  Get balance and basic info for individual advertiser accounts. Max 100 IDs per request.

• get_authorized_ad_accounts_tool

  Get all authorized ad accounts accessible by the current access token

• get_bc_account_cost_tool

  Get cost summary for all ad accounts under a BC within a date range. Useful for weekly/monthly spend review.

• get_bc_balance_tool

  Get Business Center balance (available funds).

• get_bc_budget_changelog_tool

  Get budget change history for a specific advertiser under BC. Track who changed budget and when.

• get_bc_transactions_tool

  Get BC transaction records (top-ups, deductions). transaction_level: BC or ADVERTISER. Times format: YYYY-MM-DD HH:MM:SS.

• get_business_centers_tool

  Get business centers accessible by the current access token

• get_campaigns_tool

  Get campaigns for a specific advertiser with optional filtering

• get_creative_report_tool

  Get creative-level performance report (video insights, engagement, play metrics). report_type: VIDEO_INSIGHT (default).

• get_gmvmax_campaign_info_tool

  Get detailed info for a specific GMV Max campaign via /campaign/gmv_max/info/. Returns budget, bid, product, and scheduling details.

• get_gmvmax_campaigns_tool

  Get GMV Max campaigns via /gmv_max/campaign/get/. Returns campaign list with status and ROI protection info. Default filter: PRODUCT_GMV_MAX.

• get_gmvmax_range_report_tool

  Get GMVMAX aggregate report for a date range (no timezone alignment). Returns cost, gmv, orders, roi.

• get_gmvmax_report_aligned_tool

  Get GMVMAX report aligned to shop timezone. Fetches hourly data and re-aggregates to match a shop-tz day, regardless of the ad account's native timezone. Returns aggregated metrics (cost, gross_revenue, orders), ROI, and hours included.

• get_gmvmax_reports_tool

  Get GMV Max performance reports via /gmv_max/report/get/. store_ids is REQUIRED (get from campaign info endpoint). Metrics: cost, orders, cost_per_order, gross_revenue, roi, net_cost, creative_delivery_status, product_impressions, product_clicks, product_click_rate, ad_click_rate, ad_conversion_rate, ad_video_view_rate_2s/6s/p25/p50/p75/p100. Dimensions: advertiser_id, stat_time_day, item_id (item

• get_gmvmax_store_list_tool

  Get stores linked to a GMVMAX advertiser account. Useful to verify store-advertiser bindings.

• get_gmvmax_videos_tool

  Get videos available for GMVMAX campaigns for a given store. Returns video list with IDs for cross-referencing with creative reports.

• get_identities_tool

  Get TikTok identities (creator accounts) authorized to an advertiser. identity_type: CUSTOMIZED_USER, AUTH_CODE, TT_USER, BC_AUTH_TT. For BC_AUTH_TT, identity_authorized_bc_id is required.

• get_reports_tool

  Get performance reports and analytics with comprehensive filtering and grouping options

• get_trending_list_tool

  Get trending hashtags on TikTok via /discovery/trending_list/. discovery_type: HASHTAG. date_range: 7DAY | 30DAY. country_code: e.g. US. Set include_history=True to get per-day rank/views breakdown.

• get_video_info_tool

  Get video asset details (URL, thumbnail, duration) by video IDs. Use with get_ads_tool to map ad → video_id → video URL/poster.

• Code scan45 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 qualitystatic API keys via environment variables6/15
• Maintenancelast push 9 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Safety score

83/100

higher than 65% of 48,273 servers

Tools

24

the typical server has 7

Tools that change things

0%

typical: 0%. Fewer write tools means less an agent can break

Downloads a week

52

more than 45% of 11,915 servers with a package

TikTok GMV Max: common questions

Is TikTok GMV Max MCP server safe?

Mostly: it is graded B (83/100). Read the TikTok GMV Max safety report

How do I install TikTok GMV Max?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does TikTok GMV Max need an API key?

Yes. The registry entry asks for TIKTOK_SECRET, TIKTOK_ACCESS_TOKEN, TIKTOK_ACCESS_TOKEN_2.

Is TikTok GMV Max maintained?

The last commit was 14 days ago (2026-10-19). The latest release is v0.2.0.

How does TikTok GMV Max compare with other MCP servers?

safety score 83/100 (higher than 65% of 48,273 servers); tools 24 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.