How do I connect Gdelt MCP Server to Claude?

The listing records `docker run --rm -p 3010:3010 gdelt-mcp-server` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Cursor, VS Code as compatible clients.

Is Gdelt MCP Server free?

The listed licence is Apache-2.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Gdelt MCP Server do?

Gdelt MCP Server documents 13 tools to the agent, including gdelt_get_coverage_breakdown, gdelt_get_coverage_timeline, gdelt_get_tone_distribution. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Gdelt MCP Server

Unclaimed

by cyanheads

Search and analyze global news coverage and US television transcripts via the GDELT Project's real-time APIs via MCP. STDIO or Streamable HTTP.

Install

$docker run --rm -p 3010:3010 gdelt-mcp-server

Set up this server

Compare servers My Stack

This server needs project-specific setup. Follow the project instructions; no reusable public launch command is available yet.

Project instructions

ai-agentsai-toolscyanheadsevent-monitoringgdeltglobal-newsjournalismmcpmcp-servermedia-analysismedia-monitoringmodel-context-protocolnews-analyticssentiment-analysistv-newstypescript

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

13 of 13 tools

Documented tools (13)

From project documentation. A server handshake does not verify each tool’s description or behavior.

gdelt_get_coverage_breakdown

Break down coverage volume by source language or source country — a multi-series time series showing geographic propagation. Values are normalized shares of media output, not article counts.

gdelt_get_coverage_timeline

Retrieve a time series of coverage volume or average tone for a query. volumewitharticles mode includes top articles per spike timestep, with points to render a timestep's full article list.

gdelt_get_tone_distribution

Get a tone histogram (bins ~−30 to +30) showing whether coverage is uniformly negative, bimodal, or clustered near neutral.

gdelt_get_tv_clips

Retrieve up to 3,000 matching TV clips with transcript excerpts and Internet Archive viewing links, and the date windows to re-query when that ceiling is hit.

gdelt_get_tv_context

Get the most frequent co-occurring words and phrases from TV clips matching a query.

gdelt_get_tv_trending

Retrieve trending topics currently dominating US television news (updated every 15 minutes; no query required).

gdelt_list_tv_stations

List all TV stations with market, network, and monitoring date ranges to verify station availability before querying.

gdelt_search_articles

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 to re-query when that ceiling is hit.

gdelt_search_tv

Search US television news closed captions (2009–Oct 2024) and return per-station airtime time series.

isActive

flag — true when end date is within the last 24 hours

tone

average sentiment score per timestep (combine with gdeltgettonedistribution for the full picture)

volume

normalized percentage of all global coverage per timestep

volume_with_articles

volume plus top articles driving each spike; use for signal detection without a follow-up search call

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Gdelt MCP Server

How do I connect Gdelt MCP Server to Claude?: The listing records `docker run --rm -p 3010:3010 gdelt-mcp-server` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Cursor, VS Code as compatible clients.
Is Gdelt MCP Server free?: The listed licence is Apache-2.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Gdelt MCP Server do?: Gdelt MCP Server documents 13 tools to the agent, including gdelt_get_coverage_breakdown, gdelt_get_coverage_timeline, gdelt_get_tone_distribution. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.