Source: [canonical HTML](https://gdeltcloud.com/product/mcp)

Developer Platform

# 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.

Highlight

Plug-and-play MCP endpoint — connect your agent in seconds.

Highlight

Named tools expose the GDELT Cloud catalog, with optional local taxonomy and parameter guidance.

Highlight

Linked data model: Events connect to Stories, source articles, and named Entities.

Highlight

Facilities, filings, macro series and attributed open data enrich GDELT Cloud research; web research provides optional support.

Highlight

Secure API key auth with per-request usage tracking and plan-level controls.

Highlight

Ideal for research copilots, geopolitical monitors, and automated intelligence workflows.

Model Context Protocol

## 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.

GDELT Cloud46 tools

Media Intelligence3 tools

Facilities6 tools

Government2 tools

Political Offices4 tools

Filings7 tools

Legal Entities5 tools

Energy7 tools

AI Compute10 tools

Natural Resources1 tools

Macro Finance4 tools

Risk and Screening7 tools

Maritime12 tools

Web Research2 tools

### 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.

mcp.json

```
{
"mcpServers": {
"gdelt-cloud": {
"url": 
"https://mcp.gdeltcloud.com/mcp",
"type": "http",
"headers": {
"Authorization": 
"Bearer ${GDELT_API_KEY}"
}
}
}
}
```

GDELT Cloud MCP connection example

gdelt_research_system_prompt available

14 data domains · optional catalog and skills

Connection Example

v2

GDELT Cloud API

14

Data Domains

5

Shared Workflows

OAuth

or API Keys