Skip to main content

​
Overview

The GDELT Cloud MCP (Model Context Protocol) server provides AI agents with secure, direct access to GDELT event data. Enable Claude Desktop, Cursor, and custom AI agents to query global events, analyze trends, and access comprehensive CAMEO taxonomy data.
MCP Server URL: https://gdelt-cloud-mcp.fastmcp.app/mcpUse this URL to connect your MCP client to GDELT Cloud.

API Key Authentication

Secure access using GDELT Cloud API keys

Complete CAMEO Codes

All country codes, event types, and actor classifications

Query Tools

Direct SQL queries against Events and GKG tables

MCP Resources

Schema docs, query patterns, and best practices

​
What is MCP?

The Model Context Protocol is an open standard that allows AI applications to securely connect to external data sources and tools. GDELT Cloud’s MCP server implements this protocol to provide:
  • Tools: Functions AI agents can call to query GDELT data
  • Resources: Static reference documentation (CAMEO codes, schemas)
  • Prompts: Pre-built query patterns for common use cases
MCP enables AI agents to access GDELT data without you writing custom integration code. Just configure the connection and let the AI handle the queries.

​
Available Capabilities

The GDELT MCP server provides three types of capabilities:

​
Tools

Interactive functions that AI agents can call:
  • prepare_query: Validate and optimize SQL queries before execution
  • execute_query: Run SQL queries against GDELT events and GKG data
  • present_sql: Format SQL queries for user review (used in alert creation)
  • get_resource: Retrieve CAMEO codes and schema documentation

​
Resources

Static documentation accessible via resource URIs:
  • schemas: Database schema documentation for GDELT tables
  • codes: CAMEO taxonomy including country codes, event types, actor classifications, and GKG themes

​
Prompts

Pre-configured prompt templates:
  • system-prompt: Core system prompt for GDELT query assistance

​
Getting Started

Quickstart

5-minute setup guide for your first MCP connection

Authentication

Learn about API key authentication for the MCP server

Tools Reference

Complete documentation of available MCP tools

LangChain Integration

Build AI agents with GDELT MCP tools

​
Requirements

  • GDELT Cloud account
  • MCP-compatible client (Claude Desktop, Cursor, FastMCP, etc.)
  • Valid API key from your dashboard

​
Data Access

The MCP server provides access to:
  • 30 days of rolling GDELT data
  • 15-minute update frequency
  • Events and GKG tables
  • Extracted entities (persons, organizations, locations, themes)
  • Complete CAMEO taxonomy (countries, event codes, actors)

​
Next Steps

1

Read the Quickstart

Follow our Quickstart Guide to set up your first connection
2

Set up authentication

Generate an API key from your dashboard to authenticate MCP requests. See Authentication Guide.
3

Configure your client

See our LangChain Integration Guide to build AI agents with GDELT MCP tools