`ucdp_events`

Pack: ucdp · Endpoint: https://gateway.pipeworx.io/ucdp/mcp

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, sides, violence type and best/low/high deaths. Answers “list the deadliest events in Sudan in 2024” or “battles in Donetsk in March 2023”. Requires a UCDP API access token passed as _apiKey. Example: ucdp_events({ country: “Sudan”, start: “2024-01-01”, end: “2024-12-31”, limit: 100, _apiKey: “your-token” })

Parameters

Name	Type	Required	Description
`country`	string	yes	Country name or Gleditsch-Ward code
`start`	string	no	Earliest event end date, YYYY-MM-DD
`end`	string	no	Latest event end date, YYYY-MM-DD
`type_of_violence`	string	no	state-based \| non-state \| one-sided (or 1 \| 2 \| 3)
`limit`	integer	no	Events per page (default 100, max 1000)
`page`	integer	no	Page number, 1-based
`version`	string	no	GED release, default “26.1”; candidate releases like “26.0.7” work too
`_apiKey`	string	yes	UCDP API access token (x-ucdp-access-token). Request one free from the API maintainer at https://ucdp.uu.se/apidocs

Example call

Arguments

{
  "country": "Sudan",
  "start": "2024-01-01",
  "end": "2024-12-31",
  "limit": 5,
  "_apiKey": "your-ucdp-token"
}

curl

curl -X POST https://gateway.pipeworx.io/ucdp/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ucdp_events","arguments":{"country":"Sudan","start":"2024-01-01","end":"2024-12-31","limit":5,"_apiKey":"your-ucdp-token"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('ucdp_events', {
  "country": "Sudan",
  "start": "2024-01-01",
  "end": "2024-12-31",
  "limit": 5,
  "_apiKey": "your-ucdp-token"
});

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "ucdp": {
      "url": "https://gateway.pipeworx.io/ucdp/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

ucdp_events