gdelt_search_articles
Search the last 3 months of global news coverage (65 languages) with full-text and filter operators. Returns up to 250 articles, and hands back the date windows to re-query when that ceiling is hit.
How to use it
gdelt_search_articles is exposed by the Gdelt MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the gdelt_search_articles tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Gdelt MCP Server
docker run --rm -p 3010:3010 gdelt-mcp-serverOther tools in Gdelt MCP Server (12)
Break down coverage volume by source language or source country — a multi-series time series showing geographic propagation. Values are normalized shares of media output, not article counts.
Retrieve a time series of coverage volume or average tone for a query. volumewitharticles mode includes top articles per spike timestep, with points to render a timestep's full article list.
Get a tone histogram (bins ~−30 to +30) showing whether coverage is uniformly negative, bimodal, or clustered near neutral.
Retrieve up to 3,000 matching TV clips with transcript excerpts and Internet Archive viewing links, and the date windows to re-query when that ceiling is hit.
Get the most frequent co-occurring words and phrases from TV clips matching a query.
Retrieve trending topics currently dominating US television news (updated every 15 minutes; no query required).
List all TV stations with market, network, and monitoring date ranges to verify station availability before querying.
Search US television news closed captions (2009–Oct 2024) and return per-station airtime time series.
flag — true when end date is within the last 24 hours
average sentiment score per timestep (combine with gdeltgettonedistribution for the full picture)
normalized percentage of all global coverage per timestep
volume plus top articles driving each spike; use for signal detection without a follow-up search call