Home › Other › gdelt-mcp-server

gdelt-mcp-server

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

TypeScript Remote

★ 10 stars Last pushed 2026-11-01 License: Apache-2.0

View repository →

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

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.8.1)

npx -y @cyanheads/[email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "gdelt-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/[email protected]"
      ],
      "env": {
        "GDELT_CLAMP_LIMITS": "<YOUR_VALUE>",
        "GDELT_BASE_URL": "<YOUR_VALUE>",
        "GDELT_REQUEST_DELAY_MS": "<YOUR_VALUE>",
        "GDELT_REQUEST_TIMEOUT_MS": "<YOUR_VALUE>",
        "GDELT_MIRROR_PATH": "<YOUR_VALUE>",
        "GDELT_MIRROR_WINDOW_DAYS": "<YOUR_VALUE>",
        "MCP_LOG_LEVEL": "<YOUR_VALUE>"
      }
    }
  }
}

GDELT_CLAMP_LIMITS — Clamp counts above each per-call cap; false rejects them.
GDELT_BASE_URL — Override the base URL for the GDELT DOC 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 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_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.8.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 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 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_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').