What you can do with GDELT

Built for

Brand monitoring, policy and risk, geographic media intelligence, investor research, TV caption search

Example workflows

Brand sentiment shift

Combines article search with volume and tone timelines.

Try this

Track global news volume and tone for Anthropic over the last 7 days, then summarize the biggest shifts and link the most relevant source articles.

Non-English coverage

Shows source-language filtering for international media monitoring.

Try this

Find coverage of Anthropic in Spanish-language press this week. Show article titles, source countries, domains, and any tone pattern.

Local incident mentions

Demonstrates GEO search while preserving the data-quality caveat.

Try this

Map protest-related location mentions within 100km of London over the last 24 hours and explain why these are media mentions, not verified incident coordinates.

TV news captions

Uses station-scoped TV caption search, the required TV pattern.

Try this

Search CNN television captions for mentions of climate over the last 24 hours and show the matching clips or explain if no clips are returned.

Context to know first

What is GDELT?

GDELT is the Global Database of Events, Language, and Tone. It monitors worldwide online news and selected TV news, extracts entities, locations, themes, and tone, and updates every 15 minutes.

Does GDELT require an API key?

No. The public DOC, GEO, and TV APIs are no-auth endpoints. They are rate-limited, so large-scale or historical analysis belongs in GDELT's downloadable datasets or Google BigQuery.

Are GDELT GEO results verified events?

No. GEO results are locations mentioned in news coverage near the query terms. They are useful for media intelligence, but they are not a verified incident database.

AI Skill
SKILL.md

Domain knowledge for GDELT — workflow patterns, data models, and gotchas for your AI agent.

GDELT

GDELT monitors global online news and selected television news, machine-translates coverage, extracts entities and locations, and updates every 15 minutes.

Workflows

Brand monitoring: Search articles for the brand, then compare mention volume and tone over the same timespan. Use source country and language filters for regional press.

Narrative shifts: Pull volume and tone timelines for the same query. Investigate spikes with article search.

International coverage: Use quoted phrases for names, source language for non-English press, and source country for domestic-media framing.

Geographic intelligence: Search for a topic with a location, country, or near-radius constraint. Treat places as media location mentions, not verified incident coordinates.

TV monitoring: Look up station IDs when needed, then scope searches by station, network, market, or show. Caption search works best with short distinctive phrases.

Query Notes

  • Supports quoted phrases, OR blocks, exclusions, and operators such as domain:, sourcelang:, sourcecountry:, location:, locationcc:, near:, and tone<.
  • timespan values are compact windows such as 15min, 1h, 24h, 7d, 1w, or 1m.
  • Broad global queries can be slow or throttled. Start narrow, then expand result limits and time windows.

Gotchas

  • GDELT output is automated global media monitoring; place extraction, machine translation, and tone scoring can be noisy.
  • GEO results are article location mentions near the query, not a canonical incident database.
  • TV coverage varies by station and date; a no-match result can mean the selected station was not monitored for that window.

Where the data comes from

Tool calls proxy the GDELT DOC, GEO, and TV APIs in real time, normalize the response shape for agents, and preserve source URLs and GDELT query metadata where available. Results are not cached or scored as verified facts.

GDELT Project DOC 2.0 API
The GDELT Project

Global online news search API for articles, source metadata, languages, countries, themes, tone, and volume timelines.

Global online news coverage indexed continuously
Source updated: Every 15 minutes
We refresh: Real-time (proxied per request, no caching)
JSON HTTP API
Worldwide online news, with source coverage varying by country and language
GDELT Project GEO 2.0 API
The GDELT Project

Geographic media-intelligence API returning locations mentioned in coverage that matches a query, including near-radius filters.

Location mentions extracted from monitored news coverage
Source updated: Every 15 minutes
We refresh: Real-time (proxied per request, no caching)
JSON HTTP API
Worldwide media location mentions; not verified incident coordinates

Caption search over selected monitored television stations and networks, scoped by station, network, market, or show.

Selected TV caption coverage by station and date
Source updated: Continuously as monitored broadcasts are captioned
We refresh: Real-time (proxied per request, no caching)
JSON HTTP API
Selected television stations and dates supported by GDELT
GDELT uses automated monitoring, extraction, machine translation, geocoding, and tone analysis. Treat important findings as leads and review the linked source coverage before relying on them.
GDELT GEO results are locations mentioned in news coverage near the query terms. They are media mentions, not a verified incident or ground-truth event database.
Television caption coverage varies by station, network, market, show, and date. Missing TV results do not mean the topic was not covered elsewhere.

Source availability last verified 2026-05-02.

Tools in this Server (6)

Gdelt Geo Events

Map GDELT location mentions from the GKG GeoJSON feed for a theme, topic, person, organization, or publisher query. Supports country, radius, and boun...

Gdelt News Tone

Track average GDELT news tone over time for a query. Returns aggregate tone timeline points so analysts can spot sentiment shifts and decide which art...

Gdelt News Volume

Track GDELT DOC mention volume over time for a news query. Returns timeline points for coverage volume, useful for trend detection, spike analysis, an...

Gdelt Search News

Search worldwide online news coverage in the GDELT DOC API. Returns article metadata including title, URL, seen date, domain, source country, language...

Gdelt Tv Search

Search GDELT's television news closed-caption archive. Returns matching clips when available, including station/show metadata and clip links. Scope by...

Gdelt Tv Station Details

Find valid GDELT TV station IDs, networks, and markets before running a caption search. Use when a TV query needs a station scope or when a station-sc...

Frequently Asked Questions

What is the GDELT MCP server?

Search and analyze global news coverage from GDELT. Find articles, track mention volume and tone, map geographic location mentions, and inspect searchable television news captions. It provides 6 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect GDELT to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/gdelt. Authentication is handled automatically.

How many tools does GDELT provide?

GDELT provides 6 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does GDELT require?

GDELT uses open data APIs — no authentication required.

What is GDELT?

GDELT is the Global Database of Events, Language, and Tone. It monitors worldwide online news and selected TV news, extracts entities, locations, themes, and tone, and updates every 15 minutes.

Does GDELT require an API key?

No. The public DOC, GEO, and TV APIs are no-auth endpoints. They are rate-limited, so large-scale or historical analysis belongs in GDELT's downloadable datasets or Google BigQuery.

Are GDELT GEO results verified events?

No. GEO results are locations mentioned in news coverage near the query terms. They are useful for media intelligence, but they are not a verified incident database.

What can the TV search cover?

The TV API searches closed captions from monitored stations and requires a station, network, market, or show scope. Coverage varies by station and date.

Setup Instructions

Connect GDELT to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/gdelt

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to GDELT and paste the MCP URL into Remote MCP server URL.
  4. Click Add. GDELT will appear under Not connected — select it and click Connect to complete OAuth.
Name: GDELT
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/gdelt
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Other ways to use GDELT

Same data, different audiences.

REST API

Call every tool from your own backend. OpenAPI spec + cURL examples.

View API docs

Try GDELT now

No API key or third-party login required. Chat with AI and run tools instantly.