MCP
Give your agent stack access to generated GDELT Cloud Events, clustered Stories, linked Entities, connected Situations, country context, publication activity, summaries, admin1 discovery, and enrichment tools through a single secure MCP endpoint.
Plug-and-play MCP endpoint — connect your agent in seconds.
Named tools expose the GDELT Cloud catalog, with optional local taxonomy and parameter guidance.
Linked data model: Events connect to Stories, source articles, and named Entities.
Facilities, filings, macro series and attributed open data enrich GDELT Cloud research; web research provides optional support.
Secure API key auth with per-request usage tracking and plan-level controls.
Ideal for research copilots, geopolitical monitors, and automated intelligence workflows.
Agent access to world state
Connect GDELT Cloud to ChatGPT, Claude, Cursor, LangGraph, or your own agent runtime. The current MCP surface exposes named tools with typed inputs and optional catalog guidance for structured world state and enrichment.
Named Tools and Guided Discovery
Agents select the operation they need; free catalog, taxonomy and parameter guidance provide deeper detail on demand.
14 Tool Categories
Discover Facilities, Natural Resources and AI Compute alongside Events, Stories and entity context. Named operations span these related domains; data access follows the same entitlements and published releases as REST.
Prompts, Resources, and Skills
Connection guidance explains the data catalog, Event taxonomy and four core metrics. Five shared workflows and deeper resources are available when needed.
OAuth or API Key Auth
Interactive clients can use OAuth; developer agents and background jobs can use GDELT Cloud API keys.
{
"mcpServers": {
"gdelt-cloud": {
"url":
"https://mcp.gdeltcloud.com/mcp",
"type": "http",
"headers": {
"Authorization":
"Bearer ${GDELT_API_KEY}"
}
}
}
}Connection Example