Skip to main content

Overview

Claude supports connecting to remote MCP servers via custom connectors, available on Claude.ai (web) and Claude Desktop. This lets you query GDELT data directly in Claude conversations.
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.aiSettingsConnectors
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 “What are today’s top stories?” or “Find news about trade policy”

Claude Desktop

Claude Desktop supports both remote MCP connections (custom connectors) and local MCP servers. The same custom connector setup works on Claude Desktop:
  1. Open Claude Desktop → SettingsConnectors
  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 SettingsExtensions on Claude Desktop
  2. Click Advanced settingsExtension 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:
  • “What are today’s top global news stories?”
  • “Find stories about AI regulation in the EU”
  • “Show me conflict news involving China this week”
  • “Look up the entity profile for Donald Trump”
  • “What does BBC cover most?”

Requirements

  • Claude Free, Pro, Max, Team, or Enterprise plan (Free users limited to 1 custom connector)
  • GDELT Cloud account on the Analyst or Professional plan
  • Valid API key from your dashboard

Official Documentation