> ## 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.

# Code And Metric Reference

> CAMEO, Conflict, CAMEO+, and Goldstein references for GDELT Cloud v2

## 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

| Family      | Use                                                                                                                                            |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `conflict`  | GDELT Cloud generated Conflict Events: political violence, protests, riots, strategic developments, fatalities, and conflict geo.              |
| `cameoplus` | GDELT Cloud generated CAMEO+ Events: political, economic, corporate, technology, infrastructure, health, information, and environment domains. |

## Public CAMEO+ Domains

| Domain           | Description                                                                                                       |
| ---------------- | ----------------------------------------------------------------------------------------------------------------- |
| `POLITICAL`      | CAMEO-style diplomatic, cooperative, verbal conflict, and non-violent coercive political events.                  |
| `CRIME`          | Ordinary crime, criminal justice, policing, trafficking, organized crime, and custody events.                     |
| `ECONOMIC`       | Macroeconomic, monetary, fiscal, trade, market stress, currency, and sovereign debt events.                       |
| `CORPORATE`      | M\&A, bankruptcy, production capacity, capital allocation, legal/regulatory, leadership, and supply-chain shocks. |
| `TECHNOLOGY`     | AI, cyber, strategic technology controls, space, military technology, and critical tech infrastructure.           |
| `INFRASTRUCTURE` | Energy, transport, supply chain, communications, sabotage, and water infrastructure.                              |
| `HEALTH`         | Disease outbreaks, public health emergencies, vaccines/treatments, policy actions, and health-system crises.      |
| `INFORMATION`    | Disinformation, information control, major leaks, and narrative warfare.                                          |
| `ENVIRONMENT`    | Geophysical hazards, meteorological hazards, climate events, pollution, and environmental policy.                 |
| `DEMOGRAPHIC`    | Refugee flows, migration events, population crises, and labor events.                                             |

## 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:

| Range         | Meaning                                           |
| ------------- | ------------------------------------------------- |
| `+5` to `+10` | Cooperative or conciliatory action.               |
| `-4` to `+4`  | Neutral, mixed, or low-intensity action.          |
| `-5` to `-10` | Conflictual, 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.