Gdelt MCP Server

Gdelt MCP Server is a remote MCP server: there is nothing to install. Its endpoint is https://gdelt.caseyjhand.com/mcp, served over Streamable HTTP. In an assistant that accepts remote MCP servers (often under a setting named connectors, integrations or tools), add a new server and give it this URL; in a client configured by file, add it as a remote (HTTP) server with the same URL.

No headers are declared in the registry entry. If the server needs you to sign in, a client that supports MCP authorization opens the service's own sign-in page when it first connects.

It can also run locally from a Node.js package published to the npm registry: @cyanheads/gdelt-mcp-server version 0.6.0. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs Node.js; clients usually start it with npx — the usual command is npx -y @cyanheads/gdelt-mcp-server@0.6.0; the entry names node as the runtime. It reads these environment variables: GDELT_BASE_URL, GDELT_REQUEST_DELAY_MS, GDELT_REQUEST_TIMEOUT_MS and MCP_LOG_LEVEL; set them in the client's configuration for this server.

It can also run locally from a Node.js package published to the npm registry: @cyanheads/gdelt-mcp-server version 0.6.0. The package starts a local server that speaks MCP over Streamable HTTP; the client then connects to it by URL (the entry names node as the runtime). It reads these environment variables: GDELT_BASE_URL, GDELT_REQUEST_DELAY_MS, GDELT_REQUEST_TIMEOUT_MS, MCP_HTTP_HOST, MCP_HTTP_PORT, MCP_HTTP_ENDPOINT_PATH, MCP_AUTH_MODE and MCP_LOG_LEVEL; set them in the client's configuration for this server.

In the mcpServers JSON format that many desktop and editor MCP clients read, the entry looks like this (placeholders in angle brackets):

{
  "mcpServers": {
    "gdelt-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/gdelt-mcp-server@0.6.0"
      ],
      "env": {
        "GDELT_BASE_URL": "<value>",
        "GDELT_REQUEST_DELAY_MS": "<value>",
        "GDELT_REQUEST_TIMEOUT_MS": "<value>",
        "MCP_LOG_LEVEL": "<value>"
      }
    }
  }
}

Derived from the registry entry, not tested here. What the server does, and on what terms, is set by its publisher; check its repository or website before giving it access to your accounts or files. How to add an MCP server to an assistant · Before you connect