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

# ChatGPT

> Connect GDELT Cloud MCP to ChatGPT (web)

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

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

## Setup

<Steps>
  <Step title="Enable Developer Mode">
    1. Open ChatGPT and go to **Settings**
    2. Select the **Connectors** tab
    3. Click **Advanced settings**
    4. Toggle on **Developer Mode**
  </Step>

  <Step title="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**
  </Step>

  <Step title="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
  </Step>

  <Step title="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"*
  </Step>
</Steps>

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

## Official Documentation

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

<Card title="OpenAI MCP Documentation" icon="link" href="https://developers.openai.com/api/docs/mcp/">
  Building MCP servers for ChatGPT Apps and API integrations
</Card>
