MCP Server for AI Agents: Google Trends Realtime & Entities

An always-on Model Context Protocol (MCP) server and batch Actor that reads Google Trends realtime trending searches, the trending RSS news feed and Knowledge Graph entity (mid) autocomplete for AI agents (Claude Desktop, Cursor, Windsurf, OpenAI Agents, LangChain) and monitoring workflows. Every record carries search volume, growth, start/end time, related queries, categories, news items and a ready-to-use Google Trends Explore URL.

No proxies, no logins, no cookies, no personal data: only public Google Trends endpoints are called.

What it does

Mode	Source	What you get
trending	i0OFE realtime trends (+ RSS news)	Search volume, growth percent, start/end time, active flag, related queries, categories, attached news
rss_only	trending_rss	Trending RSS items with approximate traffic, picture and news items
entities	autocomplete	Knowledge Graph entities (mid, title, entity_type) for each query

Endpoints

• GET / and GET /health: return {"status":"ok","actor":"google-trends-realtime-mcp","version":"0.1","tools":[...]}.
• POST /mcp: MCP JSON-RPC 2.0 (initialize, ping, tools/list, tools/call). Notifications return HTTP 202.

Input

Field	Type	Default
mode	trending, rss_only, entities	trending
geos	string[] (1 to 10 country codes)	["US"]
hours	4, 24, 48, 168	24
hl	language code	en
category	category id or name fragment	none
min_search_volume	integer >= 0	none
min_growth_percent	integer >= 0	none
active_only	boolean	false
query_filter	string (matches query or related queries)	none
queries	string[] (max 50, required for entities)	[]
include_news	boolean	true
max_items	integer 1 to 500	50
max_total_charge_usd	number or null	no cap

An empty input {} is valid (realtime trends for the US, last 24 hours, 50 items). Invalid input is rejected with INVALID_INPUT_ZERO_CHARGE before any network call or charge.

Output record

Every record has exactly the same keys; unused ones are null or empty.

{
  "record_type": "realtime_trend",
  "uid": "3f1c0e5a9b7d...",
  "geo": "US",
  "rank": 1,
  "query": "world series",
  "search_volume": 500000,
  "approx_traffic": "500K+",
  "growth_percent": 1000,
  "started_at": "2026-10-24T18:30:00Z",
  "ended_at": null,
  "is_active": true,
  "related_queries": ["world series game 7", "dodgers"],
  "category_ids": [18],
  "categories": ["Sports"],
  "news_items": [
    {"title": "Game 7 preview", "snippet": "...", "url": "https://example.com/a", "picture_url": null, "source": "Example News"}
  ],
  "news_count": 1,
  "picture_url": null,
  "picture_source": null,
  "hours": 24,
  "hl": "en",
  "mid": null,
  "title": null,
  "entity_type": null,
  "google_trends_explore_url": "https://trends.google.com/trends/explore?q=world+series&geo=US&hl=en",
  "source": "i0OFE"
}

MCP usage

Standby URL: https://mutualistic-housing--google-trends-realtime-mcp.apify.actor/mcp (authenticate with your Apify API token).

{
  "mcpServers": {
    "google-trends": {
      "url": "https://mutualistic-housing--google-trends-realtime-mcp.apify.actor/mcp",
      "headers": { "Authorization": "Bearer <APIFY_API_TOKEN>" }
    }
  }
}

Tools:

• get_realtime_trends: realtime trends with geos, hours, category, min_search_volume, min_growth_percent, active_only, query_filter, include_news, max_items, max_total_charge_usd.
• get_trending_news_rss: trending RSS items with news for geos (max_items, max_total_charge_usd).
• resolve_entities: Knowledge Graph entities for queries (required), hl, max_items, max_total_charge_usd.
• list_supported_geos_and_categories: free; lists supported geos, categories, lookback hours, modes and pricing.

Billed tools return results, count, charged, errors, truncated and tasks_skipped.

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_realtime_trends","arguments":{"geos":["US","GB"],"hours":24,"min_search_volume":10000,"max_items":20}}}

Pricing

Pay per event: $0.002 per result returned (result-returned); the actor-start event is free. max_items and max_total_charge_usd are hard caps enforced in code, so a run never charges more than you configure. Invalid input and empty results are never charged.

Limits

• Up to 10 geos and 50 entity queries per call; max_items is capped at 500.
• Each upstream request has a wall-clock timeout and an 8 MiB response cap; 429 and 5xx responses are retried and reported in errors without failing the run.
• MCP tool calls have a 45 second overall deadline; tasks that do not fit are counted in tasks_skipped and truncated is set.
• Google Trends data reflects what Google shows at request time and can change between runs. Search volume is approximate.

Related MCP Servers by Mutualistic Labs

Actor	Covers	Store	Standby MCP URL
Multi-ATS Career Jobs Search MCP	Greenhouse, Lever, Ashby, SmartRecruiters, Workable	https://apify.com/mutualistic_housing/multi-ats-career-jobs-mcp	https://mutualistic-housing--multi-ats-career-jobs-mcp.apify.actor/mcp
Google Ads Transparency & Ad Spy MCP	SearchCreatives, SearchSuggestions, content.js ad-copy & video metadata	https://apify.com/mutualistic_housing/google-ads-transparency-mcp	https://mutualistic-housing--google-ads-transparency-mcp.apify.actor/mcp
Multi-Engine Keyword & Autocomplete MCP	Google, YouTube, Amazon, Bing, DuckDuckGo, Brave + google:suggestrelevance & search intent	https://apify.com/mutualistic_housing/keyword-autocomplete-mcp	https://mutualistic-housing--keyword-autocomplete-mcp.apify.actor/mcp
Discourse Forum Search & Threads MCP	community.openai.com, discuss.huggingface.co, meta.discourse.org + any public Discourse	https://apify.com/mutualistic_housing/discourse-forum-mcp	https://mutualistic-housing--discourse-forum-mcp.apify.actor/mcp
Google Trends Realtime & Entities MCP	i0OFE realtime trends, trending/rss news, Knowledge Graph autocomplete entities	https://apify.com/mutualistic_housing/google-trends-realtime-mcp	https://mutualistic-housing--google-trends-realtime-mcp.apify.actor/mcp