GDELT Cloud Docs — Global Event Data API & MCP

Overview

Codex can connect to remote MCP servers. Add GDELT Cloud to build against generated Events, Stories, Entities, energy assets, and market/macro enrichment.

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

Configure

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

[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

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 for key auth (optional if using OAuth)

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

Claude Code LangChain Integration

Overview

Tools

Resources

Skills

Prompts

Integrations

Codex

Overview

Configure

Use it

Requirements

​Overview

​Configure

​Use it

​Requirements

Overview

Configure

Use it

Requirements