Overview
The GDELT MCP server exposes three CAMEO code reference resources that help you build effective queries with the correct filter values. Access them via resource URIs or through the read_resource tool.
Available Resources
Country Codes (gdelt://codes/cameo-country)
ISO-3 country codes for the actor_country parameter in get_media_events. These filter by WHO is involved.
Common codes: USA, GBR, CHN, RUS, DEU, FRA, IRN, ISR, IND, JPN, BRA, CAN, AUS, KOR, MEX, TUR, SAU, UKR, POL
Don’t confuse with FIPS location codes. ISO-3 (3-letter) = WHO (actors). FIPS (2-letter) = WHERE (locations).
location parameter: US, UK, CH, RS, GM, FR, IR, IS, IN, JA, BR, CA, AS, KS, MX, TU, SA, UP, PL
Event Codes (gdelt://codes/cameo-event)
CAMEO event root codes (01–20) for the event_type parameter. These filter by WHAT happened.
| Code | Description |
|---|
| 01 | Make public statement |
| 02 | Appeal |
| 03 | Express intent to cooperate |
| 04 | Consult |
| 05 | Engage in diplomatic cooperation |
| 06 | Engage in material cooperation |
| 07 | Provide aid |
| 08 | Yield |
| 09 | Investigate |
| 10 | Demand |
| 11 | Disapprove |
| 12 | Reject |
| 13 | Threaten |
| 14 | Protest |
| 15 | Exhibit force posture |
| 16 | Reduce relations |
| 17 | Coerce |
| 18 | Assault |
| 19 | Fight |
| 20 | Use unconventional mass violence |
Goldstein Scale (gdelt://codes/goldstein-scale)
Event intensity reference from -10 (most conflictual) to +10 (most cooperative).
| Range | Interpretation |
|---|
| -10 to -7 | Violent conflict (fight, assault, mass violence) |
| -6 to -4 | Non-violent conflict (threaten, coerce, sanction) |
| -3 to -1 | Mild conflict (disapprove, reject, protest) |
| 0 | Neutral (investigate, make statement) |
| +1 to +2 | Mild cooperation (consult, appeal) |
| +3 to +6 | Material cooperation (aid, economic cooperation) |
| +7 to +10 | Strong cooperation (major agreements, alliances) |
Accessing Resources
# Read a resource directly
country_codes = await client.read_resource("gdelt://codes/cameo-country")
print(country_codes.text)
