Google News & Trends MCP

Official16 tools

by AKzar1el · Python

Query Google News RSS feeds and search interest over time via Google Trends.

Topics

data-scrapinggoogle-newsgoogle-trendsmcp-servermodel-context-protocolnlppythontrends-analysis

Declared in the repository manifest (server.json). Not verified against a live endpoint.

get_news_by_keyword

Find articles by keyword using Google News.

Parameters5

keyword	string	required	Search term to find articles.
period	integer	optional	Number of days to look back for articles.
max_results	integer	optional	Maximum number of results to return.
full_data	boolean	optional	Return full data for each article. If False a summary should be created by setting the summarize flag
summarize	boolean	optional	Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "keyword": {
      "description": "Search term to find articles.",
      "type": "string"
    },
    "period": {
      "default": 7,
      "description": "Number of days to look back for articles.",
      "minimum": 1,
      "type": "integer"
    },
    "max_results": {
      "default": 10,
      "description": "Maximum number of results to return.",
      "minimum": 1,
      "type": "integer"
    },
    "full_data": {
      "default": false,
      "description": "Return full data for each article. If False a summary should be created by setting the summarize flag",
      "type": "boolean"
    },
    "summarize": {
      "default": true,
      "description": "Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp",
      "type": "boolean"
    }
  },
  "required": [
    "keyword"
  ],
  "type": "object"
}

get_news_by_location

Find articles by location using Google News.

Parameters5

location	string	required	Name of city/state/country.
period	integer	optional	Number of days to look back for articles.
max_results	integer	optional	Maximum number of results to return.
full_data	boolean	optional	Return full data for each article. If False a summary should be created by setting the summarize flag
summarize	boolean	optional	Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "location": {
      "description": "Name of city/state/country.",
      "type": "string"
    },
    "period": {
      "default": 7,
      "description": "Number of days to look back for articles.",
      "minimum": 1,
      "type": "integer"
    },
    "max_results": {
      "default": 10,
      "description": "Maximum number of results to return.",
      "minimum": 1,
      "type": "integer"
    },
    "full_data": {
      "default": false,
      "description": "Return full data for each article. If False a summary should be created by setting the summarize flag",
      "type": "boolean"
    },
    "summarize": {
      "default": true,
      "description": "Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp",
      "type": "boolean"
    }
  },
  "required": [
    "location"
  ],
  "type": "object"
}

get_news_by_topic

Find articles by topic using Google News. topic is one of WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH, POLITICS, CELEBRITIES, TV, MUSIC, MOVIES, THEATER, SOCCER, CYCLING, MOTOR SPORTS, TENNIS, COMBAT SPORTS, BASKETBALL, BASEBALL, FOOTBALL, SPORTS BETTING, WATER SPORTS, HOCKEY, GOLF, CRICKET, RUGBY, ECONOMY, PERSONAL FINANCE, FINANCE, DIGITAL CURRENCIES, MOBILE, ENERGY, GAMING, INTERNET SECURITY, GADGETS, VIRTUAL REALITY, ROBOTICS, NUTRITION, PUBLIC HEALTH, MENTAL HEALTH, MEDICINE, SPACE, WILDLIFE, ENVIRONMENT, NEUROSCIENCE, PHYSICS, GEOLOGY, PALEONTOLOGY, SOCIAL SCIENCES, EDUCATION, JOBS, ONLINE EDUCATION, HIGHER EDUCATION, VEHICLES, ARTS-DESIGN, BEAUTY, FOOD, TRAVEL, SHOPPING, HOME, OUTDOORS, FASHION.

Parameters5

topic	string	required	Topic to search for articles.
period	integer	optional	Number of days to look back for articles.
max_results	integer	optional	Maximum number of results to return.
full_data	boolean	optional	Return full data for each article. If False a summary should be created by setting the summarize flag
summarize	boolean	optional	Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "topic": {
      "description": "Topic to search for articles.",
      "type": "string"
    },
    "period": {
      "default": 7,
      "description": "Number of days to look back for articles.",
      "minimum": 1,
      "type": "integer"
    },
    "max_results": {
      "default": 10,
      "description": "Maximum number of results to return.",
      "minimum": 1,
      "type": "integer"
    },
    "full_data": {
      "default": false,
      "description": "Return full data for each article. If False a summary should be created by setting the summarize flag",
      "type": "boolean"
    },
    "summarize": {
      "default": true,
      "description": "Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp",
      "type": "boolean"
    }
  },
  "required": [
    "topic"
  ],
  "type": "object"
}

get_top_news

Get top news stories from Google News.

Parameters4

period	integer	optional	Number of days to look back for top articles.
max_results	integer	optional	Maximum number of results to return.
full_data	boolean	optional	Return full data for each article. If False a summary should be created by setting the summarize flag
summarize	boolean	optional	Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "period": {
      "default": 3,
      "description": "Number of days to look back for top articles.",
      "minimum": 1,
      "type": "integer"
    },
    "max_results": {
      "default": 10,
      "description": "Maximum number of results to return.",
      "minimum": 1,
      "type": "integer"
    },
    "full_data": {
      "default": false,
      "description": "Return full data for each article. If False a summary should be created by setting the summarize flag",
      "type": "boolean"
    },
    "summarize": {
      "default": true,
      "description": "Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp",
      "type": "boolean"
    }
  },
  "type": "object"
}

get_trending_terms

Returns google trends for a specific geo location.

Parameters2

geo	string	optional	Geographic target for trending terms. Supports four levels of granularity: - Worldwide: empty string '' - Country: ISO 3166-1 alpha-2 code, e.g. 'US', 'GB', 'CA' - Subdivision (state/province/region): ISO 3166-2 format 'CC-XX' or 'CC-XXX', e.g. 'US-CA' (California), 'BE-BRU' (Brussels) - US metro area: bare Nielsen DMA code (numeric string), e.g. '807' (San Francisco Bay Area), '501' (New York City)
full_data	boolean	optional	Return full data for each trend including related news stories.

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "geo": {
      "default": "US",
      "description": "Geographic target for trending terms. Supports four levels of granularity:\n- Worldwide: empty string ''\n- Country: ISO 3166-1 alpha-2 code, e.g. 'US', 'GB', 'CA'\n- Subdivision (state/province/region): ISO 3166-2 format 'CC-XX' or 'CC-XXX', e.g. 'US-CA' (California), 'BE-BRU' (Brussels)\n- US metro area: bare Nielsen DMA code (numeric string), e.g. '807' (San Francisco Bay Area), '501' (New York City)",
      "type": "string"
    },
    "full_data": {
      "default": false,
      "description": "Return full data for each trend including related news stories.",
      "type": "boolean"
    }
  },
  "type": "object"
}

get_trends

Pull search interest over time for keywords.

Parameters4

keyword	any	required	Search keyword(s) to analyze.
source	string	optional	Search source: 'google search', 'youtube search', 'news search', 'image search', 'google shopping'.
data_mode	string	optional	Resolution of data: 'weekly', 'daily', 'monthly'.
geo	string	optional	Geographic region code (e.g. 'US').

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Search keyword(s) to analyze."
    },
    "source": {
      "default": "google search",
      "description": "Search source: 'google search', 'youtube search', 'news search', 'image search', 'google shopping'.",
      "type": "string"
    },
    "data_mode": {
      "default": "weekly",
      "description": "Resolution of data: 'weekly', 'daily', 'monthly'.",
      "type": "string"
    },
    "geo": {
      "default": "US",
      "description": "Geographic region code (e.g. 'US').",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "type": "object"
}

get_growth

Measure interest growth over specified windows.

Parameters4

keyword	any	required	Search keyword(s) to analyze.
source	string	optional	Search source: 'google search', 'youtube search', etc.
percent_growth	array	optional	Timeframes to calculate growth (e.g. ['3M', '1Y']).
geo	string	optional	Geographic region code (e.g. 'US').

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Search keyword(s) to analyze."
    },
    "source": {
      "default": "google search",
      "description": "Search source: 'google search', 'youtube search', etc.",
      "type": "string"
    },
    "percent_growth": {
      "default": null,
      "description": "Timeframes to calculate growth (e.g. ['3M', '1Y']).",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "geo": {
      "default": "US",
      "description": "Geographic region code (e.g. 'US').",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "type": "object"
}

get_ranked_trends

Get ranked trending keywords on Google Search.

Parameters4

source	string	optional	Search source: 'google search'.
sort	string	optional	Field to sort by: 'wow_pct_change', 'volume'.
limit	integer	optional	Maximum number of trends to return.
geo	string	optional	Geographic region code (e.g. 'US').

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "source": {
      "default": "google search",
      "description": "Search source: 'google search'.",
      "type": "string"
    },
    "sort": {
      "default": "wow_pct_change",
      "description": "Field to sort by: 'wow_pct_change', 'volume'.",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of trends to return.",
      "minimum": 1,
      "type": "integer"
    },
    "geo": {
      "default": "US",
      "description": "Geographic region code (e.g. 'US').",
      "type": "string"
    }
  },
  "type": "object"
}

get_top_trends

Get top trends using RSS trending feeds.

Parameters3

type	string	optional	Type of trends: 'Google Trends' (realtime), 'Daily Trends' (daily).
limit	integer	optional	Maximum number of trends to return.
geo	string	optional	Geographic region code (e.g. 'US').

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "type": {
      "default": "Google Trends",
      "description": "Type of trends: 'Google Trends' (realtime), 'Daily Trends' (daily).",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of trends to return.",
      "minimum": 1,
      "type": "integer"
    },
    "geo": {
      "default": "US",
      "description": "Geographic region code (e.g. 'US').",
      "type": "string"
    }
  },
  "type": "object"
}

get_news_by_site

Find articles from a specific publisher site using Google News.

Parameters5

site	string	required	Domain of the news site, e.g. 'cnn.com'.
period	integer	optional	Number of days to look back for articles.
max_results	integer	optional	Maximum number of results to return.
full_data	boolean	optional	Return full data for each article. If False a summary should be created by setting the summarize flag
summarize	boolean	optional	Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "site": {
      "description": "Domain of the news site, e.g. 'cnn.com'.",
      "type": "string"
    },
    "period": {
      "default": 7,
      "description": "Number of days to look back for articles.",
      "minimum": 1,
      "type": "integer"
    },
    "max_results": {
      "default": 10,
      "description": "Maximum number of results to return.",
      "minimum": 1,
      "type": "integer"
    },
    "full_data": {
      "default": false,
      "description": "Return full data for each article. If False a summary should be created by setting the summarize flag",
      "type": "boolean"
    },
    "summarize": {
      "default": true,
      "description": "Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp",
      "type": "boolean"
    }
  },
  "required": [
    "site"
  ],
  "type": "object"
}

get_article_content

Download, scrape and parse the content of a specific news article from a given URL.

Parameters3

url	string	required	The URL of the news article to download and parse.
full_data	boolean	optional	Return full data for the article. If False a summary should be created by setting the summarize flag
summarize	boolean	optional	Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "url": {
      "description": "The URL of the news article to download and parse.",
      "type": "string"
    },
    "full_data": {
      "default": false,
      "description": "Return full data for the article. If False a summary should be created by setting the summarize flag",
      "type": "boolean"
    },
    "summarize": {
      "default": true,
      "description": "Generate a summary of the article, will first try LLM Sampling but if unavailable will use nlp",
      "type": "boolean"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}

get_interest_by_region

Retrieves geographical interest data based on keywords and other parameters.

Parameters7

keywords	any	required	Search keyword(s) to analyze.
timeframe	string	optional	Timeframe for search volume analysis (e.g., 'today 12-m').
geo	string	optional	Geographic region code (e.g. 'US' or empty '' for worldwide).
cat	integer	optional	Category ID (default: 0 for all).
gprop	string	optional	Google property filter (e.g., '', 'youtube', 'news', 'images', 'froogle').
resolution	string	optional	Geographic resolution: 'COUNTRY', 'REGION', 'CITY', or 'DMA'.
inc_low_vol	boolean	optional	Include regions with low search volume.

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "keywords": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Search keyword(s) to analyze."
    },
    "timeframe": {
      "default": "today 12-m",
      "description": "Timeframe for search volume analysis (e.g., 'today 12-m').",
      "type": "string"
    },
    "geo": {
      "default": "US",
      "description": "Geographic region code (e.g. 'US' or empty '' for worldwide).",
      "type": "string"
    },
    "cat": {
      "default": 0,
      "description": "Category ID (default: 0 for all).",
      "type": "integer"
    },
    "gprop": {
      "default": "",
      "description": "Google property filter (e.g., '', 'youtube', 'news', 'images', 'froogle').",
      "type": "string"
    },
    "resolution": {
      "default": "REGION",
      "description": "Geographic resolution: 'COUNTRY', 'REGION', 'CITY', or 'DMA'.",
      "type": "string"
    },
    "inc_low_vol": {
      "default": false,
      "description": "Include regions with low search volume.",
      "type": "boolean"
    }
  },
  "required": [
    "keywords"
  ],
  "type": "object"
}

get_related_queries

Retrieves related queries for a single search term.

Parameters5

keyword	string	required	Search keyword to analyze.
timeframe	string	optional	Timeframe for search volume analysis (e.g., 'today 12-m').
geo	string	optional	Geographic region code (e.g. 'US').
cat	integer	optional	Category ID (default: 0 for all).
gprop	string	optional	Google property filter (e.g., '', 'youtube', 'news', 'images', 'froogle').

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "keyword": {
      "description": "Search keyword to analyze.",
      "type": "string"
    },
    "timeframe": {
      "default": "today 12-m",
      "description": "Timeframe for search volume analysis (e.g., 'today 12-m').",
      "type": "string"
    },
    "geo": {
      "default": "US",
      "description": "Geographic region code (e.g. 'US').",
      "type": "string"
    },
    "cat": {
      "default": 0,
      "description": "Category ID (default: 0 for all).",
      "type": "integer"
    },
    "gprop": {
      "default": "",
      "description": "Google property filter (e.g., '', 'youtube', 'news', 'images', 'froogle').",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "type": "object"
}

get_related_topics

Retrieves related topics for a single search term.

Parameters5

keyword	string	required	Search keyword to analyze.
timeframe	string	optional	Timeframe for search volume analysis (e.g., 'today 12-m').
geo	string	optional	Geographic region code (e.g. 'US').
cat	integer	optional	Category ID (default: 0 for all).
gprop	string	optional	Google property filter (e.g., '', 'youtube', 'news', 'images', 'froogle').

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "keyword": {
      "description": "Search keyword to analyze.",
      "type": "string"
    },
    "timeframe": {
      "default": "today 12-m",
      "description": "Timeframe for search volume analysis (e.g., 'today 12-m').",
      "type": "string"
    },
    "geo": {
      "default": "US",
      "description": "Geographic region code (e.g. 'US').",
      "type": "string"
    },
    "cat": {
      "default": 0,
      "description": "Category ID (default: 0 for all).",
      "type": "integer"
    },
    "gprop": {
      "default": "",
      "description": "Google property filter (e.g., '', 'youtube', 'news', 'images', 'froogle').",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "type": "object"
}

get_suggestions

Retrieves autocomplete suggestions for a search term.

Parameters2

keyword	string	required	Query string to autocomplete.
language	any	optional	Language code, e.g. 'en'.

Raw schema

{
  "additionalProperties": false,
  "properties": {
    "keyword": {
      "description": "Query string to autocomplete.",
      "type": "string"
    },
    "language": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Language code, e.g. 'en'."
    }
  },
  "required": [
    "keyword"
  ],
  "type": "object"
}

get_categories

Retrieves category list from Google Trends.

Parameters

No parameters.

Raw schema

{
  "additionalProperties": false,
  "properties": {},
  "type": "object"
}

README.md8 KBView on GitHub

mcp-trendpulse

A powerful, robust Model Context Protocol (MCP) server that connects AI models to Google News RSS feeds and Google Trends. Easily pull historical weekly interest curves, calculate keyword growth rates, fetch trending queries, and analyze/summarize related articles using LLMs and NLP.

Features

Google News Integration: Trawl feeds for articles by keyword, location, or topic, and fetch top news stories.
Advanced Trends Analysis: Pull 5 years of weekly interest history, calculate growth velocities over custom windows, and retrieve real-time trending keywords.
NLP & LLM Summarization: Summarize article payloads and extract key concepts using client-side LLM sampling or local NLP.
Windows-Safe & Robust: Fully handles local session state, rates limits, and includes a fallback mechanism for sites that are difficult to scrape.

Installation

Using uv/uvx (recommended)

When using uv no specific installation is needed. We will use uvx to directly run mcp-trendpulse.

Using PIP

bash

pip install mcp-trendpulse

After installation, you can run it as a script using:

bash

python -m mcp_trendpulse

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx

json

{
  "mcpServers": {
    "mcp-trendpulse": {
      "command": "uvx",
      "args": ["mcp-trendpulse@latest"]
    }
  }
}

Using pip installation

json

{
  "mcpServers": {
    "mcp-trendpulse": {
      "command": "python",
      "args": ["-m", "mcp_trendpulse"]
    }
  }
}

Configure for VS Code

Using uvx

json

{
  "mcp": {
    "servers": {
      "mcp-trendpulse": {
        "command": "uvx",
        "args": ["mcp-trendpulse@latest"]
      }
    }
  }
}

Using pip installation

json

{
  "mcp": {
    "servers": {
      "mcp-trendpulse": {
        "command": "python",
        "args": ["-m", "mcp_trendpulse"]
      }
    }
  }
}

Configure for Cursor Editor

Cursor supports MCP configuration globally or per-project:

Global Config: Edit %USERPROFILE%\.cursor\mcp.json (Windows) or ~/.cursor/mcp.json (macOS/Linux).
Project Config: Create a .cursor/mcp.json file inside your project root.

Add the following to the mcpServers object:

json

{
  "mcpServers": {
    "mcp-trendpulse": {
      "command": "python",
      "args": ["-m", "mcp_trendpulse"]
    }
  }
}

(Alternatively, you can open Cursor Settings -> Features -> MCP, and click "Add New Global MCP Server" to set it up via the UI).

Configure for Gemini / Antigravity IDE

If you are pair programming with Gemini in Antigravity IDE, add the server to your settings file at %APPDATA%\.gemini\antigravity-ide\mcp_config.json:

json

{
  "mcpServers": {
    "mcp-trendpulse": {
      "command": "python",
      "args": ["-m", "mcp_trendpulse"]
    }
  }
}

Configure for ChatGPT (OpenAI)

Because ChatGPT resides in the cloud, it requires your local MCP server to be exposed via a secure HTTPS tunnel (e.g., using ngrok or similar):

Expose Server via Tunnel: Start your local MCP server using an HTTP/SSE bridge or expose its stdio endpoint using a secure tunnel tool.
Enable Developer Mode in ChatGPT: Open the ChatGPT desktop app, go to Settings → Apps & Connectors, and toggle on Developer Mode.
Register the Connector: Click + New Server (or "Create Connector") and paste the public HTTPS URL where your tunnel is hosted.

Environment Variables and Proxies

If you experience rate limits (429 Client Error) from Google Trends, or if your server is running in an environment without direct internet access, you can configure environment variables and proxies in one of two ways:

Option A: Using a `.env` file (Recommended)

You can create a .env file in the workspace directory (where the server is executed) and define the variables there. The server will automatically load them at startup:

env

HTTP_PROXY=http://your-proxy-address:port
HTTPS_PROXY=http://your-proxy-address:port
GOOGLE_TRENDS_DELAY=2.0

Option B: Injecting via the client configuration

You can add environment variables directly to the "env" object in your Claude Desktop or VS Code JSON configuration:

json

      "env": {
        "HTTP_PROXY": "http://your-proxy-address:port",
        "HTTPS_PROXY": "http://your-proxy-address:port",
        "GOOGLE_TRENDS_DELAY": "2.0"
      }

On Windows, it is also recommended to pass system environment variables like PATH, USERPROFILE, LOCALAPPDATA, and APPDATA under the "env" block to ensure that internal Chromium browsers (used by Playwright) resolve and execute correctly:

json

      "env": {
        "PATH": "C:\\Windows\\system32;C:\\Windows;C:\\Windows\\System32\\Wbem;C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\;C:\\Users\\<Username>\\AppData\\Local\\Microsoft\\WindowsApps;C:\\Users\\<Username>\\AppData\\Local\\Programs\\uv",
        "USERPROFILE": "C:\\Users\\<Username>",
        "LOCALAPPDATA": "C:\\Users\\<Username>\\AppData\\Local",
        "APPDATA": "C:\\Users\\<Username>\\AppData\\Roaming"
      }

Tools

The following MCP tools are available:

Tool Name	Description
get_news_by_keyword	Search for news using specific keywords.
get_news_by_location	Retrieve news relevant to a particular location.
get_news_by_topic	Get news based on a chosen topic.
get_top_news	Fetch the top news stories from Google News.
get_trending_terms	Return trending keywords from Google Trends for a specified location.
get_trends	Pull 5 years of weekly Google Search interest for a keyword to inspect growth/seasonality curves.
get_growth	Measure how much search interest changed over custom periods (e.g. 3M, 1Y) and compare growth side-by-side.
get_ranked_trends	Get a ranked list of the highest-volume or fastest-growing keywords on Google Search right now.
get_top_trends	Discover top trending topics on Google Trends right now without requiring a keyword query.

All of the news related tools have an option to summarize the text of the article using LLM Sampling (if supported) or NLP

CLI

All tools can be accessed from the command line using uv

bash

uv run mcp-trendpulse
Usage: mcp-trendpulse [OPTIONS] COMMAND [ARGS]...

  Find and download news articles using Google News.

Options:
  --help  Show this message and exit.

Commands:
  keyword   Find articles by keyword using Google News.
  location  Find articles by location using Google News.
  top       Get top news stories from Google News.
  topic     Find articles by topic using Google News.
  trending  Returns google trends for a specific geo location.

Debugging

bash

npx @modelcontextprotocol/inspector uvx mcp-trendpulse

To run from within locally installed project:

bash

cd path/to/mcp-trendpulse
npx @modelcontextprotocol/inspector uv run mcp-trendpulse

Testing

bash

cd path/to/mcp-trendpulse
python -m pytest

Topics

get_news_by_keyword

get_news_by_location

get_news_by_topic

get_top_news

get_trending_terms

get_trends

get_growth

get_ranked_trends

get_top_trends

get_news_by_site

get_article_content

get_interest_by_region

get_related_queries

get_related_topics

get_suggestions

get_categories

mcp-trendpulse

Features

Installation

Using uv/uvx (recommended)

Using PIP

Configuration

Configure for Claude.app

Configure for VS Code

Configure for Cursor Editor

Configure for Gemini / Antigravity IDE

Configure for ChatGPT (OpenAI)

Environment Variables and Proxies

Option A: Using a .env file (Recommended)

Option B: Injecting via the client configuration

Tools

CLI

Debugging

Testing

Install

Option A: Using a `.env` file (Recommended)