@pipeworx/ucdp

Connect: https://gateway.pipeworx.io/ucdp/mcp · Install: one-click buttons

Tools: 5

Uppsala Conflict Data Program (UCDP) — armed-conflict fatalities, active conflicts and georeferenced violence events for every country since 1989, from the published UCDP yearly datasets, the monthly GED Candidate release, and (with a token) the UCDP API.

Tools

  • ucdp_fatalities_summary(country, year? | from?/to?) — deaths from organized violence for a country-year: best/low/high, split state-based / non-state / one-sided, combatants vs civilians, named dyads. Answers “how many people were killed in the Sudan war in 2024”.
  • ucdp_conflicts(country?, year?, intensity?) — UCDP/PRIO armed conflicts active in a year with parties, incompatibility, type, intensity, episode dates and battle-related deaths.
  • ucdp_countries(query?, region?, min_deaths?) — the 199 coded countries with Gleditsch-Ward codes, coverage years and latest-year deaths (sorted by deaths).
  • ucdp_recent_events(country?, type_of_violence?, min_deaths?, limit?) — individual events from the newest monthly GED Candidate file (preliminary, current year).
  • ucdp_events(country, start?, end?, type_of_violence?, limit?, page?, version?, _apiKey) — GED events for any date range 1989 onward via the UCDP API. Requires an API key.

Auth

Keyless for the first four tools. ucdp_events is BYO only: pass a UCDP API access token as _apiKey (sent as the x-ucdp-access-token header).

Activation caveat

UCDP tokens are not self-service. Since 2025 every API call needs a token, and tokens are issued by emailing the API maintainer (address and template at https://ucdp.uu.se/apidocs) with a description of the intended use; requests are answered in 3–5 working days. Without a token every ucdpapi.pcr.uu.se call returns HTTP 401 “API token required” — that is the vendor gate, not an outage.

When a platform token exists: set PLATFORM_UCDP_TOKEN on the gateway AND add platformKeyEnv: 'PLATFORM_UCDP_TOKEN' to the pack’s MCP_PACKS entry in the same deploy. Declaring platformKeyEnv while the secret is unset key-blocks every tool in the pack from routing, including the keyless ones.

Data sources

Traps:

  • The full GED zip (ged261-csv.zip) is 39 MB and inflates far beyond what a Worker can hold — event history before the current month needs the API.
  • UCDP names states by continuity: “Russia (Soviet Union)”, “Yemen (North Yemen)”, “DR Congo (Zaire)”, “Myanmar (Burma)”. The resolver accepts the common names and aliases (DRC, USA, UK, Côte d’Ivoire, Eswatini, Czechia, Türkiye, Timor-Leste…) and Gleditsch-Ward codes; Palestine/Gaza/West Bank map to Israel because UCDP codes sovereign states only.
  • sb_dyad_names / ns_dyad_names / os_dyad_names are ;-separated inside one CSV field.
  • All UCDP counts use a 25-deaths-per-dyad-year inclusion threshold; a country with real but diffuse violence can show zero.

Tools

  • ucdp_fatalities_summary — Deaths from armed conflict and organized violence in a country for a year or range of years, from the Uppsala Conflict Data Program (UCDP) country-year dataset: best, low and high fatality estimates s
  • ucdp_conflicts — Armed conflicts recorded by UCDP/PRIO for a country or year: the government and rebel/state parties, whether the fight is over territory or government, intrastate / interstate / internationalized type
  • ucdp_countries — The countries the Uppsala Conflict Data Program codes, with their Gleditsch-Ward country codes, region, years covered and the latest year’s total deaths from organized violence. Use it to resolve a co
  • ucdp_recent_events — Individual violence events from the newest monthly UCDP GED Candidate release — the preliminary current-year event list, published monthly: date, place with coordinates, warring sides, type (state-bas
  • ucdp_events — Georeferenced armed-conflict events from the UCDP Georeferenced Event Dataset (GED) for a country and date range, 1989 to the latest yearly release: each event with date, location and coordinates, sid

Tools

  • ucdp_conflicts — Armed conflicts recorded by UCDP/PRIO for a country or year: the government and rebel/state parties, whether the fight is over territory or government, intrastate / interstate / internationalized type
  • ucdp_countries — The countries the Uppsala Conflict Data Program codes, with their Gleditsch-Ward country codes, region, years covered and the latest year's total deaths from organized violence. Use it to resolve a co
  • ucdp_events — Georeferenced armed-conflict events from the UCDP Georeferenced Event Dataset (GED) for a country and date range, 1989 to the latest yearly release: each event with date, location and coordinates, sid
  • ucdp_fatalities_summary — Deaths from armed conflict and organized violence in a country for a year or range of years, from the Uppsala Conflict Data Program (UCDP) country-year dataset: best, low and high fatality estimates s
  • ucdp_recent_events — Individual violence events from the newest monthly UCDP GED Candidate release — the preliminary current-year event list, published monthly: date, place with coordinates, warring sides, type (state-bas

Regenerated from source · build September 3, 2026