Skip to content
Agentmart
Submit a tool

TikTok GMV Max

Read-only TikTok Business API: GMV Max campaigns and reports, ads, BC balances.

Connector by Buer2333 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)
Write a review

Chalk Labs

Need help deploying TikTok GMV Max?

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-gmvmax-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 Business API: GMV Max campaigns and reports, ads, BC balances.

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
24 read · 0 write · 0 deleteRead-only
Secrets
3 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Python package

Tools by what they do 24

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

Read 24 · Look things up without changing anything.

  • get_ad_groups_tool
  • get_ads_range_report_tool
  • get_ads_report_aligned_tool
  • get_ads_tool
  • get_advertiser_balance_tool
  • get_authorized_ad_accounts_tool
  • get_bc_account_cost_tool
  • get_bc_balance_tool
  • get_bc_budget_changelog_tool
  • get_bc_transactions_tool
  • get_business_centers_tool
  • get_campaigns_tool
Show 12 more tools
  • get_creative_report_tool
  • get_gmvmax_campaign_info_tool
  • get_gmvmax_campaigns_tool
  • get_gmvmax_range_report_tool
  • get_gmvmax_report_aligned_tool
  • get_gmvmax_reports_tool
  • get_gmvmax_store_list_tool
  • get_gmvmax_videos_tool
  • get_identities_tool
  • get_reports_tool
  • get_trending_list_tool
  • get_video_info_tool

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • TIKTOK_ACCESS_TOKEN
  • TIKTOK_ACCESS_TOKEN_2
  • TIKTOK_SECRET

Other settings (environment variables or headers).

  • TIKTOK_APP_ID

Network hosts it talks to 4

  • api.frankfurter.dev · found in code
  • business-api.tiktok.com · found in code
  • github.com · found in code
  • sandbox-ads.tiktok.com · found in code

Files it touches

  • Your home directory (~)
  • ~/.cache/lark-bot/fx_rates.json

Tools (24)

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

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

Show 9 more tools
  • 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_id requires filtering with campaign_ids AND item_group_ids). Filtering: {"campaign_ids": ["..."], "item_group_ids": ["..."]}.

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

Signals

Stars
0
Forks
0
Open issues
0
Weekly downloads
185
Last commit
Oct 19, 2026 (12 days ago)
Last release
Oct 19, 2026 (12 days ago)
Last package publish
Oct 19, 2026 (12 days ago)

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

Details

Registry name
io.github.Buer2333/tiktok-gmvmax-mcp
Version
0.2.0
Auth
API key
Packages
pypi tiktok-gmvmax-mcp
License
MIT
Repository
github.com/Buer2333/tiktok-ads-mcp
First seen
Oct 24, 2026
Last checked
Oct 25, 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 GMV Max 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 GMV Max?

CallGet help
Cite this page

TikTok GMV Max MCP server. Agent Mart. https://agentmart.dev/connectors/buer2333-tiktok-gmvmax-mcp (last updated 2026-10-25)