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

The MCP server exposes compact code resources for interpretation. Public v2 queries should use the typed parameters exposed by gdelt_cloud_tool_get; this page is supporting reference, not a separate tool contract.

​
Public v2 Event Families

FamilyUse
conflictGDELT Cloud generated Conflict Events: political violence, protests, riots, strategic developments, fatalities, and conflict geo.
cameoplusGDELT Cloud generated CAMEO+ Events: political, economic, corporate, technology, infrastructure, health, information, and environment domains.

​
Public CAMEO+ Domains

DomainDescription
POLITICALCAMEO-style diplomatic, cooperative, verbal conflict, and non-violent coercive political events.
ECONOMICMacroeconomic, monetary, fiscal, trade, market stress, currency, and sovereign debt events.
CORPORATEM&A, bankruptcy, production capacity, capital allocation, legal/regulatory, leadership, and supply-chain shocks.
TECHNOLOGYAI, cyber, strategic technology controls, space, military technology, and critical tech infrastructure.
INFRASTRUCTUREEnergy, transport, supply chain, communications, sabotage, and water infrastructure.
HEALTHDisease outbreaks, public health emergencies, vaccines/treatments, policy actions, and health-system crises.
INFORMATIONDisinformation, information control, major leaks, and narrative warfare.
ENVIRONMENTGeophysical hazards, meteorological hazards, climate events, pollution, and environmental policy.

​
Conflict Categories

Public v2 category and subcategory values are returned by the API and should be inspected from live results. The most common Conflict categories include:
  • Battles
  • Explosions/Remote violence
  • Violence against civilians
  • Protests
  • Riots
  • Strategic developments
Use category="Protests" for protest monitoring. Use has_fatalities=true rather than fatality min/max filters.

​
Goldstein Scale

metrics.goldstein_scale is public and important:
  • present for all Conflict Events
  • present for CAMEO+ POLITICAL Events where meaningful
  • null for non-political CAMEO+ domains
Interpretation:
RangeMeaning
+5 to +10Cooperative or conciliatory action.
-4 to +4Neutral, mixed, or low-intensity action.
-5 to -10Conflictual, coercive, violent, or severe action.

​
Geography

Use plain English country names in public calls. ISO-3 and legacy FIPS are accepted as aliases. Public outputs normalize to country names. admin1 values must be discovered one country at a time with list_admin1; do not assume a global admin1 catalog is returned.

​
Resources

The server also exposes compact resources:
  • gdelt://codes/cameo-country
  • gdelt://codes/cameo-event
  • gdelt://codes/goldstein-scale
Use them for interpretation, but rely on gdelt_cloud_tool_get for the current callable schema.