Skip to main content

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

Public CAMEO+ Domains

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:

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.