Ucdp MCP server

@pipeworx/ucdp

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.

Part of Pipeworx — an MCP gateway connecting AI agents to 1576+ live data sources.

Tools

• ucdpfatalitiessummary(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.
• ucdpcountries(query?, region?, mindeaths?) — the 199 coded countries with Gleditsch-Ward codes, coverage years and latest-year deaths (sorted by deaths).
• ucdprecentevents(country?, typeofviolence?, min_deaths?, limit?) — individual events from the newest monthly GED Candidate file (preliminary, current year).
• ucdpevents(country, start?, end?, typeofviolence?, 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. ucdpevents is BYO only: pass a UCDP API access token as apiKey (sent as the x-ucdp-access-token header). This is a standing decision, not a gap: Bruce ruled BYOK on 2026-09-03 (fleet #1226), so Pipeworx will not request a platform token, and the refusal without one says "requires an API key" and points at https://ucdp.uu.se/apidocs.

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.

If that decision is ever revisited and a platform token exists: set PLATFORMUCDPTOKEN on the gateway AND add platformKeyEnv: 'PLATFORMUCDPTOKEN' 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

• https://ucdp.uu.se/downloads/ — the downloads index. Read once per isolate to discover the newest yearly version (organizedviolencecy--csv.zip, re-released each June as vNN.1) and the newest monthly GED Candidate file (candidateged/GEDEventv.csv). Falls back to pinned v26.1 / 26.0.7 if the page cannot be read.
• https://ucdp.uu.se/downloads/organizedviolencecy/organizedviolencecy-261-csv.zip — Organized Violence Country-Year dataset (167 KB zip, 7,132 rows, 1989–2025). Backs ucdpfatalitiessummary and ucdp_countries.
• https://ucdp.uu.se/downloads/ucdpprio/ucdp-prio-acd-261-csv.zip — UCDP/PRIO Armed Conflict Dataset (1946–2025).
• https://ucdp.uu.se/downloads/brd/ucdp-brd-conf-261-csv.zip — Battle-Related Deaths, conflict level (1989–2025). Joined to ACD on conflict_id + year.
• https://ucdp.uu.se/downloads/candidateged/GEDEventv2607.csv — monthly GED Candidate (~1.4 MB, one month of preliminary events). Quarterly files (GEDEventv260126_06.csv, ~8 MB) are deliberately not fetched.
• https://ucdpapi.pcr.uu.se/api/gedevents/ — GED via the API. Filters: Country= (multiple allowed), StartDate/EndDate (YYYY-MM-DD, match on date_end), TypeOfViolence=1|2|3, pagesize + page (1-based). Requesting a page past TotalPages returns a server error rather than an empty set. Result order is arbitrary.

Shortened. The full README is on GitHub.