io.github.cyanheads/gdelt-mcp-server

up checked 2026-11-11T11:38:10.312Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided description

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

Summary by lookupd

Searches global news articles and US TV transcripts, and analyzes coverage volume, tone, and TV vocabulary over time.

Install

Claude Code, remote (streamable-http)

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

Claude Code, npm package (stdio)

claude mcp add gdelt-mcp-server -- npx -y @cyanheads/gdelt-mcp-server

Claude Code, npm package (stdio)

claude mcp add gdelt-mcp-server -- npx -y @cyanheads/gdelt-mcp-server

Codex, remote (streamable-http)

codex mcp add gdelt-mcp-server --url https://gdelt.caseyjhand.com/mcp

Codex, npm package (stdio)

codex mcp add gdelt-mcp-server -- npx -y @cyanheads/gdelt-mcp-server

Codex, npm package (stdio)

codex mcp add gdelt-mcp-server -- npx -y @cyanheads/gdelt-mcp-server

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "gdelt-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/gdelt-mcp-server"
      ]
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "gdelt-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/gdelt-mcp-server"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (10 tools)

Publisher-provided text

• 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, c
• gdelt_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
• 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 reveal
• gdelt_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
• gdelt_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_distri
• gdelt_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 — 5
• gdelt_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 nor
• gdelt_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
• gdelt_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-sto
• gdelt_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 o

Details

• Version: 0.9.0
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 722 ms
• First indexed: 2026-11-01T09:26:04.317Z
• Last seen in registry: 2026-11-10T10:17:28.546Z
• Repository: https://github.com/cyanheads/gdelt-mcp-server

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.cyanheads/gdelt-mcp-server.svg)](https://lookupd.com/servers/io.github.cyanheads/gdelt-mcp-server)

• 62092 servers
• Last crawl: 2026-11-11T17:38:11.606Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp