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

# Codex

> Use GDELT Cloud from OpenAI Codex via MCP

## Overview

[Codex](https://developers.openai.com/codex/) can connect to remote MCP
servers. Add GDELT Cloud to build against generated Events, Stories, Entities,
energy assets, and market/macro enrichment.

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

## Configure

Add the server to `~/.codex/config.toml`:

```toml theme={null}
[mcp_servers.gdelt_cloud]
url = "https://gdelt-cloud-mcp.fastmcp.app/mcp"
# Use an API key for non-interactive runs; omit to use OAuth.
# bearer_token = "gdelt_sk_your_key"
```

Restart Codex so it picks up the new server. The GDELT Cloud tools then appear
under the progressive-discovery trio (`gdelt_cloud_tool_list` /
`gdelt_cloud_tool_get` / `gdelt_cloud_tool_call`, plus the `energy`,
`prediction_market`, `macro_finance`, and `web_research` categories).

## Use it

```text theme={null}
List the GDELT Cloud tools, then pull the last week of trade-policy events
for Country X and the linked stories, and cite the public URLs.
```

## Requirements

* Codex with MCP support, signed in
* GDELT Cloud account; an API key from your [dashboard](https://gdeltcloud.com/dashboard) for key auth (optional if using OAuth)

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