{"name":"io.github.Buer2333/tiktok-gmvmax-mcp","slug":"buer2333-tiktok-gmvmax-mcp","title":"TikTok GMV Max","description":"Read-only TikTok Business API: GMV Max campaigns and reports, ads, BC balances.","url":"https://mcp.market/server/buer2333-tiktok-gmvmax-mcp","rating":null,"grade":"B","score":83,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":24,"stars":0,"forks":0,"downloads_week":52,"last_push_at":"2026-10-19T03:28:43.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"pypi","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/Buer2333/tiktok-ads-mcp","website":null,"version":"0.2.0","remotes":[],"packages":[{"registryType":"pypi","registryBaseUrl":"https://pypi.org","identifier":"tiktok-gmvmax-mcp","version":"0.2.0","runtimeHint":"uvx","transport":{"type":"stdio"},"environmentVariables":[{"description":"TikTok Business API app ID","isRequired":true,"format":"string","name":"TIKTOK_APP_ID"},{"description":"TikTok Business API app secret","isRequired":true,"format":"string","isSecret":true,"name":"TIKTOK_SECRET"},{"description":"Long-lived Business API access token","isRequired":true,"format":"string","isSecret":true,"name":"TIKTOK_ACCESS_TOKEN"},{"description":"Optional second token, tried on permission errors","format":"string","isSecret":true,"name":"TIKTOK_ACCESS_TOKEN_2"}]}],"tools":[{"name":"get_ad_groups_tool","description":"Get ad groups for a specific advertiser with optional filtering","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_ads_range_report_tool","description":"Get Ads (manual bid) aggregate report for a date range (no timezone alignment). Returns cost, gmv, orders, roas.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_ads_report_aligned_tool","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_ads_tool","description":"Get ads for a specific advertiser with optional filtering","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_advertiser_balance_tool","description":"Get balance and basic info for individual advertiser accounts. Max 100 IDs per request.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_authorized_ad_accounts_tool","description":"Get all authorized ad accounts accessible by the current access token","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_bc_account_cost_tool","description":"Get cost summary for all ad accounts under a BC within a date range. Useful for weekly/monthly spend review.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_bc_balance_tool","description":"Get Business Center balance (available funds).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_bc_budget_changelog_tool","description":"Get budget change history for a specific advertiser under BC. Track who changed budget and when.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_bc_transactions_tool","description":"Get BC transaction records (top-ups, deductions). transaction_level: BC or ADVERTISER. Times format: YYYY-MM-DD HH:MM:SS.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_business_centers_tool","description":"Get business centers accessible by the current access token","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_campaigns_tool","description":"Get campaigns for a specific advertiser with optional filtering","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_creative_report_tool","description":"Get creative-level performance report (video insights, engagement, play metrics). report_type: VIDEO_INSIGHT (default).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_gmvmax_campaign_info_tool","description":"Get detailed info for a specific GMV Max campaign via /campaign/gmv_max/info/. Returns budget, bid, product, and scheduling details.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_gmvmax_campaigns_tool","description":"Get GMV Max campaigns via /gmv_max/campaign/get/. Returns campaign list with status and ROI protection info. Default filter: PRODUCT_GMV_MAX.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_gmvmax_range_report_tool","description":"Get GMVMAX aggregate report for a date range (no timezone alignment). Returns cost, gmv, orders, roi.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_gmvmax_report_aligned_tool","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_gmvmax_reports_tool","description":"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","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_gmvmax_store_list_tool","description":"Get stores linked to a GMVMAX advertiser account. Useful to verify store-advertiser bindings.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_gmvmax_videos_tool","description":"Get videos available for GMVMAX campaigns for a given store. Returns video list with IDs for cross-referencing with creative reports.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_identities_tool","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_reports_tool","description":"Get performance reports and analytics with comprehensive filtering and grouping options","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_trending_list_tool","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_video_info_tool","description":"Get video asset details (URL, thumbnail, duration) by video IDs. Use with get_ads_tool to map ad → video_id → video URL/poster.","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":83,"grade":"B","scanned_at":"2026-10-27T18:18:03.528Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-10-27T18:18:03.432Z","components":{"code":{"score":25,"max":25,"notes":["45 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 9 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"pypi","identifier":"tiktok-gmvmax-mcp","version":"0.2.0","found":true,"weeklyDownloads":52,"license":"MIT","dependencyCount":10,"publishedAt":"2026-10-19T03:16:40.784012Z","repositoryUrl":"https://github.com/Buer2333/tiktok-ads-mcp"}],"repo":{"found":true,"owner":"Buer2333","repo":"tiktok-ads-mcp","archived":false,"pushedAt":"2026-10-19T03:28:43Z","stars":0,"forks":0,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/13869438?v=4","ownerCreatedAt":"2015-08-19T12:33:09Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/13869438?v=4&s=128","source":"github"},"presence":{"stars":0,"forks":0,"downloadsWeek":52,"license":"MIT","lastPushAt":"2026-10-19T03:28:43.000Z","score":24}}}},"grade_history":[],"reviews":[]}