Gdelt MCP Server - install, status & alternatives [2026]

01 · Install Gdelt MCP Server

before you install - you'll need

Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL before connecting.

Claude Code

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

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://gdelt.caseyjhand.com/mcp

transport: streamable-http

endpoint alive - responded to MCP initialize · probed 2026-09-30

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · remote - your agent's requests go to gdelt.caseyjhand.com

endpoint auth accepted our unauthenticated MCP initialize - no credentials needed to connect

license Apache-2.0 - declared in the repository

npm package @cyanheads/gdelt-mcp-server - published under the repo owner's npm scope (@cyanheads)

registry namespace io.github.cyanheads is GitHub-verified and matches the repo owner

03 · What Gdelt MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get a tone histogram (bins ~−30 to +30) showing whether coverage is uniformly negative, bimodal, or clustered near neutral, and get the most frequent co-occurring words and phrases from TV clips matching a query.

The 9 tools it gives your agent

Extracted from the project's README - what gdelt-mcp-server lets an agent do.

gdelt_search_articles: - Search the last 3 months of global news coverage (65+ languages) with full-text and filter operators. Fetches up to 250 articles, returns as many as fit a 48,00
gdelt_get_coverage_timeline: - Retrieve a time series of coverage volume or average tone for a query. volume_with_articles mode includes top articles per spike timestep, with points to render
gdelt_get_tone_distribution: - Get a tone histogram (bins ~−30 to +30) showing whether coverage is uniformly negative, bimodal, or clustered near neutral.
gdelt_get_coverage_breakdown: - Break down coverage volume by source language or source country - a multi-series time series showing geographic propagation. Values are normalized shares of med
gdelt_search_themes: - Find GKG theme identifiers for the theme: operator the DOC tools accept - drought finds NATURAL_DISASTER_DROUGHT, cyberattack finds CYBER_ATTACK - ranked by the
gdelt_search_tv: - Search US television news closed captions (2009–Oct 2024) and return per-station airtime time series.
gdelt_get_tv_clips: - Retrieve matching TV clips with transcript excerpts and Internet Archive viewing links - up to 3,000 fetched, as many as fit a 48,000-byte response returned - a
gdelt_get_tv_context: - Get the most frequent co-occurring words and phrases from TV clips matching a query.
gdelt_list_tv_stations: - List TV stations with market, network, and monitoring date ranges - all of them, or filtered by station ID, network, or market - to verify station availability

Latest releases

v0.6.0 · 2026-09-24

GKG theme discovery with gdelt_search_themes · gdelt_search_themes - finds GKG theme identifiers for the theme: operator in GDELT's theme lookup, each with its listed count and a paste-ready operator; token-prefix…

v0.5.0 · 2026-09-24

Retire TV trending; empty results, escaping, byte budget · gdelt_get_tv_trending retired - its upstream endpoint has returned empty topic lists since the TV archive froze in October 2024 (#33) · zero-match queries on…

v0.4.3 · 2026-09-22

request deadlines, completion-relative pacing, date-window validation · Exhausted GDELT timeouts now classify as gdelt_unavailable instead of an undeclared Timeout (#42, #39) · GDELT pacer spaces requests from the…

04 · Who maintains Gdelt MCP Server

gdelt-mcp-server is maintained by cyanheads. We track 137 MCP servers from cyanheads - 131 actively maintained, 1,856 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from cyanheads.

05 · Facts

repository: github.com/cyanheads/gdelt-mcp-server
category: DevOps & monitoring - ranked #21 of 125 actively-maintained DevOps & monitoring servers as of 2026-09-30.
release cadence: 10+ releases in the last 90 days (latest 2026-09-24)
registry: io.github.cyanheads/gdelt-mcp-server (active, first published 2026-05-26 · 23 versions)
packages: npm:@cyanheads/gdelt-mcp-server · npm:@cyanheads/gdelt-mcp-server

06 · Gdelt MCP Server FAQ

Is Gdelt MCP Server still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-24 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Gdelt MCP Server do?

With this server connected, an agent can get a tone histogram (bins ~−30 to +30) showing whether coverage is uniformly negative, bimodal, or clustered near neutral, and get the most frequent co-occurring words and phrases from TV clips matching a query.

How do I install Gdelt MCP Server?

Run `npx -y @cyanheads/gdelt-mcp-server`. The README documents 2 environment variables (MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL) to set first. Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL before connecting. You can also paste the ready-made client config above.

Does Gdelt MCP Server require authentication?

No - the endpoint accepted our unauthenticated MCP initialize when probed on 2026-09-30; you can connect without credentials.

07 · Alternatives to Gdelt MCP Server

Alternatives to Gdelt MCP Server

Maintained DevOps & monitoring servers if Gdelt MCP Server isn't the fit.

Pairs well with

Servers that cover what Gdelt MCP Server doesn't - only shown when the pairing reason fits the companion.

More DevOps & monitoring MCP servers · Openaq MCP Server · Uptime Kuma · GCP Platform Engineer · Process · Dynatrace

More TypeScript MCP servers · Git MCP Server · Guardian MCP Server · Gutenberg MCP Server · Hn MCP Server · Internet Archive MCP Server · see all