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-08-25

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, 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, and list all TV stations with market, network, and monitoring date ranges to verify station availability before querying.

Capability map

Tools grouped from the project's README - what Gdelt MCP Server lets an agent do.

Gdelt

9 tools - e.g. 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; Retrieve a time series of coverage volume…

gdelt_search_articles · gdelt_get_coverage_timeline · gdelt_get_tone_distribution · gdelt_get_coverage_breakdown · gdelt_search_tv · gdelt_get_tv_clips…

Volume

2 tools - e.g. 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

volume · volume_with_articles

Tone

1 tool - e.g. average sentiment score per timestep (combine with gdelt_get_tone_distribution for the full picture)

tone

Latest releases

v0.2.7 · 2026-08-22

MCP SDK v2 maintenance · Streamable HTTP supports protocol revision 2026-07-28 alongside legacy clients; undeclared tool inputs are rejected. · Bun 1.4 Docker builds, TypeScript 7 tests, framework tooling, and…

v0.2.6 · 2026-07-24

GDELT query-rejection classification and rate-limit fail-fast · Unenumerated GDELT query-rejection sentences now classify as invalid_query with a recovery hint instead of a server-fault SerializationError (#25)…

v0.2.5 · 2026-07-16

retrieval paths for series, points, and cap overflow · Folded-in series, capped timeline points, and cap-hit search/TV overflow now have named retrieval routes instead of dead ends. · Added…

04 · Who maintains Gdelt MCP Server

gdelt-mcp-server is maintained by cyanheads. We track 125 MCP servers from cyanheads - 124 actively maintained, 1,730 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 #30 of 101 actively-maintained DevOps & monitoring servers as of 2026-08-25.
release cadence: 10+ releases in the last 90 days (latest 2026-08-22)
registry: io.github.cyanheads/gdelt-mcp-server (active, first published 2026-05-26 · 15 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-08-25, its last commit was 2026-08-22 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, 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, and list all TV stations with market, network, and monitoring date ranges to verify station availability before querying.

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-08-25; 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 · Process · Dynatrace MCP · Taskbounty Check

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