Gdelt MCP server

online · 100% uptime

by cyanheads·io.github.cyanheads/gdelt-mcp-server·v0.8.1·6 stars

No reviews yet

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

A93/100grade A

Write a review Run it

What users say

No reviews yet

Be the first

Safety scan

A93/100

not scanned yet

Adoption

Growing

6 stars942 downloads/wk

Reviews

Write one

Nobody has reviewed Gdelt yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Gdelt tools

Tool list not cached yet. `describe` through the gateway fetches it live.

Not scanned yet. New listings are scanned within a day or two of arriving.

How Gdelt compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 93/100; higher than 95% of 3,470 Web search servers
Uptime: 100%; of our recent checks; the typical remote Web search server answers 100%
Response time: 520 ms; faster than 28% of 2,238 Web search servers
GitHub stars: 6; more than 81% of 1,786 Web search servers
Downloads a week: 942; more than 95% of 827 Web search servers with a package

Release history: 8 versions in the registry since 2026-09-03, latest 2026-11-01, typically one every 7 days.

Install Gdelt in Claude Code, Cursor or VS Code

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

Add to Cursor

What the publisher says

From the Gdelt repository's README, as published. We do not edit it. Read it on GitHub

@cyanheads/gdelt-mcp-server Search and analyze global news coverage and US television transcripts via the GDELT Project's real-time APIs via MCP. STDIO or Streamable HTTP. 9 Tools

Public Hosted Server: https://gdelt.caseyjhand.com/mcp

Overview

News and television coverage analysis from the GDELT Project's DOC and TV APIs — the last 3 months of global news in 65+ languages, and US TV transcripts from 2009 through October 2024 across 150+ stations. Search articles and clips, track coverage spikes, analyze tone, and trace how a story propagated across languages and countries. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.

Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Gdelt: common questions

Is Gdelt MCP server safe?: Yes, by our scan: it is graded A (93/100). Read the Gdelt safety report
How do I install Gdelt?: It runs remotely at gdelt.caseyjhand.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Gdelt need an API key?: No secret keys are declared. It reads 19 settings from the environment.
Is Gdelt maintained?: The last commit was 28 days ago (2026-10-07). The latest release is v0.8.1.
Is Gdelt up?: 100% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of Gdelt?: Servers from other publishers that do the same job: The Company Atlas MCP server, screenpipe MCP server and AIHOT MCP server.
How does Gdelt compare with other Web search MCP servers?: safety score 93/100 (higher than 95% of 3,470 Web search servers); uptime 100% (of our recent checks; the typical remote Web search server answers 100%); response time 520 ms (faster than 28% of 2,238 Web search servers). Full comparison.

Alternatives to Gdelt

Same job from other publishers: the closest match first, then the best rated.

The Company Atlas
Global customs trade data and company registry. Search shipments, and look up legal entities.
5.0(1)
New
B
screenpipe
Search your local screen recordings, audio transcripts, and computer activity from screenpipe.
not reviewed
Widely used
B
AIHOT
Chinese AI news: search topics, explore hot events, and read daily, weekly and monthly briefs.
not reviewed
Established
B
Search1API
Web search, agentic search, news, page retrieval, sitemaps, and trending topics through Search1API.
not reviewed
Established
A
ContextStream MCP Server
The context platform for AI agents: code search, team decisions, and grounded project context.
not reviewed
Established
A

Run it through the gateway

With the gateway added, ask your agent for it by name:

agent prompt

call io.github.cyanheads/gdelt-mcp-server → <tool>

Free per call. Metered, capped by your key, logged for reliability.

Add the gateway (gw.mcp.market)

Rating: —
Safety grade: A · 93/100
Stars: 6
Downloads/wk: 942
Price: Free
Licence: Apache-2.0
Transport: Remote · mixed
Uptime: 100% · 28/28 checks
Version: 0.8.1
Category: Web search
Last release: 2026-10-07

Credentials it needs

GDELT_CLAMP_LIMITSClamp counts above each per-call cap; false rejects them.
GDELT_BASE_URLOverride the base URL for the GDELT DOC and TV APIs.
GDELT_REQUEST_DELAY_MSMinimum milliseconds between GDELT requests, enforcing the 1 req/5s rate limit.
GDELT_REQUEST_TIMEOUT_MSDeadline in milliseconds for a single GDELT request; the whole call, retries included, is bounded at twice this value.
GDELT_MIRROR_PATHSQLite file of the optional local GKG mirror the DOC tools fall back to when the DOC API refuses requests. Unset leaves it off. Built with `bun run mirror:init` from a checkout or the Docker image; on Node it needs better-sqlite3 installed.
GDELT_MIRROR_WINDOW_DAYSDays of GKG slots the local mirror keeps (1-90).
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_TRANSPORT_TYPESelects the HTTP transport.
GDELT_CLAMP_LIMITSClamp counts above each per-call cap; false rejects them.
GDELT_BASE_URLOverride the base URL for the GDELT DOC and TV APIs.
GDELT_REQUEST_DELAY_MSMinimum milliseconds between GDELT requests, enforcing the 1 req/5s rate limit.
GDELT_REQUEST_TIMEOUT_MSDeadline in milliseconds for a single GDELT request; the whole call, retries included, is bounded at twice this value.
GDELT_MIRROR_PATHSQLite file of the optional local GKG mirror the DOC tools fall back to when the DOC API refuses requests. Unset leaves it off. Built with `bun run mirror:init` from a checkout or the Docker image; on Node it needs better-sqlite3 installed.
GDELT_MIRROR_WINDOW_DAYSDays of GKG slots the local mirror keeps (1-90).
MCP_HTTP_HOSTThe hostname for the HTTP server.
MCP_HTTP_PORTThe port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Endpoint

https://gdelt.caseyjhand.com/mcp

streamable-http

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/cyanheads-gdelt-mcp-server.svg)](https://mcp.market/server/cyanheads-gdelt-mcp-server)

How the badge works