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

# Claude Code

> Use GDELT Cloud from Claude Code (CLI) — connector or plugin

## Overview

Add GDELT Cloud to [Claude Code](https://claude.com/claude-code) to research
and build against generated Events, Stories, Entities, energy assets, and
market/macro enrichment directly from your terminal.

<Info>
  **MCP Server URL:** `https://gdelt-cloud-mcp.fastmcp.app/mcp`
</Info>

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

```bash theme={null}
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:

```bash theme={null}
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`:

```json theme={null}
{
  "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:

```bash theme={null}
claude plugin marketplace add https://github.com/ledgerW/gdelt-cloud
claude plugin install gdelt-cloud
```

<Note>
  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.
</Note>

## Use it

```text theme={null}
> 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](https://gdeltcloud.com/dashboard) (optional if using OAuth)

Each data tool call consumes Query Units against your plan — see
[pricing](https://gdeltcloud.com/pricing).