Home/gdelt-mcp-server
Hybrid

gdelt-mcp-server

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

io.github.cyanheads/gdelt-mcp-serverSource repository
Version0.8.0latest catalog version
ConnectionHybridstreamable-http · npm
PublishedNov 01, 2026catalog
UpdatedNov 01, 2026catalog
Overview

What this server provides

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

Connect

Remote endpoints

1
Remote endpoint 1streamable-http
https://gdelt.caseyjhand.com/mcp
Open endpoint
Install

Packages

2
Package 1npm
@cyanheads/gdelt-mcp-server0.8.0
Runtime npxTransport stdio
  • GDELT_CLAMP_LIMITS

    Clamp counts above each per-call cap; false rejects them.

    Format: string · Default: true
    Optional
  • GDELT_BASE_URL

    Override the base URL for the GDELT DOC and TV APIs.

    Format: string · Default: https://api.gdeltproject.org/api/v2
    Optional
  • GDELT_REQUEST_DELAY_MS

    Minimum milliseconds between GDELT requests, enforcing the 1 req/5s rate limit.

    Format: string · Default: 5300
    Optional
  • GDELT_REQUEST_TIMEOUT_MS

    Deadline in milliseconds for a single GDELT request; the whole call, retries included, is bounded at twice this value.

    Format: string · Default: 60000
    Optional
  • MCP_LOG_LEVEL

    Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

    Format: string · Default: info
    Optional
Package 2npm
@cyanheads/gdelt-mcp-server0.8.0
Runtime npxTransport streamable-http
http://localhost:3010/mcp
  • GDELT_CLAMP_LIMITS

    Clamp counts above each per-call cap; false rejects them.

    Format: string · Default: true
    Optional
  • GDELT_BASE_URL

    Override the base URL for the GDELT DOC and TV APIs.

    Format: string · Default: https://api.gdeltproject.org/api/v2
    Optional
  • GDELT_REQUEST_DELAY_MS

    Minimum milliseconds between GDELT requests, enforcing the 1 req/5s rate limit.

    Format: string · Default: 5300
    Optional
  • GDELT_REQUEST_TIMEOUT_MS

    Deadline in milliseconds for a single GDELT request; the whole call, retries included, is bounded at twice this value.

    Format: string · Default: 60000
    Optional
  • MCP_HTTP_HOST

    The hostname for the HTTP server.

    Format: string · Default: 127.0.0.1
    Optional
  • MCP_HTTP_PORT

    The port to run the HTTP server on.

    Format: string · Default: 3010
    Optional
  • MCP_HTTP_ENDPOINT_PATH

    The endpoint path for the MCP server.

    Format: string · Default: /mcp
    Optional
  • MCP_AUTH_MODE

    Authentication mode to use: 'none', 'jwt', or 'oauth'.

    Format: string · Default: none
    Optional
  • MCP_LOG_LEVEL

    Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

    Format: string · Default: info
    Optional
View server metadata