io.github.cyanheads/gdelt-mcp-server MCP Server
io.github.cyanheads/gdelt-mcp-server
What this kind of tool is for
- Let your agent search the web or a document set and cite what it found.
- Pull structured facts out of pages instead of copy-pasting by hand.
- Track changes on a topic over days without re-reading everything.
How to compare servers like this
- Source coverage:
- Check which engines, sites, or document types the tool can actually reach.
- Citation behavior:
- Prefer tools that return links you can open, not just summarized claims.
- Terms of service:
- Some sources forbid automated access; make sure the tool stays inside them.
- Maintenance signal:
- Scrapers break silently when pages change; recent commits are the best proxy.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
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.
GDELT_BASE_URLOverride the base URL for the GDELT DOC 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.
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
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'.
{
"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
Comprehensive Git MCP server with 28 tools for AI agents to clone, commit, branch, merge, and manage repositories.
Look up allele frequencies by ancestry, gene constraint, variants, and coverage over gnomAD.
Search Grants.gov funding opportunities and read full records: eligibility, awards, deadlines.
Guardian Open Platform — search and retrieve full article text from The Guardian archive.
MCP server for Project Gutenberg — 75,000+ public-domain ebooks with full plain-text retrieval.
Browse Hacker News feeds, threads, and user profiles with full-text search.