Skip to content
Squatch MCP
Sign in

io.github.cyanheads/gdelt-mcp-server

io.github.cyanheads/gdelt-mcp-server

by io.github.cyanheads· v0.10.0Source: Official MCP Registry
Sign in to watchSign in to claim this server

All versions

VersionRegistry status
0.10.0latestActive
0.9.0Active
0.8.1Active
0.8.0Active
0.7.0Active
0.6.1Active
0.6.0Active
0.5.0Active
0.4.3Active
0.4.2Active
0.4.1Active
0.4.0Active
0.3.1Active
0.3.0Active
0.2.7Active
0.2.6Active
0.2.5Active
0.2.4Active
0.2.3Active
0.2.2Active
0.2.1Active
0.2.0Active
0.1.8Active
0.1.7Active
0.1.6Active
0.1.5Active
0.1.4Active
0.1.3Active
0.1.2Active

Version details

Version
0.10.0
Source
Source: Official MCP Registry
Published
Registry last updated
First observed by Squatch
Content fingerprint
eb2db569866938843e82c9fbd804c3ccf790dd88b475d05dcf23b277a645ada1

Transports in this version

  • remotestreamable-httphttps://gdelt.caseyjhand.com/mcpNo authentication
  • packagestdionpm @cyanheads/gdelt-mcp-serverUnknown
  • packagestreamable-httpnpm @cyanheads/gdelt-mcp-serverUnknown
Registry metadata (server.json, sanitized)
{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-14T21:30:18.595611Z",
      "publishedAt": "2026-11-14T21:30:18.595611Z",
      "statusChangedAt": "2026-11-14T21:30:18.595611Z"
    }
  },
  "server": {
    "name": "io.github.cyanheads/gdelt-mcp-server",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://gdelt.caseyjhand.com/mcp",
        "type": "streamable-http"
      }
    ],
    "version": "0.10.0",
    "packages": [
      {
        "version": "0.10.0",
        "transport": {
          "type": "stdio"
        },
        "identifier": "@cyanheads/gdelt-mcp-server",
        "runtimeHint": "npx",
        "registryType": "npm",
        "registryBaseUrl": "https://registry.npmjs.org",
        "environmentVariables": [
          {
            "name": "GDELT_CLAMP_LIMITS",
            "format": "string",
            "default": "true",
            "description": "Clamp counts above each per-call cap; false rejects them."
          },
          {
            "name": "GDELT_BASE_URL",
            "format": "string",
            "default": "https://api.gdeltproject.org/api/v2",
            "description": "Override the base URL for the GDELT DOC, Context, and TV APIs."
          },
          {
            "name": "GDELT_REQUEST_DELAY_MS",
            "format": "string",
            "default": "5300",
            "description": "Minimum milliseconds between GDELT requests, enforcing the 1 req/5s rate limit."
          },
          {
            "name": "GDELT_REQUEST_TIMEOUT_MS",
            "format": "string",
            "default": "60000",
            "description": "Deadline in milliseconds for a single GDELT request; the whole call, retries included, is bounded at twice this value."
          },
          {
            "name": "GDELT_MIRROR_PATH",
            "format": "string",
            "description": "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."
          },
          {
            "name": "GDELT_MIRROR_WINDOW_DAYS",
            "format": "string",
            "default": "7",
            "description": "Days of GKG slots the local mirror keeps (1-90)."
          },
          {
            "name": "MCP_LOG_LEVEL",
            "format": "string",
            "default": "info",
            "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
          }
        ]
      },
      {
        "version": "0.10.0",
        "transport": {
          "url": "http://localhost:3010/mcp",
          "type": "streamable-http"
        },
        "identifier": "@cyanheads/gdelt-mcp-server",
        "runtimeHint": "npx",
        "registryType": "npm",
        "registryBaseUrl": "https://registry.npmjs.org",
        "environmentVariables": [
          {
            "name": "MCP_TRANSPORT_TYPE",
            "value": "http",
            "format": "string",
            "description": "Selects the HTTP transport."
          },
          {
            "name": "GDELT_CLAMP_LIMITS",
            "format": "string",
            "default": "true",
            "description": "Clamp counts above each per-call cap; false rejects them."
          },
          {
            "name": "GDELT_BASE_URL",
            "format": "string",
            "default": "https://api.gdeltproject.org/api/v2",
            "description": "Override the base URL for the GDELT DOC, Context, and TV APIs."
          },
          {
            "name": "GDELT_REQUEST_DELAY_MS",
            "format": "string",
            "default": "5300",
            "description": "Minimum milliseconds between GDELT requests, enforcing the 1 req/5s rate limit."
          },
          {
            "name": "GDELT_REQUEST_TIMEOUT_MS",
            "format": "string",
            "default": "60000",
            "description": "Deadline in milliseconds for a single GDELT request; the whole call, retries included, is bounded at twice this value."
          },
          {
            "name": "GDELT_MIRROR_PATH",
            "format": "string",
            "description": "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."
          },
          {
            "name": "GDELT_MIRROR_WINDOW_DAYS",
            "format": "string",
            "default": "7",
            "description": "Days of GKG slots the local mirror keeps (1-90)."
          },
          {
            "name": "MCP_HTTP_HOST",
            "format": "string",
            "default": "127.0.0.1",
            "description": "The hostname for the HTTP server."
          },
          {
            "name": "MCP_HTTP_PORT",
            "format": "string",
            "default": "3010",
            "description": "The port to run the HTTP server on."
          },
          {
            "name": "MCP_HTTP_ENDPOINT_PATH",
            "format": "string",
            "default": "/mcp",
            "description": "The endpoint path for the MCP server."
          },
          {
            "name": "MCP_AUTH_MODE",
            "format": "string",
            "default": "none",
            "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'."
          },
          {
            "name": "MCP_LOG_LEVEL",
            "format": "string",
            "default": "info",
            "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/cyanheads/gdelt-mcp-server",
      "source": "github"
    },
    "description": "Search and analyze global news coverage and US TV transcripts via the GDELT Project APIs."
  }
}