Skip to main content
Glama
jain-eshan

Google Trends MCP

by jain-eshan
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
interest_over_timeA

Relative Google search interest (0-100) over time for up to 5 keywords, compared side by side.

Args: keywords: 1-5 search terms to compare. Only the first 5 are used; additional keywords are silently dropped. timeframe: pytrends timeframe string, e.g. "today 12-m", "today 5-y", "now 7-d", or "YYYY-MM-DD YYYY-MM-DD". geo: ISO country code (e.g. "IN", "US"), or "" for worldwide.

Returns: A list of records, one per date, each containing: - "date": ISO date string - "isPartial": boolean indicating if the time period is incomplete (True for the most recent period) - One numeric key per keyword (0-100 relative interest value)

related_queriesA

Top and rising related search queries for a single keyword.

Args: keyword: a single search term. timeframe: pytrends timeframe string, e.g. "today 12-m". geo: ISO country code (e.g. "IN"), or "" for worldwide.

Returns: A dict with two keys, each containing a list of query records: - "top": most-searched related queries. Each record has "query" and "value" (0-100 relative interest on Google Trends scale). - "rising": fastest-growing related queries. Each record has "query" and "value" (percent increase in search interest). IMPORTANT: a value of 5000% is Google's "Breakout" marker, indicating explosive new growth from near-zero baseline, NOT a literal 5000% increase. This is Google's way of saying the data cannot be assigned a meaningful numeric value.

related_topicsA

Top and rising related topics (Google's topic clusters, not raw query strings) for a single keyword.

Args: keyword: a single search term. timeframe: pytrends timeframe string, e.g. "today 12-m". geo: ISO country code (e.g. "IN"), or "" for worldwide.

Returns: A dict with two keys, each containing a list of topic records: - "top": most-searched related topics. Each record has "topic_title", "topic_type", "value" (0-100 relative interest on Google Trends scale). - "rising": fastest-growing related topics. Each record has "topic_title", "topic_type", "value". IMPORTANT: a value of 5000% is Google's "Breakout" marker, indicating explosive new growth from near-zero baseline, NOT a literal 5000% increase. This is the same convention as "rising" queries.

interest_by_regionA

Search interest for a keyword broken down by state/region within the given geo.

Args: keyword: a single search term. timeframe: pytrends timeframe string, e.g. "today 12-m". geo: ISO country code (e.g. "IN"), or "" for worldwide.

Returns: A list of records, one per state/region within the specified geo, each containing: - "geoName": the name of the state or region (e.g. "Maharashtra", "Delhi", "Karnataka" for India) - A column with the keyword name as the key: relative search interest (0-100 scale) for that region. Higher values indicate higher relative interest in that region compared to others in the same country. This is Google Trends' standard region-relative scale.

trending_nowA

Today's top trending searches for a country.

Args: geo: full lowercase country name as used by Google Trends' trending-searches endpoint, e.g. "india", "united_states" — NOT an ISO code (unlike the other 4 tools in this server).

Returns: A list of trending search term strings, ordered by trend rank (most-trending first). Typically contains approximately 20 terms.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources