Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt

Use this file to discover all available pages before exploring further.

GDELT Cloud is a remote MCP server. One URL works everywhere — connect it as a connector, add it to your IDE, or discover it in the MCP Registry.
MCP Server URL: https://gdelt-cloud-mcp.fastmcp.app/mcp (Streamable HTTP, OAuth or API key)
In hosts that support MCP Apps (Claude web/desktop) or the ChatGPT Apps SDK, results render as native interactive UI — Events, Stories, Entities, energy assets, and prediction markets in the GDELT Cloud theme, with a live Query-Unit meter. Other clients receive the same data as structured JSON.

​
Connect

Claude (web & desktop)

Add as a custom connector (OAuth). Native UI supported.

ChatGPT

Add as a connector in developer mode. Native UI supported.

Claude Code

claude mcp add or install the GDELT Cloud plugin.

Codex

Add to ~/.codex/config.toml and build against the API.

LangChain / custom agents

Use the MCP adapter with an API key.

MCP Registry

Discoverable as io.github.ledgerW/gdelt-cloud.

​
Authentication at a glance

  • OAuth 2.1 — best for interactive connectors (Claude, ChatGPT). Browser consent on first connect; tokens refresh automatically.
  • API key (gdelt_sk_…) — best for Codex, Claude Code, CI, and custom agents. Create one in your dashboard.
Every data tool call consumes Query Units against your plan. Track usage in the native UI meter or your dashboard; see pricing for more QU.

​
Building against GDELT Cloud

The MCP server and the REST v2 API expose the same structured data. For programmatic access, start with the Quickstart and the API reference. For agent/IDE use, pick a surface above.