MCP server

Gdelt

io.github.cyanheads/gdelt-mcp-server

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Working at last checkAbout 7,302 tokens per request once connected9 tools

Source

https://gdelt.caseyjhand.com/mcp

At a glance

Type: MCP server
Publisher: Not verified
Status: Working at last check
Tools: 9
Token cost: About 7,302 tokens per request
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok
Last checked: 26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http gdelt-mcp-server https://gdelt.caseyjhand.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.gdelt-mcp-server]
url = "https://gdelt.caseyjhand.com/mcp"

Gemini CLI

{"mcpServers":{"gdelt-mcp-server":{"httpUrl":"https://gdelt.caseyjhand.com/mcp"}}}

Cursor

{"mcpServers":{"gdelt-mcp-server":{"url":"https://gdelt.caseyjhand.com/mcp"}}}

VS Code

{"servers":{"gdelt-mcp-server":{"type":"http","url":"https://gdelt.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add gdelt-mcp-server https://gdelt.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"gdelt-mcp-server","server_url":"https://gdelt.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"gdelt-mcp-server","server_url":"https://gdelt.caseyjhand.com/mcp"}

Tools

gdelt_get_coverage_breakdown ~954 tokens
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_get_coverage_timeline ~1010 tokens
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 ~790 tokens
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_tv_clips ~897 tokens
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 ~596 tokens
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 ~530 tokens
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
gdelt_search_articles ~888 tokens
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_search_themes ~640 tokens
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 ~997 tokens
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

Browse

Related MCP servers

Gdelt
GDELT MCP — Global Database of Events, Language, and Tone (free, no auth)
Geotone — Global News Signals
Live global news signals: ranked wire, story timelines, coverage volume/tone/surges. Free, no auth.
China News
China / Hong Kong / Taiwan news search.
ExchangeRebel — pay-per-call APIs for AI agents (x402 on Solana)
166 pay-per-call APIs for AI agents: market, company, dev + verification tools — x402 on Solana.
The Stall
277 pay-per-call MCP tools: YouTube keyword research, stocks, crypto, DeFi, options, macro.
FreshContext
Context integrity for AI agents: evaluate freshness, confidence, provenance, and decision readiness.
Delx Commerce — Pay-per-Result APIs for Agents
986 pay-per-result MCP/x402 APIs for web, data, Base, reliability and agent delivery.
Agent Tools API
YouTube transcripts, open jobs from careers pages, app store reviews and X posts for AI agents.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/gdelt-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/gdelt-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents