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

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

​
Claude Web (claude.ai)

Connect to GDELT Cloud as a custom connector in the Claude web interface.
1

Open Connectors settings

Go to claude.ai → Settings → Connectors
2

Add custom connector

  1. Click Add custom connector (or “Add external MCP server”)
  2. Enter the GDELT Cloud MCP server URL: https://gdelt-cloud-mcp.fastmcp.app/mcp
  3. Follow the OAuth consent flow to authorize access with your GDELT Cloud account
3

Enable in conversations

  1. After connecting, toggle the connector on
  2. In a new chat, click the Tools icon and ensure the GDELT Cloud tools are enabled
  3. Ask questions like “Show protests in India by day” or “Find trade-policy Events and related Stories”

​
Claude Desktop

Claude Desktop supports both remote MCP connections (custom connectors) and local MCP servers.

​
Option 1: Remote connector (recommended)

The same custom connector setup works on Claude Desktop:
  1. Open Claude Desktop → Settings → Connectors
  2. Add a custom connector with the GDELT Cloud MCP URL
  3. Authorize via OAuth

​
Option 2: Local proxy (advanced)

For advanced users who want to run a local MCP proxy:
  1. Navigate to Settings → Extensions on Claude Desktop
  2. Click Advanced settings → Extension Developer section
  3. Configure a local MCP server that proxies to the GDELT Cloud remote endpoint
See Anthropic’s local MCP server guide for details.

​
Example Prompts

Once connected, try these in Claude:
  • “Show protests in India by day over the past month.”
  • “Find Stories about AI regulation in the EU and list linked structured Events.”
  • “Show fatal conflict Events in Lebanon this week with citations.”
  • “Look up linked Entities for this Story and explain their relationship to the Events.”
  • “Assess sanctions and market implications from the latest energy corridor disruption signals. Use GDELT first, then macro finance and prediction markets if useful.”

​
Requirements

  • A Claude plan and environment with MCP/custom connector support
  • GDELT Cloud account with API access
  • Valid API key from your dashboard

​
Official Documentation

Custom Connectors (Remote MCP)

Anthropic’s guide to connecting remote MCP servers as custom connectors

Local MCP Servers

Setting up local MCP servers on Claude Desktop