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":{}}}'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.