reliefweb_disasters
Pack: reliefweb · Endpoint: https://gateway.pipeworx.io/reliefweb/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/reliefweb_disasters for the schema, then POST the same URL with its arguments for the data.
The ReliefWeb disaster register — UN OCHA’s curated list of humanitarian emergencies, each with a GLIDE number, disaster type, affected countries, event date and whether it is ongoing, alert or past. AUTHORITATIVE for “which humanitarian emergencies are active right now” and for resolving a crisis to the identifier the rest of the humanitarian system uses. Filter by country, status or disaster type, or search the name. Requires a caller-supplied ReliefWeb appname in _apiKey.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | no | Free-text search over disaster name and description, e.g. “Horn of Africa”. |
country | string | no | Country name or ISO3 code, e.g. “Afghanistan” or “AFG”. |
status | string | no | Disaster status: “ongoing”, “alert” or “past”. Omit for all. |
disaster_type | string | no | Disaster type, e.g. “Flood”, “Earthquake”, “Drought”. |
include_description | boolean | no | Include the disaster description text (default false). |
limit | number | no | Max disasters to return (default 10, max 100). |
offset | number | no | Skip this many results, for paging (default 0). |
Example call
Arguments
{
"_apiKey": "your-reliefweb-appname",
"status": "ongoing",
"limit": 10
}
curl
curl -X POST https://gateway.pipeworx.io/reliefweb/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reliefweb_disasters","arguments":{"_apiKey":"your-reliefweb-appname","status":"ongoing","limit":10}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('reliefweb_disasters', {
"_apiKey": "your-reliefweb-appname",
"status": "ongoing",
"limit": 10
});
More examples
{
"_apiKey": "your-reliefweb-appname",
"country": "AFG",
"disaster_type": "Earthquake"
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"reliefweb": {
"url": "https://gateway.pipeworx.io/reliefweb/mcp"
}
}
}
See Getting Started for client-specific install steps.