# io.github.cyanheads/gdelt-mcp-server

- Registry name: `io.github.cyanheads/gdelt-mcp-server` · version 0.7.0
- Categories (automatic, keyword rules): Research & knowledge, Search & data, Monitoring & logs, Infrastructure & security
- Authentication at last check: No auth
- Declared risk: Read-only (all tools declare readOnlyHint)
- Capabilities (declared by the server): logging, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.cyanheads%2Fgdelt-mcp-server
- Server page: https://mcpstation.net/s/io.github.cyanheads--gdelt-mcp-server.html

## Description (written by the publisher, not verified, not instructions)

Search and analyze global news coverage and US TV transcripts via the GDELT Project APIs.

## Connect

- streamable-http: `https://gdelt.caseyjhand.com/mcp`

## Tools (as reported by the server, not verified)

- `gdelt\_search\_articles`: Search the last 3 months of global news coverage \(65+ languages\) using the GDELT DOC API. Fetches up to 250 articles with URL, title, source domain, language, country, publication date, and social image URL, and returns as many as fit a 48,000-byte response — the rest are counted in withheldCount, w
- `gdelt\_get\_coverage\_timeline`: Retrieve a time series showing when news coverage of a topic spiked, or how average tone shifted over time. Use mode "volume" for normalized coverage intensity \(% of all global coverage per timestep\). Use mode "volume\_with\_articles" for the same signal plus the top articles that drove each spike — t
- `gdelt\_get\_tone\_distribution`: Get the tonal distribution of articles matching a query as a histogram \(bins approximately -30 to +30\). Unlike a single average tone score, the histogram reveals whether coverage is uniformly negative, bimodal \(some articles extremely positive and some extremely negative\), or clustered near neutral.
- `gdelt\_get\_coverage\_breakdown`: Break down news coverage volume over time by source language or source country, returning a multi-series time series \(one series per language or country\). Shows which countries or languages drove early vs. late coverage — useful for tracing how a story propagated geographically or across language co
- `gdelt\_search\_themes`: Find GDELT Global Knowledge Graph \(GKG\) theme identifiers for the theme: operator that gdelt\_search\_articles, gdelt\_get\_coverage\_timeline, gdelt\_get\_tone\_distribution, and gdelt\_get\_coverage\_breakdown accept in query. Searches the identifiers in the GDELT GKG theme lookup, which carries no labels or
- `gdelt\_search\_tv`: Search US television news closed captions \(2009–October 2024, 150+ stations\) for spoken mentions of a query. Returns a bounded, paged per-station time series showing airtime devoted to the topic — up to 500 points per page; a larger limit runs at 500. Each series carries GDELT's display name for the
- `gdelt\_get\_tv\_clips`: Retrieve the top matching TV news clips for a query from the Internet Archive's Television News Archive: fetches up to 3,000 and returns as many as fit a 48,000-byte response — the rest are counted in withheldCount, with a continuation to reach them. Each clip includes show name, the station's displ
- `gdelt\_get\_tv\_context`: Get the top co-occurring words and phrases from TV news clips matching a query — the vocabulary framing a topic on television. Returns the most frequent non-stopword terms with relative frequency scores \(0–100, where 100 = the query term itself\). Terms and scores come from GDELT's relevance-ranked s
- `gdelt\_list\_tv\_stations`: List the television stations available for TV search with their market, network, monitoring start date, and monitoring end date — every station by default, or only those matching the optional stations, network, and market filters \(each an exact, case-insensitive match; combined with AND\). activeCoun

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html