search_events
Pack: acled · Endpoint: https://gateway.pipeworx.io/acled/mcp
Search ACLED political-violence and protest events. Filter by country (use ”|” to OR, e.g., “Ukraine|Russia”), region, event_type, actor, ISO country code, or date range. Returns date, lat/lon, actors, event type, fatalities, and source notes.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
country | string | no | Country name(s), pipe-separated for OR |
region | string | no | ACLED region (e.g., “Western Africa”) |
event_type | string | no | Battles | Protests | Riots | Explosions/Remote violence | Violence against civilians | Strategic developments |
sub_event_type | string | no | Optional ACLED sub-event type |
actor | string | no | Match actor1 or actor2 (partial substring ok) |
iso | number | no | ISO 3166-1 numeric country code (alternative to country) |
event_date_from | string | no | YYYY-MM-DD inclusive |
event_date_to | string | no | YYYY-MM-DD inclusive |
year | number | no | Restrict to a calendar year |
fatalities_min | number | no | Minimum fatalities filter |
limit | number | no | Records to return (1-5000, default 100; ACLED max-per-call is 5000) |
Example call
curl -X POST https://gateway.pipeworx.io/acled/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_events","arguments":{}}}'Response shape
Always returns: count, events
| Field | Type | Description |
|---|---|---|
count | number | Number of events returned |
events | array | Array of conflict events |
Full JSON Schema
{
"type": "object",
"properties": {
"count": {
"type": "number",
"description": "Number of events returned"
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"data_id": {
"type": [
"string",
"null"
],
"description": "ACLED data identifier"
},
"event_id_cnty": {
"type": [
"string",
"null"
],
"description": "Country-specific event ID"
},
"event_date": {
"type": [
"string",
"null"
],
"description": "Date of event (ISO format)"
},
"year": {
"type": [
"number",
"null"
],
"description": "Year of event"
},
"event_type": {
"type": [
"string",
"null"
],
"description": "Type of event (e.g., Battles, Protests)"
},
"sub_event_type": {
"type": [
"string",
"null"
],
"description": "Sub-category of event type"
},
"actor1": {
"type": [
"string",
"null"
],
"description": "Primary actor involved"
},
"actor2": {
"type": [
"string",
"null"
],
"description": "Secondary actor involved"
},
"country": {
"type": [
"string",
"null"
],
"description": "Country where event occurred"
},
"iso": {
"type": [
"number",
"null"
],
"description": "ISO 3166-1 numeric country code"
},
"region": {
"type": [
"string",
"null"
],
"description": "ACLED geographic region"
},
"admin1": {
"type": [
"string",
"null"
],
"description": "Primary administrative division"
},
"admin2": {
"type": [
"string",
"null"
],
"description": "Secondary administrative division"
},
"location": {
"type": [
"string",
"null"
],
"description": "Specific location name"
},
"latitude": {
"type": [
"number",
"null"
],
"description": "Latitude coordinate"
},
"longitude": {
"type": [
"number",
"null"
],
"description": "Longitude coordinate"
},
"fatalities": {
"type": "number",
"description": "Number of fatalities (0 if not specified)"
},
"notes": {
"type": [
"string",
"null"
],
"description": "Additional event notes"
},
"source": {
"type": [
"string",
"null"
],
"description": "Data source"
},
"source_scale": {
"type": [
"string",
"null"
],
"description": "Scale of source coverage"
}
}
},
"description": "Array of conflict events"
}
},
"required": [
"count",
"events"
]
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"acled": {
"url": "https://gateway.pipeworx.io/acled/mcp"
}
}
}See Getting Started for client-specific install steps.