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.

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