Home › Other › gdelt-mcp-server
gdelt-mcp-server
Search and analyze global news coverage and US TV transcripts via the GDELT Project APIs.
Connect
Review any command before running it. Package names and URLs come from the server's own registry entry.
Remote (streamable-http)
https://gdelt.caseyjhand.com/mcp Reachable (checked 2026-11-16)
Claude Code:
claude mcp add --transport http gdelt-mcp-server https://gdelt.caseyjhand.com/mcp
Or add to your MCP client config:
{
"mcpServers": {
"gdelt-mcp-server": {
"url": "https://gdelt.caseyjhand.com/mcp"
}
}
}
Package (npm 0.10.1)
npx -y @cyanheads/gdelt-mcp-server@0.10.1
Or add to your MCP client config:
{
"mcpServers": {
"gdelt-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/gdelt-mcp-server@0.10.1"
]
}
}
}
GDELT_CLAMP_LIMITS— Clamp counts above each per-call cap; false rejects them.GDELT_BASE_URL— Override the base URL for the GDELT DOC, Context, and TV APIs.GDELT_REQUEST_DELAY_MS— Minimum milliseconds between GDELT requests, enforcing the 1 req/5s rate limit.GDELT_REQUEST_TIMEOUT_MS— Deadline in milliseconds for a single GDELT request; the whole call, retries included, is bounded at twice this value.GDELT_MIRROR_PATH— SQLite file of the optional local GKG mirror the DOC tools answer from when the DOC API refuses a request, returns nothing, or is not asked (an explicit window under 30 minutes). 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_DAYS— Days of GKG slots the local mirror keeps (1-90).MCP_LOG_LEVEL— Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
Package (npm 0.10.1)
Package: npm @cyanheads/gdelt-mcp-server
MCP_TRANSPORT_TYPE— Selects the HTTP transport.GDELT_CLAMP_LIMITS— Clamp counts above each per-call cap; false rejects them.GDELT_BASE_URL— Override the base URL for the GDELT DOC, Context, and TV APIs.GDELT_REQUEST_DELAY_MS— Minimum milliseconds between GDELT requests, enforcing the 1 req/5s rate limit.GDELT_REQUEST_TIMEOUT_MS— Deadline in milliseconds for a single GDELT request; the whole call, retries included, is bounded at twice this value.GDELT_MIRROR_PATH— SQLite file of the optional local GKG mirror the DOC tools answer from when the DOC API refuses a request, returns nothing, or is not asked (an explicit window under 30 minutes). 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_DAYS— Days of GKG slots the local mirror keeps (1-90).MCP_HTTP_HOST— The hostname for the HTTP server.MCP_HTTP_PORT— The port to run the HTTP server on.MCP_HTTP_ENDPOINT_PATH— The endpoint path for the MCP server.MCP_AUTH_MODE— Authentication mode to use: 'none', 'jwt', or 'oauth'.MCP_LOG_LEVEL— Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
Related servers
REA
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
browser-use
Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.
paperclip
Trending hip-hop artist momentum scores across four cultural dimensions.
World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
HyperFrames by HeyGen
Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.
Ruflo
Agent teams, swarms, memory and hooks for Claude Code and Codex, served over MCP.
Data from the Official MCP Registry