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

# Integrations overview

> Use GDELT Cloud from your agent, IDE, or app via MCP

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.

<Info>
  **MCP Server URL:** `https://gdelt-cloud-mcp.fastmcp.app/mcp` (Streamable HTTP, OAuth or API key)
</Info>

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

<CardGroup cols={2}>
  <Card title="Claude (web & desktop)" icon="link" href="/mcp/integrations/claude">
    Add as a custom connector (OAuth). Native UI supported.
  </Card>

  <Card title="ChatGPT" icon="link" href="/mcp/integrations/chatgpt">
    Add as a connector in developer mode. Native UI supported.
  </Card>

  <Card title="Claude Code" icon="terminal" href="/mcp/integrations/claude-code">
    `claude mcp add` or install the GDELT Cloud plugin.
  </Card>

  <Card title="Codex" icon="terminal" href="/mcp/integrations/codex">
    Add to `~/.codex/config.toml` and build against the API.
  </Card>

  <Card title="LangChain / custom agents" icon="code" href="/mcp/integrations/langchain">
    Use the MCP adapter with an API key.
  </Card>

  <Card title="MCP Registry" icon="box" href="https://registry.modelcontextprotocol.io">
    Discoverable as `io.github.ledgerW/gdelt-cloud`.
  </Card>
</CardGroup>

## 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](https://gdeltcloud.com/dashboard).

Every data tool call consumes Query Units against your plan. Track usage in the
native UI meter or your dashboard; see [pricing](https://gdeltcloud.com/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](/mcp/quickstart) and the
[API reference](/api-reference). For agent/IDE use, pick a surface above.