Get ReliefWeb Disaster
reliefweb_get_disasterRead-onlyIdempotent
Fetch a disaster record by ReliefWeb numeric ID including description, affected countries, GLIDE number, profile overview, key content links, and active appeals or response plans. Use after reliefweb_search_disasters to retrieve full details. Each curated list also has an archive, which the record leaves out. Two alternative selectors, at most one per call: sections names parts of the record to return, archive pages one list's archived entries in place of the record. Description and profile overview can together run to tens of KB for major disasters. A record over the response budget comes back as a section outline naming every section and its byte size. Nothing is truncated on any path.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "reliefweb_get_disaster"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ReliefWeb numeric disaster ID. Obtained from reliefweb_search_disasters results. | |
| archive | No | Archive mode: return a page of one curated list's ARCHIVED entries instead of the disaster record. The response carries the record identity, the selected list, and total / shown / offset, plus a next offset while more entries remain. Mutually exclusive with sections — sections slices the record, archive replaces it — and a call supplying both is rejected. A record over the response budget still answers an archive call with the page: a page is bounded by limit and carries none of the record prose, so it never outlines. | |
| sections | No | Sections of the disaster record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated. This names parts of the record itself and never reaches archived entries — use archive for those. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ReliefWeb numeric disaster ID. | |
| kind | No | full when the record — or the sections asked for — is returned in whole; outline when the record exceeded the response budget and only its section index is returned; archive when the call asked for a page of one curated list's archived entries, which is returned in place of the record. | |
| name | No | Disaster name. | |
| error | No | Present when the call failed. Absent on success. | |
| glide | No | GLIDE number for cross-system correlation. | |
| types | No | Disaster type names. | |
| notice | No | Requested and applied archive limits when the page size was clamped. | |
| status | No | Disaster status: alert, ongoing, past, or alert-archive. | |
| archive | No | One page of a curated list's archived entries, returned in place of the record. | |
| sections | No | Every section of the record, largest first. Pass the names back in `sections` to retrieve them. | |
| urlAlias | No | Canonical ReliefWeb URL for this disaster. | |
| countries | No | All countries tagged on this disaster. | |
| dateEvent | No | Event date (ISO 8601), when available. | |
| keyContent | No | Currently-active curated key content links from the ReliefWeb editorial team — the present curated set. The archived entries are reachable with archive: { list: "keyContent" }. | |
| dateCreated | No | ReliefWeb index date (ISO 8601). | |
| description | No | Full disaster description text. | |
| primaryType | No | Primary disaster type. | |
| usefulLinks | No | Currently-active useful external links curated by ReliefWeb editors — the present set. The archived entries are reachable with archive: { list: "usefulLinks" }. | |
| outlineNotice | No | How to re-call this tool for specific sections of the record. | |
| primaryCountry | No | Primary affected country. | |
| profileOverview | No | Profile overview text from the ReliefWeb editorial team. | |
| appealsResponsePlans | No | Currently-active appeals and response plans linked to this disaster — the present set. The archived entries are reachable with archive: { list: "appealsResponsePlans" }. |