gdelt-mcp-server
Search and analyze global news coverage and US TV transcripts via the GDELT Project APIs
Reviews
No review yet. Used gdelt-mcp-server? Be the first to help others choose.What it does
gdelt-mcp-server is an MCP server, a connector that lets an AI assistant use it as a tool. It can be used hosted (nothing to install) or installed locally.
No capability identified yet from its description.
Facts come from the Official MCP Registry, as declared by the publisher. Capabilities are matched automatically (low confidence). None of this is a test of the tool.
At a glance
How to connect
As declared in the Official MCP Registry · hosted endpoint tested by Electra Index 9h ago (live check)Hosted endpoint
https://gdelt.caseyjhand.com/mcpstreamable-http
In Claude Code: claude mcp add --transport http gdelt-mcp-server https://gdelt.caseyjhand.com/mcp
Install packages
- NPM
@cyanheads/gdelt-mcp-serverv0.10.0 · runs locally (stdio) - NPM
@cyanheads/gdelt-mcp-serverv0.10.0 · runs as a server (streamable-http)
MCP settings (Claude Desktop, Cursor and other MCP clients)
{
"mcpServers": {
"gdelt-mcp-server": {
"url": "https://gdelt.caseyjhand.com/mcp"
}
}
}Live check
Electra Index connected to the hosted endpoint 9h agoONLINE gdelt-mcp-server answered an MCP connection on 17 Nov 2026 and introduced itself as gdelt-mcp-server 0.10.0 (MCP protocol 2025-06-18).
11 tools offered to AI assistants
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, the date GDELT saw each one, and social image URL, and returns every fetgdelt_search_sentences· Search the sentences of the last 72 hours of English-language news coverage with the GDELT Context 2.0 API, to read what coverage actually said. Every query term must fall inside one sentence; each match returns that sentence, the text arougdelt_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 "volume_raw" for distinct matching-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 positgdelt_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 tracinggdelt_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 identifiegdelt_search_tv· Search television news closed captions for spoken mentions of a query. Returns a bounded, paged per-station time series showing airtime devoted to the topic — 500 points by default, up to 20,000 per page. Each series carries GDELT's displaygdelt_get_tv_breakdown· Rank TV stations or shows mentioning a query. Station values are percentages of each station’s monitored airtime, or raw matching 15-second clip counts with normalize=false. Show values always represent percentages of matching clips, even wgdelt_get_tv_clips· Retrieve the top matching TV news clips for a query from the Internet Archive's Television News Archive: returns every fetched in-window clip, up to 3,000. Each clip includes show name, the station's display name — with its station ID whengdelt_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 itgdelt_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 e
What "online" means: the server answered an MCP connection at the time of the check. It is not a guarantee of security, quality or continuous uptime. How we test: we open an MCP session and ask for the tool list, as an AI assistant would. We never run a tool and never send a key. Checked every few days. Method
Is this your server? Monitoring Pro: a check every 30 minutes and an email within the hour when it stops answering. Launch offer: $39.99 once, for life.
Facts & evidence
Each fact shows where it was seen and when.| Fact | Value | Evidence | Source | Last confirmed |
|---|---|---|---|---|
| Install package | @cyanheads/gdelt-mcp-server, @cyanheads/gdelt-mcp-server | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Version | 0.10.0 | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Hosted endpoint | https://gdelt.caseyjhand.com/mcp | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Package registries | npm | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Local install (package) | yes | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Remote access (hosted) | yes | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Repository | https://github.com/cyanheads/gdelt-mcp-server | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Registry status | active | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| MCP server | yes | DECLARED | SRC-001 Official MCP Registry | 1d ago |
Change history
- VERSION14 Nov 20260.9.0 → 0.10.0
- VERSION10 Nov 20260.8.1 → 0.9.0
- VERSION01 Nov 20260.8.0 → 0.8.1
- VERSION01 Nov 20260.7.0 → 0.8.0
- VERSION14 Oct 20260.6.1 → 0.7.0
- VERSION07 Oct 20260.6.0 → 0.6.1
Is this page accurate?
Flag it and our robot re-checks the official source. Reports never change a score.Is gdelt-mcp-server still online?
Free alerts · no account▲ 0Do you run gdelt-mcp-server? Know when it stops answering
For publishers · optionalIts hosted endpoint can be monitored. Monitoring Pro connects every 30 minutes like an AI assistant, emails you within the hour when it stops answering, keeps a 90-day availability history and adds your answer rate to your badge.
Monitoring never changes a score or a rank.
Questions about gdelt-mcp-server
How do I connect gdelt-mcp-server?
Use the hosted endpoint https://gdelt.caseyjhand.com/mcp in your assistant's MCP settings. The exact settings are in "How to connect" above, as declared in the Official MCP Registry.
What tools does gdelt-mcp-server offer?
When Electra Index connected on 17 Nov 2026, it listed 11 tools: gdelt_search_articles, gdelt_search_sentences, gdelt_get_coverage_timeline, gdelt_get_tone_distribution, gdelt_get_coverage_breakdown, gdelt_search_themes, gdelt_search_tv, gdelt_get_tv_breakdown and more. The full list is in "Live check" above.
Is gdelt-mcp-server online?
Yes. Its hosted endpoint answered an MCP connection from Electra Index 9h ago.