event_counts_by_country
Pack: acled · Endpoint: https://gateway.pipeworx.io/acled/mcp
Aggregate event and fatality counts by country over a date range. Useful for cross-country comparison and time-bounded risk snapshots.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
event_date_from | string | no | YYYY-MM-DD inclusive |
event_date_to | string | no | YYYY-MM-DD inclusive |
region | string | no | Optional region restriction |
event_type | string | no | Optional event-type restriction |
limit | number | no | Underlying-event cap (1-5000, default 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":"event_counts_by_country","arguments":{}}}'Response shape
Always returns: total_events, countries, truncated, breakdown
| Field | Type | Description |
|---|---|---|
total_events | number | Total events processed |
countries | number | Number of countries with events |
truncated | boolean | Whether results were capped at 5000 events |
breakdown | array | Aggregated counts per country, sorted by event count descending |
Full JSON Schema
{
"type": "object",
"properties": {
"total_events": {
"type": "number",
"description": "Total events processed"
},
"countries": {
"type": "number",
"description": "Number of countries with events"
},
"truncated": {
"type": "boolean",
"description": "Whether results were capped at 5000 events"
},
"breakdown": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string",
"description": "Country name"
},
"events": {
"type": "number",
"description": "Total events in country"
},
"fatalities": {
"type": "number",
"description": "Total fatalities in country"
},
"by_type": {
"type": "object",
"additionalProperties": {
"type": "number"
},
"description": "Event count by type"
}
},
"required": [
"country",
"events",
"fatalities",
"by_type"
]
},
"description": "Aggregated counts per country, sorted by event count descending"
}
},
"required": [
"total_events",
"countries",
"truncated",
"breakdown"
]
}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.