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

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.