Developer Platform

MCP

Give your agent stack access to generated GDELT Cloud Events, clustered Stories, linked Entities, summaries, admin1 discovery, and enrichment tools through a single secure MCP endpoint.

Highlight

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

Highlight

Progressive Discovery wrappers expose only the clean v2 GDELT catalog.

Highlight

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

Highlight

Macro-finance, prediction-market, and web-research tools enrich the GDELT Cloud anchor signal.

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 is compact on purpose: agents discover a category, inspect schemas, then call nested tools for structured world state and enrichment.

Progressive Discovery Wrappers

Agents see `*_tool_list`, `*_tool_get`, and `*_tool_call` wrappers instead of a sprawling top-level tool dump.

Five Tool Categories

GDELT Cloud anchors the narrative analysis; Energy Data adds physical-asset exposure; external categories enrich with markets and corroboration.

GDELT Cloud: Events, Stories, Entities, summaries, and admin1 discovery
Energy Data: Global Energy Monitor coal/gas/oil/nuclear/renewable plants, mines, pipelines, terminals, vessels — capacity, location, ownership
Macro finance: quotes, rates, indicators, commodities, FX, and technicals
Prediction markets: Kalshi-backed market search, contracts, and probabilities
Web research: search and extraction for corroboration and source reading

Prompts, Resources, and Skills

Research and Brief system prompts, CAMEO resources, task skills, and Brief skills are exposed natively and through tool-only transforms.

OAuth or API Key Auth

Interactive clients can use OAuth; developer agents and background jobs can use GDELT Cloud API keys.

mcp.json
{
  "mcp_servers": {
    "gdelt-cloud": {
      "url": 
        "https://gdelt-cloud-mcp.fastmcp.app/mcp",
      "auth": "bearer",
      "env": {
        "GDELT_API_KEY": "gdelt_sk_..."
      }
    }
  }
}
Connected to GDELT Cloud MCP Server
gdelt_research_system_prompt available
5 categories · resources as tools · prompts as tools

Live Connection

v2
GDELT Catalog
5
Tool Categories
2
System Prompts
OAuth
or API Keys