Overview
The GDELT Cloud MCP (Model Context Protocol) server gives AI agents direct access to GDELT news event data. Connect ChatGPT, Claude, Cursor, or custom AI agents to discover stories, explore entities, and analyze global news — no SQL required.MCP Server URL:
https://gdelt-cloud-mcp.fastmcp.app/mcpUse this URL to connect your MCP client to GDELT Cloud.API Key Authentication
Secure access using GDELT Cloud API keys
5 API Tools
Media events, cluster deep-dives, entity profiles, domain analytics, and conflict events
CAMEO Code Resources
Country codes, event types, and Goldstein scale reference
Works with ChatGPT, Claude & Cursor
Native integrations with leading AI platforms
What is MCP?
The Model Context Protocol is an open standard that allows AI applications to securely connect to external data sources and tools. GDELT Cloud’s MCP server implements this protocol to provide:- Tools: Functions AI agents can call to query GDELT data
- Resources: Static reference documentation (CAMEO codes, Goldstein scale)
- Prompts: Pre-built system prompt for effective GDELT analysis
Available Tools
The MCP server provides five API tools that cover the full GDELT data model:| Tool | Purpose | Returns |
|---|---|---|
| get_media_events | Discover top news story clusters | Headline cards with metrics, entities, sources |
| get_media_event_cluster | Deep-dive into a single story | All articles, common entities, resolved metrics |
| get_entity | Wikipedia-linked entity profile | Linked stories, co-occurrences, timeline |
| get_domain | News outlet profile | Stats, top entities, recent articles |
| get_conflict_events | ACLED-style conflict event records | Battles, airstrikes, protests with actor coding, location, fatalities |
detail parameter (summary → standard → full) to control response size. Start with summary for scanning, escalate when you need more data.
Resources
Three CAMEO code reference resources accessible via resource URIs:gdelt://codes/cameo-country— ISO-3 actor country codes (USA, CHN, GBR)gdelt://codes/cameo-event— CAMEO event root codes (01–20)gdelt://codes/goldstein-scale— Goldstein scale reference (-10 to +10)
Prompt
- gdelt_system_prompt — Complete system prompt with tool descriptions, workflow guidance, filter reference, and scoring interpretation.
Getting Started
Quickstart
5-minute setup guide for your first MCP connection
Authentication
Learn about API key authentication for the MCP server
Tools Reference
Complete documentation of all 5 MCP tools
LangChain Integration
Build AI agents with GDELT MCP tools
Client Integrations
Connect GDELT Cloud MCP to your favorite AI platform:ChatGPT
Connect via OpenAI’s Developer Mode MCP support
Claude
Web (claude.ai) and Desktop app integration
LangChain
Build custom AI agents with LangGraph
Requirements
- GDELT Cloud account with an Analyst or Professional plan
- MCP-compatible client (ChatGPT, Claude, Cursor, or any MCP client)
- Valid API key from your dashboard
Data Access
The MCP server provides access to:- Data from January 2025 onward, accumulating daily with historical data added gradually
- Hourly update frequency
- Media Event clusters with articles, events, and linked entities
- Wikipedia-linked entity profiles with co-occurrences and story connections
- News domain profiles with coverage stats
- CAMEO taxonomy (country codes, event codes, Goldstein scale)
Next Steps
Read the Quickstart
Follow our Quickstart Guide to set up your first connection
Set up authentication
Generate an API key from your dashboard. See Authentication Guide.