Skip to content
MCP server

Gdelt MCP Server

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

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.10.0
Listing updated
5 days ago

About Gdelt MCP Server

Gdelt MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Install

Run in a terminal

claude mcp add --transport http gdelt-mcp-server https://gdelt.caseyjhand.com/mcp

Add to Settings → Connectors → Add custom connector

https://gdelt.caseyjhand.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gdelt-mcp-server": {
      "url": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gdelt-mcp-server": {
      "type": "http",
      "url": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gdelt-mcp-server": {
      "serverUrl": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gdelt-mcp-server": {
      "type": "http",
      "url": "https://gdelt.caseyjhand.com/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GDELT_CLAMP_LIMITSClamp counts above each per-call cap; false rejects them.
  • GDELT_BASE_URLOverride the base URL for the GDELT DOC, Context, and TV APIs.
  • GDELT_REQUEST_DELAY_MSMinimum milliseconds between GDELT requests, enforcing the 1 req/5s rate limit.
  • GDELT_REQUEST_TIMEOUT_MSDeadline in milliseconds for a single GDELT request; the whole call, retries included, is bounded at twice this value.
  • GDELT_MIRROR_PATHSQLite 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_DAYSDays of GKG slots the local mirror keeps (1-90).
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • GDELT_CLAMP_LIMITSClamp counts above each per-call cap; false rejects them.
  • GDELT_BASE_URLOverride the base URL for the GDELT DOC, Context, and TV APIs.
  • GDELT_REQUEST_DELAY_MSMinimum milliseconds between GDELT requests, enforcing the 1 req/5s rate limit.
  • GDELT_REQUEST_TIMEOUT_MSDeadline in milliseconds for a single GDELT request; the whole call, retries included, is bounded at twice this value.
  • GDELT_MIRROR_PATHSQLite 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_DAYSDays of GKG slots the local mirror keeps (1-90).
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Pricing

Open source

Gdelt MCP Server FAQ

Is Gdelt MCP Server free?

Yes. Gdelt MCP Server is open source, so you can use and self-host it for free.

How do I add Gdelt MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http gdelt-mcp-server https://gdelt.caseyjhand.com/mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers