This Connector exposes four Tec-Do 2.0 Ad & Growth Intelligence capabilities: two remote MCP tools and two local Skill blueprints.
How to use
- After the MCP is connected and a user sends a message, inspect the Connector
capabilities before answering from general knowledge. In WorkBuddy this means
using the MCP tool catalog exposed by
tools/list.
- Call
tools/list to discover the current four tools.
- For either remote MCP tool, call it directly with
tools/call.
- For either local Skill, call
tools/call to get its blueprint: name,
description, workflow, constraints, and reference URIs.
- Call
resources/read for each referenced file you need.
- Execute blueprint-only Skills yourself following the returned instructions;
the Server does not run Skill scripts or produce output files.
Current Tool Catalog
get_ad_benchmark — Remote MCP tool for CPM, CTR, CPC, and other ad benchmark data by country, platform, and industry.ttcc_search_top_ads — Remote MCP tool for TikTok top-ad search and performance data such as impressions, click-through-rate rank, and completion rate.competitor-analysis-report — Local Skill for structured competitor analysis, including feature comparison, pricing analysis, SWOT, and strategy recommendations.voc-sentiment-analysis — Local Skill for voice-of-customer (VOC) and sentiment analysis from forums and review sites.
Remote MCP Interface Reference
get_ad_benchmark
Route: /mcp/benchmark
Retrieves advertising benchmark data across countries/regions, platforms, and industries, including CPM, CTR, and CPC. Use it for advertising-cost estimation, ROI calculations, product selection, competitor analysis, market research, and trend analysis.
| Parameter |
Type |
Required |
Description |
query |
string |
Yes |
A natural-language query. Include country/region, platform, industry/category, and desired metrics where possible. Returns aggregated data if no metric is specified. |
Examples:
Get CPM benchmarks for the gaming industry on Facebook in the United StatesGet CTR and CPC data for ecommerce on Google in ChinaGet advertising benchmarks for casual games on TikTok
Returns advertising benchmark data for cost estimation and ROI calculations.
ttcc_search_top_ads
Route: /mcp/ttcc_agent
Searches TikTok Creative Center top ads and returns ad titles, brands, video details, impressions, click-through-rate rankings, completion-rate rankings, and other performance data. Use it for creative research, competitor ad-strategy analysis, inspiration, and market-trend research.
| Parameter |
Type |
Required |
Default / Description |
keyword |
string |
Yes |
Search keyword. English keywords are recommended. |
country_code |
string |
No |
Comma-separated country codes. Default: SG,US. |
order_by |
string |
No |
Default: impression. Options: for_you, impression, like, ctr, play_2s_rate, play_6s_rate, cvr. |
period |
integer |
No |
Default: 30. Options: 7, 30, or 180 days. Other values are rounded up to the nearest supported period. |
limit |
integer |
No |
Default: 15; maximum: 50. |
Returns a list of top ads. Each item can include id, ad_title, brand_name, video_info, like, cost, cost_readable, and analytics.
High-performing-ad guidance:
ctr_ranking is a percentile ranking, not an actual click-through rate. Lower is better; ≤ 0.10 represents the top 10%.cost_readable: "High Budget" usually indicates substantial budget investment and can be a useful signal of a validated creative.- Evaluate both
ctr_ranking and cost_readable; do not rely on either metric alone.
Notes
- In WorkBuddy, these tools are displayed with the Connector prefix (for example,
mcp__tec-do__get_ad_benchmark).
tools/list remains the source of truth for availability.
1---2name: tec-do-guide3description: Guide WorkBuddy on when and how to use the Tec-Do MCP tools and local Skill blueprints for ad benchmarks, TikTok ad research, competitor analysis, and VOC sentiment analysis for global advertising and growth teams.4---5
6This Connector exposes four Tec-Do 2.0 Ad & Growth Intelligence capabilities: two remote MCP tools and two local Skill blueprints.
7
8## How to use
91. After the MCP is connected and a user sends a message, inspect the Connector
10 capabilities before answering from general knowledge. In WorkBuddy this means
11 using the MCP tool catalog exposed by `tools/list`.
122. Call `tools/list` to discover the current four tools.
133. For either remote MCP tool, call it directly with `tools/call`.
144. For either local Skill, call `tools/call` to get its blueprint: name,
15 description, workflow, constraints, and reference URIs.
165. Call `resources/read` for each referenced file you need.
176. Execute blueprint-only Skills yourself following the returned instructions;
18 the Server does not run Skill scripts or produce output files.
19
20## Current Tool Catalog
21- `get_ad_benchmark` — Remote MCP tool for CPM, CTR, CPC, and other ad benchmark data by country, platform, and industry.
22- `ttcc_search_top_ads` — Remote MCP tool for TikTok top-ad search and performance data such as impressions, click-through-rate rank, and completion rate.
23- `competitor-analysis-report` — Local Skill for structured competitor analysis, including feature comparison, pricing analysis, SWOT, and strategy recommendations.
24- `voc-sentiment-analysis` — Local Skill for voice-of-customer (VOC) and sentiment analysis from forums and review sites.
25
26## Remote MCP Interface Reference
27
28### `get_ad_benchmark`
29
30Route: `/mcp/benchmark`
31
32Retrieves advertising benchmark data across countries/regions, platforms, and industries, including CPM, CTR, and CPC. Use it for advertising-cost estimation, ROI calculations, product selection, competitor analysis, market research, and trend analysis.
33
34| Parameter | Type | Required | Description |
35|---|---|---|---|
36| `query` | string | Yes | A natural-language query. Include country/region, platform, industry/category, and desired metrics where possible. Returns aggregated data if no metric is specified. |
37
38Examples:
39
40- `Get CPM benchmarks for the gaming industry on Facebook in the United States`
41- `Get CTR and CPC data for ecommerce on Google in China`
42- `Get advertising benchmarks for casual games on TikTok`
43
44Returns advertising benchmark data for cost estimation and ROI calculations.
45
46### `ttcc_search_top_ads`
47
48Route: `/mcp/ttcc_agent`
49
50Searches TikTok Creative Center top ads and returns ad titles, brands, video details, impressions, click-through-rate rankings, completion-rate rankings, and other performance data. Use it for creative research, competitor ad-strategy analysis, inspiration, and market-trend research.
51
52| Parameter | Type | Required | Default / Description |
53|---|---|---|---|
54| `keyword` | string | Yes | Search keyword. English keywords are recommended. |
55| `country_code` | string | No | Comma-separated country codes. Default: `SG,US`. |
56| `order_by` | string | No | Default: `impression`. Options: `for_you`, `impression`, `like`, `ctr`, `play_2s_rate`, `play_6s_rate`, `cvr`. |
57| `period` | integer | No | Default: `30`. Options: `7`, `30`, or `180` days. Other values are rounded up to the nearest supported period. |
58| `limit` | integer | No | Default: `15`; maximum: `50`. |
59
60Returns a list of top ads. Each item can include `id`, `ad_title`, `brand_name`, `video_info`, `like`, `cost`, `cost_readable`, and `analytics`.
61
62High-performing-ad guidance:
63
64- `ctr_ranking` is a percentile ranking, not an actual click-through rate. Lower is better; `≤ 0.10` represents the top 10%.
65- `cost_readable: "High Budget"` usually indicates substantial budget investment and can be a useful signal of a validated creative.
66- Evaluate both `ctr_ranking` and `cost_readable`; do not rely on either metric alone.
67
68## Notes
69- In WorkBuddy, these tools are displayed with the Connector prefix (for example, `mcp__tec-do__get_ad_benchmark`).
70- `tools/list` remains the source of truth for availability.
ahang1598