GDELT Cloud Docs — Global Event Data API & MCP

Overview

Add GDELT Cloud to Claude Code to research and build against generated Events, Stories, Entities, energy assets, and market/macro enrichment directly from your terminal.

MCP Server URL: https://gdelt-cloud-mcp.fastmcp.app/mcp

Option 1 — Add as an MCP server (quickest)

claude mcp add --transport http gdelt-cloud https://gdelt-cloud-mcp.fastmcp.app/mcp

On first use, Claude Code runs the OAuth consent flow in your browser. To use an API key instead of OAuth:

claude mcp add --transport http gdelt-cloud https://gdelt-cloud-mcp.fastmcp.app/mcp \
  --header "Authorization: Bearer gdelt_sk_your_key"

Or commit a project-scoped .mcp.json:

{
  "mcpServers": {
    "gdelt-cloud": {
      "type": "http",
      "url": "https://gdelt-cloud-mcp.fastmcp.app/mcp"
    }
  }
}

Option 2 — Install the GDELT Cloud plugin

The plugin bundles the connector config so teammates get it in one install. The marketplace manifest lives at gdelt-cloud-mcp/.claude-plugin/ in the repo:

claude plugin marketplace add https://github.com/ledgerW/gdelt-cloud
claude plugin install gdelt-cloud

If the marketplace isn’t found at the repository root, point Claude Code at the gdelt-cloud-mcp subdirectory (where .claude-plugin/marketplace.json lives), or just use Option 1 — it requires no plugin.

Use it

> use gdelt_cloud_tool_list to see what GDELT Cloud offers
> search the last 7 days of fatal conflict events in the Sahel and cite sources
> summarize energy assets by fuel for Country X

Discovery is progressive: gdelt_cloud_tool_list → gdelt_cloud_tool_get → gdelt_cloud_tool_call (same pattern for energy, prediction_market, macro_finance, web_research).

Requirements

Claude Code installed and signed in
GDELT Cloud account; an API key from your dashboard (optional if using OAuth)

Each data tool call consumes Query Units against your plan — see pricing.

Overview

Tools

Resources

Skills

Prompts

Integrations

Claude Code

Overview

Option 1 — Add as an MCP server (quickest)

Option 2 — Install the GDELT Cloud plugin

Use it

Requirements

​Overview

​Option 1 — Add as an MCP server (quickest)

​Option 2 — Install the GDELT Cloud plugin

​Use it

​Requirements

Overview

Option 1 — Add as an MCP server (quickest)

Option 2 — Install the GDELT Cloud plugin

Use it

Requirements