All servers · Research & knowledge · Monitoring & logs

io.github.cyanheads/gdelt-mcp-server

io.github.cyanheads/gdelt-mcp-server · v0.7.0

Measured by MCP Station

Description written by the publisher, not verified

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

Connect

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

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

Tools as reported by the server

• 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, 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_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 (% 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
  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_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 which countries or languages drove early vs. late coverage — useful for tracing how a story propagated geographically or across language co
• 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_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
  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
• gdelt_get_tv_clips
  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
  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
  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

Repository · JSON · Text for agents · Registry updated 2026-10-14