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

ChatGPT supports connecting to remote MCP servers in supported plans and environments. Use this page as the GDELT Cloud configuration guide, and consult OpenAI’s current MCP documentation for ChatGPT-specific availability.
MCP Server URL: https://gdelt-cloud-mcp.fastmcp.app/mcp

​
Setup

1

Enable Developer Mode

  1. Open ChatGPT and go to Settings
  2. Select the Connectors tab
  3. Click Advanced settings
  4. Toggle on Developer Mode
2

Create a custom connector

  1. In Connectors settings, click Create
  2. Fill in the details:
    • Name: GDELT Cloud
    • Description: Generated GDELT Cloud Events, Stories, Entities, and analyst enrichment tools
    • MCP Server URL: https://gdelt-cloud-mcp.fastmcp.app/mcp
    • Authentication: OAuth
  3. Click Create
3

Authorize the connection

  1. ChatGPT will initiate the OAuth connection
  2. You’ll be redirected to GDELT Cloud to authorize access
  3. Log in and click Allow Access
  4. After authorization, you’ll be redirected back to ChatGPT
4

Use in conversations

  1. Start a new chat
  2. Click the + icon in the composer and select More
  3. Choose Developer mode to open the data source selector
  4. Select GDELT Cloud as a source for this conversation
  5. Ask questions like “Show protests in India by day” or “Find data center project Stories in Asia”

​
Example Prompts

Once connected, try these in ChatGPT:
  • “Show protests in India by day over the past month.”
  • “Find new data center project Stories in Asia, then drill into linked Events.”
  • “Show fatal conflict Events in Lebanon this week with citations.”
  • “What Entities are linked to this Story and what Events do they connect to?”
  • “Assess sanctions and market implications from the latest shipping disruption signals. Use GDELT first, then macro finance and prediction markets if useful.”

​
Requirements

  • A ChatGPT plan and environment with remote MCP connector support
  • GDELT Cloud account with API access
  • Valid API key from your dashboard

​
Official Documentation

For more details on ChatGPT’s MCP support, see OpenAI’s official guide:

OpenAI MCP Documentation

Building MCP servers for ChatGPT Apps and API integrations