Index / MCP servers / Gdelt

Gdelt MCP server

Gdelt is a remote MCP server that gives an AI agent 9 tools, among them gdelt_get_coverage_breakdown, gdelt_get_coverage_timeline, gdelt_get_tone_distribution. It answers at https://gdelt.caseyjhand.com/mcp over streamable HTTP, and it listed its tools to an anonymous client, so no sign-in was needed for that. Our probes reached it 6 of 6 times since 11 September 2026; the last check, on 21 October 2026, succeeded.

Status
Answering
Tools
9
Reliability
6 of 6 checks
Response time
579 ms
Transport
streamable HTTP
Last checked
21 October 2026

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

Description as the publisher wrote it.

The 9 tools Gdelt offers

ToolWhat it does
gdelt_get_coverage_breakdownBreak 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
Inputs: query, breakdownBy, timespan, startDatetime, endDatetime, series
gdelt_get_coverage_timelineRetrieve 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
Inputs: query, mode, timespan, startDatetime, endDatetime, smoothing
gdelt_get_tone_distributionGet 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 posit
Inputs: query, timespan, startDatetime, endDatetime
gdelt_get_tv_clipsRetrieve the top matching TV news clips (up to 3,000) for a query from the Internet Archive's Television News Archive. Each clip includes show name, station, air timestamp, a 15-second transcript excerpt, and a direct link to view the full
Inputs: query, stations, timespan, startDatetime, endDatetime, maxRecords
gdelt_get_tv_contextGet 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 from matching clips, with relative frequency scores (0–100, where 10
Inputs: query, stations, timespan, startDatetime, endDatetime
gdelt_get_tv_trendingRetrieve trending topics, keywords, and phrases currently dominating US television news across national networks. No query required — returns the top memes of the present news cycle. Updated every 15 minutes. Note: the GDELT TV archive feed
gdelt_list_tv_stationsList all television stations available for TV search with their market, network, monitoring start date, and monitoring end date. Stations with an end date within the last 24 hours are flagged as active; stations with earlier end dates are d
gdelt_search_articlesSearch the last 3 months of global news coverage (65+ languages) using the GDELT DOC API. Returns up to 250 articles with URL, title, source domain, language, country, publication date, and social image URL. Query supports full GDELT syntax
Inputs: query, timespan, startDatetime, endDatetime, maxRecords, sort
gdelt_search_tvSearch 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. Use the stations parameter to select network
Inputs: query, stations, timespan, startDatetime, endDatetime, smoothing

Add Gdelt to your AI client

Every block below points at https://gdelt.caseyjhand.com/mcp. Pick your client and copy.

Claude Code: one command in your terminal
claude mcp add --transport http gdelt https://gdelt.caseyjhand.com/mcp
Claude Desktop: claude_desktop_config.json
{
  "mcpServers": {
    "gdelt": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://gdelt.caseyjhand.com/mcp"]
    }
  }
}
Cursor: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
  "mcpServers": {
    "gdelt": {
      "url": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}
VS Code and GitHub Copilot: .vscode/mcp.json
{
  "servers": {
    "gdelt": {
      "type": "http",
      "url": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}
Zed: Zed settings.json
{
  "context_servers": {
    "gdelt": {
      "url": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}
Windsurf: ~/.codeium/mcp_config.json
{
  "mcpServers": {
    "gdelt": {
      "serverUrl": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}
JetBrains AI Assistant: Settings, Tools, AI Assistant, MCP, New MCP Server, as JSON
{
  "mcpServers": {
    "gdelt": {
      "url": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}
Continue: .continue/mcpServers/neuronto.yaml
name: Gdelt
version: 0.0.1
schema: v1
mcpServers:
  - name: Gdelt
    type: streamable-http
    url: https://gdelt.caseyjhand.com/mcp
Gemini CLI: ~/.gemini/settings.json
{
  "mcpServers": {
    "gdelt": {
      "httpUrl": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}
Codex CLI: MCP server config
{
  "mcpServers": {
    "gdelt": {
      "type": "http",
      "url": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}
Warp: MCP servers, + Add, paste JSON
{
  "mcpServers": {
    "gdelt": {
      "url": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}
Goose: a one-click extension link
goose://extension?url=https%3A%2F%2Fgdelt.caseyjhand.com%2Fmcp&type=streamable_http&id=gdelt&name=Gdelt

Is Gdelt up right now?

It answered our last check on 21 October 2026 in 579 ms. Over 6 checks since 11 September 2026 it answered 6. Status here comes from Neuronto's own probes, not from the publisher.

MCP servers similar to Gdelt

Questions about Gdelt

How many tools does Gdelt have?

9, as returned by the server's own tools/list on 13 September 2026: gdelt_get_coverage_breakdown, gdelt_get_coverage_timeline, gdelt_get_tone_distribution, gdelt_get_tv_clips, gdelt_get_tv_context, gdelt_get_tv_trending, gdelt_list_tv_stations, gdelt_search_articles, and 1 more.

Is Gdelt down?

It answered our last check on 21 October 2026 in 579 ms. Over 6 checks since 11 September 2026 it answered 6.

How do I add Gdelt to Cursor?

Put the server under mcpServers in ~/.cursor/mcp.json with the URL https://gdelt.caseyjhand.com/mcp. The exact JSON is above, with the same setup for Claude Code, Claude Desktop, VS Code, Windsurf, Zed, Gemini CLI and the rest.

Does Gdelt need an API key?

It listed its tools to an anonymous client, so reading the tool list needs no key. Individual tools can still ask for credentials in their own inputs.

Where this comes from

Publisher: io.github.cyanheads. Endpoint host: gdelt.caseyjhand.com. ARD identifier: urn:air:io.github.cyanheads:mcp:gdelt-mcp-server. First indexed 10 September 2026. The tools are exactly what the server returned; nothing on this page is inferred from its name. Ranking in Neuronto search is never for sale.

Is this your server? Get a message the day it stops answering or its tools change: monitoring, 14 days free. Or claim the domain to manage how it is listed.