io.github.cyanheads/gdelt-mcp-server MCP Server

io.github.cyanheads/gdelt-mcp-server

Repository Registry

What is the io.github.cyanheads/gdelt-mcp-server MCP server?

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

How to install io.github.cyanheads/gdelt-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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.
MCP_LOG_LEVEL
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
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'.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gdelt-mcp-server": {
      "command": "node",
      "args": [
        "-y",
        "@cyanheads/gdelt-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "GDELT_BASE_URL": "<YOUR_GDELT_BASE_URL>",
        "GDELT_REQUEST_DELAY_MS": "<YOUR_GDELT_REQUEST_DELAY_MS>",
        "GDELT_REQUEST_TIMEOUT_MS": "<YOUR_GDELT_REQUEST_TIMEOUT_MS>",
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

Related MCP servers

io.github.cyanheads/git-mcp-server

Maintained

Comprehensive Git MCP server with 28 tools for AI agents to clone, commit, branch, merge, and manage repositories.

226

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/gnomad-genetics-mcp-server

Active

Look up allele frequencies by ancestry, gene constraint, variants, and coverage over gnomAD.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/grantsgov-mcp-server

Active

Search Grants.gov funding opportunities and read full records: eligibility, awards, deadlines.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/guardian-mcp-server

Active

Guardian Open Platform — search and retrieve full article text from The Guardian archive.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/gutenberg-mcp-server

Active

MCP server for Project Gutenberg — 75,000+ public-domain ebooks with full plain-text retrieval.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/hn-mcp-server

Active

Browse Hacker News feeds, threads, and user profiles with full-text search.

TypeScript

Apache-2.0

View repository →