trendzeist-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TRENDZEIST_HL | No | UI language for Google Trends. | en-US |
| TRENDZEIST_TZ | No | Timezone offset in minutes. | 360 |
| TRENDZEIST_BACKOFF | No | Exponential backoff factor. | 1.5 |
| TRENDZEIST_PROXIES | No | Comma-separated proxy URLs for rotation. | |
| TRENDZEIST_RETRIES | No | Retry attempts on transient errors. | 3 |
| TRENDZEIST_CACHE_DIR | No | Persistent cache location; use 'off' to disable. | OS user cache dir |
| TRENDZEIST_LOG_LEVEL | No | Python logging level (stderr). | WARNING |
| TRENDZEIST_MIN_INTERVAL | No | Minimum seconds between Google requests. | 2.0 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| interest_over_timeA | Search-interest time series (0-100) for 1-5 keywords, with per-keyword summary (mean, latest, peak, direction over the whole window, direction_now = recent slope, growth_3m/growth_12m % and a plain-English insight). Use direction_now to decide whether to write about a topic now; direction can be 'rising' or 'new' for a topic that peaked months ago. Long series are downsampled to ~60 points. gprop: '' (web), 'news', 'youtube' (authority channels answer engines cite), 'images', 'froogle'. |
| compare_keywordsA | Compare 2-5 keywords head-to-head: relative share, leader and trend direction for each. Use to pick the strongest angle among alternatives. |
| related_queriesB | Top and rising search queries related to a keyword. 'rising' includes %
growth and is_breakout (>5000%); every item carries a title |
| related_topicsA | Top and rising Knowledge-Graph topics related to a keyword. Google often returns nothing here; if available=false fall back to related_queries. |
| interest_by_regionB | Where a keyword is searched most. resolution: COUNTRY (geo='' only), REGION (states/provinces within geo), CITY and DMA (US metro areas; geo='US' or worldwide only). Non-US countries support REGION only. |
| suggest_keywordsA | Google's entity suggestions for a keyword (title, type, mid). Use to disambiguate ambiguous terms or find the canonical topic id. |
| trending_nowA | Real-time trending searches (last ~24h) for a country or US state, with approximate traffic and linked news headlines. Good for newsjacking. topic_filter keeps only trends whose title or headlines contain every word given (e.g. 'coffee'); the full feed is still fetched and cached once. |
| list_categoriesA | Browse/search Google Trends category ids (e.g. 'coffee' -> Food & Drink >
Coffee & Tea). Pass the id as |
| discover_topicsA | One-shot topic discovery for blog ideation. For 1-5 seed keywords, pulls
12-month trend context (direction, direction_now, growth_3m) plus rising/top
related queries, de-duplicates and ranks candidates as breakout > rising >
evergreen, each tagged with a title |
| mine_questionsA | Long-tail questions people type about a seed, from Google Autocomplete ('how to', 'why', 'what is', 'vs' ... expansions), de-duplicated and tagged with a title angle. Feeds FAQ sections and answer-engine (AEO) content. Up to ~16 throttled requests per call; results cached 24 h. limit: 1-100. |
| aeo_opportunitiesA | AEO opportunity finder. For 1-5 seeds: question-shaped searches (Trends + a
capped Autocomplete pass) clustered by seed and title angle, each scored with
the seed's recent trend (direction_now over 12 months, growth_3m), Google News
coverage (who to quote / pitch), Wikipedia presence, the site's own coverage and
the evidence type that makes the answer citable (score_breakdown explains every
point). site_queries = queries the site already ranks for (fill from a Search
Console MCP or page titles); clusters then carry coverage covered / partial / gap
and exclude_covered drops covered ones. Spam-like rising queries are ignored.
Up to ~1+10 requests per seed; partial failures per source in |
| news_coverageA | Who is covering a topic in Google News: recent headlines, a publisher frequency table (mention / pitch targets) and a recency histogram with a coverage label. One request, cached 15 min. limit = headlines returned (1-50). |
| wiki_attentionA | Does Wikipedia have an exact-title article for a topic, and is attention growing?
Exact article (title, encoded URL, wordcount), daily pageviews for |
| what_changedA | What changed for 1-5 seeds since the last snapshot at least since_days (1-90) old: new_breakouts and promoted (action: investigate now), new_rising (consider), cooled / dropped queries (review: verify with interest_over_time before retiring, or refresh existing post), rank_moves and a direction_flip on direction_now. Leaving Google's relative list is not proof of falling demand. Refreshes current data first (1 + N requests, cached), then compares complete snapshots from the local observation archive, which fills up as any tool fetches fresh data. No baseline yet -> per-seed reason with the date to rerun. |
| trend_historyA | Local archive of what the tools have seen about a keyword (as a seed or as a
related query under other seeds) in the last |
| seasonalityA | When demand for a keyword peaks each year (5-year weekly data): monthly_index, peak_months, seasonal_strength, next_peak and publish_by (6 weeks before the peak), with a plain-English insight. One request; seasonal=null with a reason when fewer than 3 full years exist. |
| compare_channelsB | Which Google property a topic grows on: web, youtube, news, images, shopping,
each with direction / direction_now / growth_3m, plus fastest_channel and a
format_hint (video tutorial, buying guide, newsjacking piece ...). 5 requests
(web first; the rest are |
| trendzeist_statusA | Health of every data source (google_trends, google_autocomplete, google_news, wikipedia: live / error / idle with the last error), cache usage, observation archive (rows, dates, last_error) and effective settings. Free: makes no network requests. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| blog_ideas_from_trends | Guided workflow: turn Google Trends data into a prioritised list of blog post ideas. |
| answer_brief | Citable-answer brief for one question: direct answer, statistic, quote, sources, FAQ, schema (GEO structure). |
| content_brief | Full content brief for a topic: titles, H2 outline, FAQ, regions, evidence checklist, publishers to pitch. |
| weekly_review | Weekly content meeting: what changed, what is seasonal, which format, what to publish / refresh / retire. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 18 tools
Most tools target a distinct data source or analysis (trending_now, interest_over_time, news_coverage, wiki_attention, seasonality, trend_history), and descriptions carefully explain when to use each. However, discover_topics and aeo_opportunities overlap substantially—both take 1-5 seeds, pull rising/top queries, cluster question-shaped searches, compute coverage and scores, and rank candidates—so an agent may struggle to choose between them for ideation vs AEO work. related_queries/related_topics also bleed into discover_topics' output.
All names use snake_case consistently and are readable, with a mix of verb_noun (suggest_keywords, compare_keywords, mine_questions, discover_topics) and noun_phrase (related_queries, interest_over_time, trend_history) conventions. The style is uniform, though the verb-first pattern isn't universal and one tool carries a branded prefix (trendzeist_status).
18 tools is slightly above the comfortable 3-15 band, but the server spans many genuinely different data sources (Google Trends, Autocomplete, News, Wikipedia) and analytical views (seasonality, channels, change detection), so each tool maps to a real capability. The main redundancy is the discover_topics/aeo_opportunities pair, which could arguably be merged.
The surface covers the full trend-research lifecycle: raw feeds (trending_now), keyword expansion (related_queries/topics, suggest_keywords, mine_questions), regional and temporal interest, seasonality, cross-channel growth, external sources (news, Wikipedia), multi-seed discovery/AEO scoring, change detection, and a local history archive, plus a health/status tool. No obvious dead ends for a read-only analytics domain.