reliefweb-mcp-server
An MCP server that allows agents to search and retrieve humanitarian reports, disaster data, job listings, training opportunities, and country profiles from ReliefWeb, OCHA's information hub for crisis response. It supports filtering by country, disaster, format, theme, language, source, and date, and provides tools to fetch full report bodies and detailed records.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://reliefweb.caseyjhand.com/mcpWhat its tools do
11 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search humanitarian reports by country and disaster type
- Retrieve full text of specific relief reports
- Find humanitarian job listings by organization
- Get country profiles and disaster details
Source and maintenance
Community listingRegistry 0.3.0
- Maintenance checked
Protocol and capabilities
- Server
- reliefweb-mcp-server 0.3.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 11 advertised
- Resources
- 1 advertised
- Resource templates
- 4 advertised
- Prompts
- 1 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"logging": {},
"prompts": {
"listChanged": true
},
"resources": {
"subscribe": true,
"listChanged": true
},
"extensions": {
"io.modelcontextprotocol/skills": {
"directoryRead": true
}
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
11 advertised
reliefweb_search_reports — Search ReliefWeb Reports
Advertised read-onlyOpen-world
Search humanitarian reports on ReliefWeb with filtering by country, disaster, format, theme, language, source, and date. Returns paginated summaries — use reliefweb_get_report to fetch full body text. Report body is excluded from results (10–100KB each); call get_report when document content is needed. Every report is reachable by default — reports have no archived class, so include_archived has no effect here. Note: each call counts against the 1,000 calls/day quota.
reliefweb_search_reports input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"type": "string",
"description": "Sort order. Use date.original:desc for newest first (default), date.original:asc for oldest first, score:desc for relevance."
},
"text": {
"type": "string",
"description": "Full-text search query. Matches against title, body, and key metadata fields. Use plain natural language or keywords."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results to return (1–1000, default 10). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Use a smaller value for targeted lookups; larger for bulk research. Each call counts against the 1,000-calls/day quota."
},
"theme": {
"type": "string",
"description": "Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Shelter and Non-Food Items, Protection). Open-ended — matches theme.name exactly as ReliefWeb spells it."
},
"filter": {
"type": "object",
"description": "Raw ReliefWeb filter object for compound conditions not covered by named params. Example: {\"operator\": \"AND\", \"conditions\": [{\"field\": \"format.name\", \"value\": \"Map\"}, {\"field\": \"language.code\", \"value\": \"fr\"}]}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"format": {
"type": "string",
"description": "Content format filter. One of: News and Press Release, Situation Report, Map, Infographic, Analysis, Other, Assessment, Manual and Guideline, Appeal, UN Document, Evaluation and Lessons Learned. Case, spacing, and punctuation are ignored; any other value is rejected with the valid list."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through large result sets."
},
"source": {
"type": "string",
"description": "Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to content tagged with this country."
},
"date_to": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-01-31) or full ISO 8601 datetime (2024-01-31T23:59:59+00:00)."
}
],
"description": "Latest publication date. Pair with date_from for a date range. A bare calendar date resolves to end of that day in UTC, so the range covers it in full; a datetime carrying any offset is resolved to UTC."
},
"language": {
"type": "string",
"description": "ISO 639-1 language code (e.g., en, fr, es, ar). Filters on language.code."
},
"date_from": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-01-15) or full ISO 8601 datetime (2024-01-15T00:00:00+00:00)."
}
],
"description": "Earliest publication date. Filters on date.original (source publication date). A bare calendar date such as 2024-01-15 is accepted and resolves to start of that day in UTC; a datetime carrying any offset is resolved to UTC."
},
"disaster_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "ReliefWeb numeric disaster ID. Filters to reports linked to a specific disaster. Get the ID from reliefweb_search_disasters."
},
"include_archived": {
"type": "boolean",
"description": "No effect on reports. Reports have no archived class — every report is already in scope, whatever this is set to. Kept so existing calls that pass it keep working; it is meaningful on reliefweb_search_jobs, reliefweb_search_training, and reliefweb_search_disasters."
}
},
"additionalProperties": false
}reliefweb_search_reports output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"appliedFilters",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"invalid_date",
"unknown_format",
"invalid_query",
"upstream_error"
],
"description": "Machine-readable failure mode. Declared by this tool: `invalid_date`: A date bound contains impossible calendar or time components. `unknown_format`: The format value does not name a ReliefWeb report format. `invalid_query`: ReliefWeb rejected the query — possible causes include malformed text, an unrecognized sort field, an invalid raw filter object, or a malformed date. `upstream_error`: The ReliefWeb API was unreachable, timed out, or returned a server error. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title"
],
"properties": {
"id": {
"type": "number",
"description": "ReliefWeb numeric report ID."
},
"title": {
"type": "string",
"description": "Report title."
},
"themes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Humanitarian theme/sector names."
},
"formats": {
"type": "array",
"items": {
"type": "string"
},
"description": "Content format names."
},
"sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "Publishing organizations (short names)."
},
"fileUrls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Direct file download URLs attached to this report."
},
"urlAlias": {
"type": "string",
"description": "Canonical ReliefWeb URL for this report."
},
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "All countries tagged on this report."
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Language codes (ISO 639-1)."
},
"dateCreated": {
"type": "string",
"description": "ReliefWeb index date (ISO 8601)."
},
"dateOriginal": {
"type": "string",
"description": "Source publication date (ISO 8601)."
},
"primaryCountry": {
"type": "string",
"description": "Primary country name for this report."
},
"headlineSummary": {
"type": "string",
"description": "Short editorial summary from the headline block, when present."
}
},
"description": "A matching report summary.",
"additionalProperties": false
},
"description": "Matching reports (summaries only — use reliefweb_get_report for full body)."
},
"notice": {
"type": "string",
"description": "Discloses requested and applied limits when clamped, an ignored empty raw filter, and empty-page guidance with the match count and last reachable offset or suggestions to broaden the search."
},
"totalCount": {
"type": "number",
"description": "Total reports matching the query before pagination."
},
"appliedFilters": {
"type": "object",
"required": [
"sort",
"preset",
"limit",
"offset"
],
"properties": {
"sort": {
"type": "string",
"description": "Sort order the query used (resolved, including the default)."
},
"text": {
"type": "string",
"description": "Full-text query the search used."
},
"limit": {
"type": "number",
"description": "Result limit the query used."
},
"theme": {
"type": "string",
"description": "Theme name filter applied."
},
"dateTo": {
"type": "string",
"description": "Latest publication date filter applied."
},
"format": {
"type": "string",
"description": "Format name filter applied, in its canonical ReliefWeb spelling."
},
"offset": {
"type": "number",
"description": "Pagination offset the query used."
},
"preset": {
"type": "string",
"description": "ReliefWeb preset the query used. Always latest for reports — no preset changes which reports match."
},
"source": {
"type": "string",
"description": "Source short name filter applied."
},
"country": {
"type": "string",
"description": "Country code as normalized (uppercased ISO3)."
},
"dateFrom": {
"type": "string",
"description": "Earliest publication date filter applied."
},
"language": {
"type": "string",
"description": "Language code filter applied."
},
"rawFilter": {
"type": "boolean",
"description": "True when a raw compound filter object was merged into the query."
},
"disasterId": {
"type": "number",
"description": "Disaster ID filter applied."
}
},
"description": "The resolved filter set the query actually ran with, after normalization and defaults. Echoes back so the agent can confirm how its inputs were interpreted.",
"additionalProperties": false
}
},
"additionalProperties": false
}reliefweb_search_reports annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}reliefweb_get_report — Get ReliefWeb Report
Advertised read-onlyOpen-world
Fetch a single ReliefWeb report by its numeric ID with full body text, file attachments, and all metadata. Use after reliefweb_search_reports to retrieve document content — body is excluded from search results to manage context budget. Report bodies can be 10–100KB. A record over the response budget comes back as a section outline naming every section and its byte size; re-call with sections to pull only the ones needed. Nothing is truncated on either path.
reliefweb_get_report input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "ReliefWeb numeric report ID. Obtained from reliefweb_search_reports results.",
"exclusiveMinimum": 0
},
"sections": {
"type": "array",
"items": {
"type": "string",
"description": "A section name exactly as the outline response spelled it."
},
"description": "Sections of the report 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."
}
},
"additionalProperties": false
}reliefweb_get_report output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"kind"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "number",
"description": "ReliefWeb numeric report ID."
},
"body": {
"type": "string",
"description": "Full report body text (Markdown). Present for most reports; absent for binary-only documents."
},
"kind": {
"enum": [
"full",
"outline"
],
"type": "string",
"description": "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."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"not_found"
],
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: No report found with the given ID. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"title": {
"type": "string",
"description": "Report title."
},
"themes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Humanitarian theme/sector names."
},
"formats": {
"type": "array",
"items": {
"type": "string"
},
"description": "Content format names."
},
"sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "Publishing organizations (short names)."
},
"fileUrls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Direct file download URLs attached to this report."
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"bytes"
],
"properties": {
"name": {
"type": "string",
"description": "Section identifier — pass in `sections` to retrieve it"
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Serialized byte size of the section"
}
},
"description": "One retrievable section of the record: its name and its serialized size.",
"additionalProperties": false
},
"description": "Every section of the record, largest first. Pass the names back in `sections` to retrieve them."
},
"urlAlias": {
"type": "string",
"description": "Canonical ReliefWeb URL for this report."
},
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "All countries tagged on this report."
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Language codes (ISO 639-1)."
},
"dateCreated": {
"type": "string",
"description": "ReliefWeb index date (ISO 8601)."
},
"dateOriginal": {
"type": "string",
"description": "Source publication date (ISO 8601)."
},
"outlineNotice": {
"type": "string",
"description": "How to re-call this tool for specific sections of the record."
},
"primaryCountry": {
"type": "string",
"description": "Primary country name for this report."
},
"headlineSummary": {
"type": "string",
"description": "Short editorial summary from the headline block, when present."
}
},
"additionalProperties": false
}reliefweb_get_report annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}reliefweb_search_disasters — Search ReliefWeb Disasters
Advertised read-onlyOpen-world
Search active and historical disasters on ReliefWeb by type, country, status, date range, and GLIDE number. Default preset covers alert, ongoing, and past disasters. Use include_archived=true to reach alert-archive entries as well, for historical research. Returns IDs suitable for use with reliefweb_get_disaster and as disaster_id filter in reliefweb_search_reports.
reliefweb_search_disasters input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"type": "string",
"description": "Sort order. Use date.created:desc for newest first (default), date.created:asc for oldest, score:desc for relevance."
},
"text": {
"type": "string",
"description": "Full-text search query. Matches against disaster name and description."
},
"glide": {
"type": "string",
"description": "GLIDE number (global disaster identifier, e.g., EQ-2023-000053-TUR). Use for cross-system disaster correlation."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results to return (1–1000, default 10). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Each call counts against the 1,000-calls/day quota."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results."
},
"status": {
"type": "string",
"description": "Disaster status filter. One of: alert (newly declared), ongoing, past (resolved), alert-archive. Separate multiple values with commas; case, spacing, and punctuation are ignored, and any other value is rejected with the valid list. alert-archive is only reachable with include_archived=true — asking for it without that returns nothing."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to disasters tagged with this country."
},
"date_to": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-01-31) or full ISO 8601 datetime (2024-01-31T23:59:59+00:00)."
}
],
"description": "Latest disaster creation date. Pair with date_from for a date range. A bare calendar date resolves to end of that day in UTC, so the range covers it in full; a datetime carrying any offset is resolved to UTC."
},
"date_from": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-01-15) or full ISO 8601 datetime (2024-01-15T00:00:00+00:00)."
}
],
"description": "Earliest disaster creation date. Filters on date.created. A bare calendar date such as 2024-01-15 is accepted and resolves to start of that day in UTC; a datetime carrying any offset is resolved to UTC."
},
"disaster_type": {
"type": "string",
"description": "Disaster type name (e.g., Earthquake, Flood, Drought, Cyclone). Filters on type.name."
},
"include_archived": {
"type": "boolean",
"description": "Include alert-archive disasters in results, alongside alert, ongoing, and past. Uses preset=analysis. Off by default."
}
},
"additionalProperties": false
}reliefweb_search_disasters output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"appliedFilters",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"invalid_date",
"unknown_status",
"invalid_query",
"upstream_error"
],
"description": "Machine-readable failure mode. Declared by this tool: `invalid_date`: A date bound contains impossible calendar or time components. `unknown_status`: A status token does not name a ReliefWeb disaster status. `invalid_query`: ReliefWeb rejected the query — possible causes include malformed text, an unrecognized sort field, or a malformed date. `upstream_error`: The ReliefWeb API was unreachable, timed out, or returned a server error. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "number",
"description": "ReliefWeb numeric disaster ID."
},
"name": {
"type": "string",
"description": "Disaster name."
},
"glide": {
"type": "string",
"description": "GLIDE number for cross-system correlation."
},
"types": {
"type": "array",
"items": {
"type": "string"
},
"description": "Disaster type names."
},
"status": {
"type": "string",
"description": "Disaster status: alert, ongoing, past, or alert-archive."
},
"urlAlias": {
"type": "string",
"description": "Canonical ReliefWeb URL for this disaster."
},
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "All countries tagged on this disaster."
},
"dateEvent": {
"type": "string",
"description": "Event date (ISO 8601), when available."
},
"dateCreated": {
"type": "string",
"description": "ReliefWeb index date (ISO 8601)."
},
"primaryType": {
"type": "string",
"description": "Primary disaster type."
},
"primaryCountry": {
"type": "string",
"description": "Primary affected country."
}
},
"description": "A matching disaster record.",
"additionalProperties": false
},
"description": "Matching disasters."
},
"notice": {
"type": "string",
"description": "Discloses requested and applied limits when clamped. For empty pages, names the match count and last reachable offset when records matched; otherwise echoes filters and suggests how to broaden."
},
"totalCount": {
"type": "number",
"description": "Total disasters matching the query before pagination."
},
"appliedFilters": {
"type": "object",
"required": [
"sort",
"preset",
"limit",
"offset"
],
"properties": {
"sort": {
"type": "string",
"description": "Sort order the query used (resolved, including the default)."
},
"text": {
"type": "string",
"description": "Full-text query the search used."
},
"glide": {
"type": "string",
"description": "GLIDE number filter applied."
},
"limit": {
"type": "number",
"description": "Result limit the query used."
},
"dateTo": {
"type": "string",
"description": "Latest creation date filter applied."
},
"offset": {
"type": "number",
"description": "Pagination offset the query used."
},
"preset": {
"type": "string",
"description": "ReliefWeb preset the query used: latest (default) or analysis when include_archived."
},
"status": {
"type": "string",
"description": "Status filter applied, in canonical spelling (comma-joined when multiple)."
},
"country": {
"type": "string",
"description": "Country code as normalized (uppercased ISO3)."
},
"dateFrom": {
"type": "string",
"description": "Earliest creation date filter applied."
},
"disasterType": {
"type": "string",
"description": "Disaster type name filter applied."
}
},
"description": "The resolved filter set the query actually ran with, after normalization and defaults. Echoes back so the agent can confirm how its inputs were interpreted.",
"additionalProperties": false
}
},
"additionalProperties": false
}reliefweb_search_disasters annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}reliefweb_get_disaster — Get ReliefWeb Disaster
Advertised read-onlyOpen-world
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.
reliefweb_get_disaster input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "ReliefWeb numeric disaster ID. Obtained from reliefweb_search_disasters results.",
"exclusiveMinimum": 0
},
"archive": {
"type": "object",
"required": [
"list"
],
"properties": {
"list": {
"enum": [
"keyContent",
"appealsResponsePlans",
"usefulLinks"
],
"type": "string",
"description": "Which curated list to page. The archived entries of that list are the ones the profile itself leaves out."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Maximum archived entries in one page (1-100). Larger integers are clamped with a notice when clamping is enabled; otherwise they are rejected."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based index of the first archived entry to return. Send back the nextOffset from the previous page to continue."
}
},
"description": "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": {
"type": "array",
"items": {
"type": "string",
"description": "A section name exactly as the outline response spelled it."
},
"description": "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."
}
},
"additionalProperties": false
}reliefweb_get_disaster output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"kind"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "number",
"description": "ReliefWeb numeric disaster ID."
},
"kind": {
"enum": [
"full",
"outline",
"archive"
],
"type": "string",
"description": "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": {
"type": "string",
"description": "Disaster name."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"not_found",
"selector_conflict"
],
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: No disaster found with the given ID. `selector_conflict`: The call supplied both sections and archive, which select different things. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"glide": {
"type": "string",
"description": "GLIDE number for cross-system correlation."
},
"types": {
"type": "array",
"items": {
"type": "string"
},
"description": "Disaster type names."
},
"notice": {
"type": "string",
"description": "Requested and applied archive limits when the page size was clamped."
},
"status": {
"type": "string",
"description": "Disaster status: alert, ongoing, past, or alert-archive."
},
"archive": {
"type": "object",
"required": [
"list",
"total",
"shown",
"offset",
"entries"
],
"properties": {
"list": {
"enum": [
"keyContent",
"appealsResponsePlans",
"usefulLinks"
],
"type": "string",
"description": "The curated list this page was read from."
},
"shown": {
"type": "number",
"description": "Number of entries in this page."
},
"total": {
"type": "number",
"description": "Total archived entries in that list for this record."
},
"offset": {
"type": "number",
"description": "Zero-based index of the first entry in this page."
},
"entries": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Entry URL."
},
"date": {
"type": "string",
"description": "Publication date, carried by appeals and response plans."
},
"title": {
"type": "string",
"description": "Entry title."
}
},
"description": "One archived entry.",
"additionalProperties": false
},
"description": "The archived entries in this page, in ReliefWeb's own archive order."
},
"nextOffset": {
"type": "number",
"description": "Offset to send back to read the next page. Absent when this page reaches the end of the archive."
}
},
"description": "One page of a curated list's archived entries, returned in place of the record.",
"additionalProperties": false
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"bytes"
],
"properties": {
"name": {
"type": "string",
"description": "Section identifier — pass in `sections` to retrieve it"
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Serialized byte size of the section"
}
},
"description": "One retrievable section of the record: its name and its serialized size.",
"additionalProperties": false
},
"description": "Every section of the record, largest first. Pass the names back in `sections` to retrieve them."
},
"urlAlias": {
"type": "string",
"description": "Canonical ReliefWeb URL for this disaster."
},
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "All countries tagged on this disaster."
},
"dateEvent": {
"type": "string",
"description": "Event date (ISO 8601), when available."
},
"keyContent": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Link URL."
},
"title": {
"type": "string",
"description": "Link title."
}
},
"description": "A curated key content link.",
"additionalProperties": false
},
"description": "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": {
"type": "string",
"description": "ReliefWeb index date (ISO 8601)."
},
"description": {
"type": "string",
"description": "Full disaster description text."
},
"primaryType": {
"type": "string",
"description": "Primary disaster type."
},
"usefulLinks": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Link URL."
},
"title": {
"type": "string",
"description": "Link title."
}
},
"description": "A useful external link.",
"additionalProperties": false
},
"description": "Currently-active useful external links curated by ReliefWeb editors — the present set. The archived entries are reachable with archive: { list: \"usefulLinks\" }."
},
"outlineNotice": {
"type": "string",
"description": "How to re-call this tool for specific sections of the record."
},
"primaryCountry": {
"type": "string",
"description": "Primary affected country."
},
"profileOverview": {
"type": "string",
"description": "Profile overview text from the ReliefWeb editorial team."
},
"appealsResponsePlans": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Link URL."
},
"date": {
"type": "string",
"description": "Publication date."
},
"title": {
"type": "string",
"description": "Appeal or response plan title."
}
},
"description": "An appeal or response plan entry.",
"additionalProperties": false
},
"description": "Currently-active appeals and response plans linked to this disaster — the present set. The archived entries are reachable with archive: { list: \"appealsResponsePlans\" }."
}
},
"additionalProperties": false
}reliefweb_get_disaster annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}reliefweb_get_country — Get ReliefWeb Country Profile
Advertised read-onlyOpen-world
Fetch a country profile from ReliefWeb by ISO3 code, including overview, humanitarian situation summary, key content links, active appeals and response plans, and useful external links. Country profiles are curated by OCHA editors and provide the authoritative situation summary for humanitarian responders. Each curated list also has an archive — thousands of entries deep for a long-running crisis — which the profile leaves out. Two alternative selectors, at most one per call: sections names parts of the profile to return, archive pages one list's archived entries in place of the profile. A profile over the response budget comes back as a section outline naming every section and its byte size. Nothing is truncated on any path.
reliefweb_get_country input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"iso3"
],
"properties": {
"iso3": {
"type": "string",
"maxLength": 3,
"minLength": 3,
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Used to look up the country's ReliefWeb profile."
},
"archive": {
"type": "object",
"required": [
"list"
],
"properties": {
"list": {
"enum": [
"keyContent",
"appealsResponsePlans",
"usefulLinks"
],
"type": "string",
"description": "Which curated list to page. The archived entries of that list are the ones the profile itself leaves out."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Maximum archived entries in one page (1-100). Larger integers are clamped with a notice when clamping is enabled; otherwise they are rejected."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based index of the first archived entry to return. Send back the nextOffset from the previous page to continue."
}
},
"description": "Archive mode: return a page of one curated list's ARCHIVED entries instead of the country 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": {
"type": "array",
"items": {
"type": "string",
"description": "A section name exactly as the outline response spelled it."
},
"description": "Sections of the country 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 profile itself and never reaches archived entries — use archive for those."
}
},
"additionalProperties": false
}reliefweb_get_country output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"kind"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "number",
"description": "ReliefWeb numeric country ID."
},
"iso3": {
"type": "string",
"description": "ISO 3166-1 alpha-3 code."
},
"kind": {
"enum": [
"full",
"outline",
"archive"
],
"type": "string",
"description": "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": {
"type": "string",
"description": "Country name."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"not_found",
"selector_conflict"
],
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: No country profile found for the given ISO3 code. `selector_conflict`: The call supplied both sections and archive, which select different things. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"notice": {
"type": "string",
"description": "Requested and applied archive limits when the page size was clamped."
},
"status": {
"type": "string",
"description": "Humanitarian situation status."
},
"archive": {
"type": "object",
"required": [
"list",
"total",
"shown",
"offset",
"entries"
],
"properties": {
"list": {
"enum": [
"keyContent",
"appealsResponsePlans",
"usefulLinks"
],
"type": "string",
"description": "The curated list this page was read from."
},
"shown": {
"type": "number",
"description": "Number of entries in this page."
},
"total": {
"type": "number",
"description": "Total archived entries in that list for this record."
},
"offset": {
"type": "number",
"description": "Zero-based index of the first entry in this page."
},
"entries": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Entry URL."
},
"date": {
"type": "string",
"description": "Publication date, carried by appeals and response plans."
},
"title": {
"type": "string",
"description": "Entry title."
}
},
"description": "One archived entry.",
"additionalProperties": false
},
"description": "The archived entries in this page, in ReliefWeb's own archive order."
},
"nextOffset": {
"type": "number",
"description": "Offset to send back to read the next page. Absent when this page reaches the end of the archive."
}
},
"description": "One page of a curated list's archived entries, returned in place of the record.",
"additionalProperties": false
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"bytes"
],
"properties": {
"name": {
"type": "string",
"description": "Section identifier — pass in `sections` to retrieve it"
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Serialized byte size of the section"
}
},
"description": "One retrievable section of the record: its name and its serialized size.",
"additionalProperties": false
},
"description": "Every section of the record, largest first. Pass the names back in `sections` to retrieve them."
},
"urlAlias": {
"type": "string",
"description": "Canonical ReliefWeb URL for this country page."
},
"keyContent": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Link URL."
},
"title": {
"type": "string",
"description": "Link title."
}
},
"description": "A curated key content link.",
"additionalProperties": false
},
"description": "Currently-active curated key content links maintained by ReliefWeb editors — the present curated set. The archived entries are reachable with archive: { list: \"keyContent\" }."
},
"usefulLinks": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Link URL."
},
"title": {
"type": "string",
"description": "Link title."
}
},
"description": "A useful external link.",
"additionalProperties": false
},
"description": "Currently-active useful external links curated by ReliefWeb editors — the present set. The archived entries are reachable with archive: { list: \"usefulLinks\" }."
},
"outlineNotice": {
"type": "string",
"description": "How to re-call this tool for specific sections of the record."
},
"profileOverview": {
"type": "string",
"description": "Situation overview text from the ReliefWeb editorial team."
},
"appealsResponsePlans": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Link URL."
},
"date": {
"type": "string",
"description": "Publication date."
},
"title": {
"type": "string",
"description": "Appeal or response plan title."
}
},
"description": "An appeal or response plan entry.",
"additionalProperties": false
},
"description": "Currently-active humanitarian appeals and response plans for this country — the present set. The archived entries are reachable with archive: { list: \"appealsResponsePlans\" }."
}
},
"additionalProperties": false
}reliefweb_get_country annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}reliefweb_list_countries — List ReliefWeb Countries
Advertised read-onlyOpen-world
List all countries and territories tracked by ReliefWeb, optionally filtered to active humanitarian situations. Returns ISO3 codes and status for each entry — use the ISO3 code with reliefweb_get_country to fetch a full profile. Set crisis_only=true to limit results to countries with active humanitarian situations.
reliefweb_list_countries input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 100,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results to return (1–1000, default 100). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Each call counts against the 1,000-calls/day quota."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results."
},
"crisis_only": {
"type": "boolean",
"description": "When true, filters to countries with an active humanitarian situation (status ongoing). Default false returns all countries."
}
},
"additionalProperties": false
}reliefweb_list_countries output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"invalid_query",
"upstream_error"
],
"description": "Machine-readable failure mode. Declared by this tool: `invalid_query`: ReliefWeb rejected the request as malformed rather than failing to serve it. `upstream_error`: The ReliefWeb API was unreachable, timed out, or returned a server error. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "number",
"description": "ReliefWeb numeric country ID."
},
"iso3": {
"type": "string",
"description": "ISO 3166-1 alpha-3 code for use with reliefweb_get_country."
},
"name": {
"type": "string",
"description": "Country or territory name."
},
"status": {
"type": "string",
"description": "Humanitarian situation status: ongoing (active crisis) or normal (non-crisis)."
},
"urlAlias": {
"type": "string",
"description": "Canonical ReliefWeb URL for this country page."
}
},
"description": "A country or territory tracked by ReliefWeb.",
"additionalProperties": false
},
"description": "Countries tracked by ReliefWeb."
},
"notice": {
"type": "string",
"description": "Discloses requested and applied limits when clamped. For empty pages, names the match count and last reachable offset when records matched; otherwise echoes filters and suggests how to broaden."
},
"totalCount": {
"type": "number",
"description": "Total countries matching the filter before pagination."
}
},
"additionalProperties": false
}reliefweb_list_countries annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}reliefweb_search_jobs — Search ReliefWeb Jobs
Advertised read-onlyOpen-world
Search humanitarian job listings on ReliefWeb by country, organization, career category, theme, and experience level. Returns current open positions — expired postings are excluded by default. Use include_archived=true to search the full history of postings, which is far larger than the open set. Use text search for role titles and job descriptions.
reliefweb_search_jobs input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"type": "string",
"description": "Sort order. Use date.created:desc for newest postings first (default), date.closing:asc to surface roles closing soonest, or score:desc for relevance."
},
"text": {
"type": "string",
"description": "Full-text search query. Matches against job title, body, and key metadata fields."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results to return (1–1000, default 10). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Each call counts against the 1,000-calls/day quota."
},
"theme": {
"type": "string",
"description": "Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Protection). Filters on theme.name."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results."
},
"source": {
"type": "string",
"description": "Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to jobs tagged with this country."
},
"experience": {
"type": "string",
"description": "Experience level (e.g., 0-2 years, 3-4 years, 5-9 years). Filters on experience.name."
},
"career_category": {
"type": "string",
"description": "ReliefWeb career-category name (e.g., Program/Project Management, Information and Communications Technology, Logistics/Procurement). Filters on career_categories.name."
},
"include_archived": {
"type": "boolean",
"description": "Search expired postings alongside the open ones. Uses preset=analysis. Off by default — the open set is a small fraction of the archive, so turn this on for labour-market history rather than for a hiring snapshot."
}
},
"additionalProperties": false
}reliefweb_search_jobs output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"appliedFilters",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"invalid_query",
"upstream_error"
],
"description": "Machine-readable failure mode. Declared by this tool: `invalid_query`: ReliefWeb rejected the query — possible causes include malformed text or an unrecognized sort field. `upstream_error`: The ReliefWeb API was unreachable, timed out, or returned a server error. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title"
],
"properties": {
"id": {
"type": "number",
"description": "ReliefWeb numeric job ID."
},
"title": {
"type": "string",
"description": "Job title."
},
"types": {
"type": "array",
"items": {
"type": "string"
},
"description": "Job type names."
},
"themes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Humanitarian theme/sector names."
},
"sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "Hiring organizations (short names)."
},
"urlAlias": {
"type": "string",
"description": "Canonical ReliefWeb URL for this job listing."
},
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Countries tagged on this job."
},
"dateClosing": {
"type": "string",
"description": "Application closing date (ISO 8601)."
},
"dateCreated": {
"type": "string",
"description": "Date this job was indexed (ISO 8601)."
},
"careerCategories": {
"type": "array",
"items": {
"type": "string"
},
"description": "Career category names (humanitarian tracks)."
},
"experienceLevels": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required experience levels."
}
},
"description": "A matching job listing.",
"additionalProperties": false
},
"description": "Matching job listings."
},
"notice": {
"type": "string",
"description": "Discloses requested and applied limits when clamped. For empty pages, names the match count and last reachable offset when records matched; otherwise echoes filters and suggests how to broaden."
},
"totalCount": {
"type": "number",
"description": "Total jobs matching the query before pagination."
},
"appliedFilters": {
"type": "object",
"required": [
"sort",
"preset",
"limit",
"offset"
],
"properties": {
"sort": {
"type": "string",
"description": "Sort order the query used (resolved, including the default)."
},
"text": {
"type": "string",
"description": "Full-text query the search used."
},
"limit": {
"type": "number",
"description": "Result limit the query used."
},
"theme": {
"type": "string",
"description": "Theme name filter applied."
},
"offset": {
"type": "number",
"description": "Pagination offset the query used."
},
"preset": {
"type": "string",
"description": "ReliefWeb preset the query used: latest (open postings only, default) or analysis when include_archived."
},
"source": {
"type": "string",
"description": "Source short name filter applied."
},
"country": {
"type": "string",
"description": "Country code as normalized (uppercased ISO3)."
},
"experience": {
"type": "string",
"description": "Experience level filter applied."
},
"careerCategory": {
"type": "string",
"description": "Career category name filter applied."
}
},
"description": "The resolved filter set the query actually ran with, after normalization and defaults. Echoes back so the agent can confirm how its inputs were interpreted.",
"additionalProperties": false
}
},
"additionalProperties": false
}reliefweb_search_jobs annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}reliefweb_get_job — Get ReliefWeb Job
Advertised read-onlyOpen-world
Fetch a job posting by ReliefWeb numeric ID with the full vacancy description, application instructions, dates, hiring organization, and location and taxonomy metadata. Use after reliefweb_search_jobs, which returns summaries without the description or application instructions. Reaches expired postings as well as open ones. A record over the response budget comes back as a section outline naming every section and its byte size; re-call with sections to pull only the ones needed. Nothing is truncated on either path.
reliefweb_get_job input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "ReliefWeb numeric job ID. Obtained from reliefweb_search_jobs results.",
"exclusiveMinimum": 0
},
"sections": {
"type": "array",
"items": {
"type": "string",
"description": "A section name exactly as the outline response spelled it."
},
"description": "Sections of the job 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."
}
},
"additionalProperties": false
}reliefweb_get_job output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"kind"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "number",
"description": "ReliefWeb numeric job ID."
},
"url": {
"type": "string",
"description": "ReliefWeb node URL for this job listing."
},
"body": {
"type": "string",
"description": "Full vacancy description (Markdown) — duties, requirements, and conditions."
},
"kind": {
"enum": [
"full",
"outline"
],
"type": "string",
"description": "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."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"not_found"
],
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: No job posting found with the given ID. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"title": {
"type": "string",
"description": "Job title."
},
"types": {
"type": "array",
"items": {
"type": "string"
},
"description": "Job type names, such as Job or Consultancy."
},
"status": {
"type": "string",
"description": "Posting status: published while the vacancy is open, expired once it has closed."
},
"themes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Humanitarian theme/sector names."
},
"sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "Hiring organizations (short names)."
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"bytes"
],
"properties": {
"name": {
"type": "string",
"description": "Section identifier — pass in `sections` to retrieve it"
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Serialized byte size of the section"
}
},
"description": "One retrievable section of the record: its name and its serialized size.",
"additionalProperties": false
},
"description": "Every section of the record, largest first. Pass the names back in `sections` to retrieve them."
},
"urlAlias": {
"type": "string",
"description": "Canonical ReliefWeb URL for this job listing."
},
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Countries tagged on this job."
},
"howToApply": {
"type": "string",
"description": "Application instructions (Markdown) as published by the hiring organization."
},
"dateChanged": {
"type": "string",
"description": "Date this posting was last modified (ISO 8601)."
},
"dateClosing": {
"type": "string",
"description": "Application closing date (ISO 8601)."
},
"dateCreated": {
"type": "string",
"description": "Date this posting was indexed (ISO 8601)."
},
"outlineNotice": {
"type": "string",
"description": "How to re-call this tool for specific sections of the record."
},
"careerCategories": {
"type": "array",
"items": {
"type": "string"
},
"description": "Career category names (humanitarian tracks)."
},
"experienceLevels": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required experience levels."
}
},
"additionalProperties": false
}reliefweb_get_job annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}reliefweb_search_training — Search ReliefWeb Training
Advertised read-onlyOpen-world
Search humanitarian training and learning opportunities on ReliefWeb by country, format, date, source, career category, cost, listing language, and delivery language. Covers on-site and online capacity-building events. Training date fields use date.start / date.end — different from report date fields. Use date_start_from and date_start_to to find upcoming training within a window. Results default to soonest-starting first (date.start:asc). With neither date bound supplied the search is scoped to training starting from now, so the first page is upcoming opportunities; supply either bound to search an explicit range, including a historical one. Use include_archived=true to search concluded listings as well, which are far more numerous than the current ones.
reliefweb_search_training input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cost": {
"type": "string",
"description": "Training cost: free or fee-based. Case, spacing, and punctuation are ignored; blank is omitted."
},
"sort": {
"type": "string",
"description": "Sort order. Use date.start:asc for soonest-starting training first (default), date.start:desc for latest-starting, date.created:desc for most recently posted, or score:desc for relevance."
},
"text": {
"type": "string",
"description": "Full-text search query. Matches against training title and description."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results to return (1–1000, default 10). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Each call counts against the 1,000-calls/day quota."
},
"format": {
"enum": [
"on-site",
"online"
],
"type": "string",
"description": "Training format. Valid values: on-site, online. Filters on format.name."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results."
},
"source": {
"type": "string",
"description": "Organization short name. Filters on source.shortname."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-3 country code (e.g., KEN, ETH, COD). Filters to training tagged with this country."
},
"language": {
"type": "string",
"description": "Listing language code (ISO 639-1, e.g., en, fr, es). Filters on language.code; use training_language for the course delivery language."
},
"date_start_to": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-12-31) or full ISO 8601 datetime (2024-12-31T23:59:59+00:00)."
}
],
"description": "Training start date upper bound. Filters on date.start — pair with date_start_from for a window. A bare calendar date resolves to end of that day in UTC, and a datetime carrying any offset is resolved to UTC. Supplying this alone searches everything up to it, with no lower bound injected."
},
"career_category": {
"type": "string",
"description": "ReliefWeb career-category name (e.g., Program/Project Management, Information and Communications Technology, Logistics/Procurement). Filters on career_categories.name."
},
"date_start_from": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-06-01) or full ISO 8601 datetime (2024-06-01T00:00:00+00:00)."
}
],
"description": "Training start date lower bound. Filters on date.start — use to find training starting after a given date. A bare calendar date resolves to start of that day in UTC, and a datetime carrying any offset is resolved to UTC. Omit this and date_start_to together to default the search to training starting from now, unless include_archived is set, which leaves the range open."
},
"include_archived": {
"type": "boolean",
"description": "Search concluded listings alongside the current ones. Uses preset=analysis. Off by default. Setting this also drops the start-from-now default bound, so an otherwise unbounded search reaches back through the whole record; pair it with date_start_from and date_start_to to study a specific period."
},
"training_language": {
"type": "string",
"description": "Course delivery language code (ISO 639-1, e.g., en, fr, es). Filters on training_language.code independently of the listing language."
}
},
"additionalProperties": false
}reliefweb_search_training output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"appliedFilters",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unknown_cost",
"invalid_date",
"invalid_query",
"upstream_error"
],
"description": "Machine-readable failure mode. Declared by this tool: `unknown_cost`: The cost value does not name a ReliefWeb training cost category. `invalid_date`: A date bound contains impossible calendar or time components. `invalid_query`: ReliefWeb rejected the query — possible causes include malformed text, an unrecognized sort field, or a malformed date. `upstream_error`: The ReliefWeb API was unreachable, timed out, or returned a server error. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title"
],
"properties": {
"id": {
"type": "number",
"description": "ReliefWeb numeric training ID."
},
"cost": {
"type": "string",
"description": "Training cost category when supplied by the listing."
},
"title": {
"type": "string",
"description": "Training title."
},
"themes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Humanitarian theme/sector names."
},
"dateEnd": {
"type": "string",
"description": "Training end date (ISO 8601)."
},
"formats": {
"type": "array",
"items": {
"type": "string"
},
"description": "Training format names."
},
"sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "Organizing organizations (short names)."
},
"urlAlias": {
"type": "string",
"description": "Canonical ReliefWeb URL for this training listing."
},
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Countries tagged on this training."
},
"dateStart": {
"type": "string",
"description": "Training start date (ISO 8601)."
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Listing language codes (ISO 639-1)."
},
"careerCategories": {
"type": "array",
"items": {
"type": "string"
},
"description": "Career category names (humanitarian tracks)."
},
"dateRegistration": {
"type": "string",
"description": "Registration deadline (ISO 8601)."
},
"trainingLanguages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Course delivery language codes (ISO 639-1)."
}
},
"description": "A matching training opportunity.",
"additionalProperties": false
},
"description": "Matching training opportunities."
},
"notice": {
"type": "string",
"description": "Discloses requested and applied limits when clamped. For empty pages, names the match count and last reachable offset when records matched; otherwise echoes filters and suggests how to broaden."
},
"totalCount": {
"type": "number",
"description": "Total training listings matching the query before pagination."
},
"appliedFilters": {
"type": "object",
"required": [
"sort",
"preset",
"limit",
"offset"
],
"properties": {
"cost": {
"type": "string",
"description": "Canonical training cost filter applied."
},
"sort": {
"type": "string",
"description": "Sort order the query used (resolved, including the default)."
},
"text": {
"type": "string",
"description": "Full-text query the search used."
},
"limit": {
"type": "number",
"description": "Result limit the query used."
},
"format": {
"type": "string",
"description": "Training format name filter applied."
},
"offset": {
"type": "number",
"description": "Pagination offset the query used."
},
"preset": {
"type": "string",
"description": "ReliefWeb preset the query used: latest (current listings only, default) or analysis when include_archived."
},
"source": {
"type": "string",
"description": "Source short name filter applied."
},
"country": {
"type": "string",
"description": "Country code as normalized (uppercased ISO3)."
},
"language": {
"type": "string",
"description": "Listing language code filter applied."
},
"dateStartTo": {
"type": "string",
"description": "Training start date upper bound applied."
},
"dateStartFrom": {
"type": "string",
"description": "Training start date lower bound applied — the caller-supplied value, or the current timestamp when neither date bound was given and include_archived was off."
},
"careerCategory": {
"type": "string",
"description": "Career category name filter applied."
},
"trainingLanguage": {
"type": "string",
"description": "Course delivery language code filter applied."
}
},
"description": "The resolved filter set the query actually ran with, after normalization and defaults. Echoes back so the agent can confirm how its inputs were interpreted.",
"additionalProperties": false
}
},
"additionalProperties": false
}reliefweb_search_training annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}reliefweb_get_training — Get ReliefWeb Training
Advertised read-onlyOpen-world
Fetch a training listing by ReliefWeb numeric ID with the full description, registration instructions, event link, cost and fee information, dates, languages, and organizing source. Use after reliefweb_search_training, which returns summaries without the description, registration instructions, or cost detail. Reaches concluded listings as well as current ones. A record over the response budget comes back as a section outline naming every section and its byte size; re-call with sections to pull only the ones needed. Nothing is truncated on either path.
reliefweb_get_training input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "ReliefWeb numeric training ID. Obtained from reliefweb_search_training results.",
"exclusiveMinimum": 0
},
"sections": {
"type": "array",
"items": {
"type": "string",
"description": "A section name exactly as the outline response spelled it."
},
"description": "Sections of the training 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."
}
},
"additionalProperties": false
}reliefweb_get_training output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"kind"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "number",
"description": "ReliefWeb numeric training ID."
},
"url": {
"type": "string",
"description": "ReliefWeb node URL for this training listing."
},
"body": {
"type": "string",
"description": "Full training description (Markdown) — content, audience, and logistics."
},
"cost": {
"type": "string",
"description": "Cost class as ReliefWeb records it, such as free or fee-based."
},
"kind": {
"enum": [
"full",
"outline"
],
"type": "string",
"description": "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."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"not_found"
],
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: No training listing found with the given ID. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"title": {
"type": "string",
"description": "Training title."
},
"types": {
"type": "array",
"items": {
"type": "string"
},
"description": "Training type names, such as Training/Workshop or Course."
},
"cities": {
"type": "array",
"items": {
"type": "string"
},
"description": "Host cities, for on-site training."
},
"status": {
"type": "string",
"description": "Listing status: published while the training is current, expired once concluded."
},
"themes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Humanitarian theme/sector names."
},
"dateEnd": {
"type": "string",
"description": "Training end date (ISO 8601)."
},
"formats": {
"type": "array",
"items": {
"type": "string"
},
"description": "Training format names: on-site or online."
},
"sources": {
"type": "array",
"items": {
"type": "string"
},
"description": "Organizing organizations (short names)."
},
"eventUrl": {
"type": "string",
"description": "The organizer's own page for this training, when published."
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"bytes"
],
"properties": {
"name": {
"type": "string",
"description": "Section identifier — pass in `sections` to retrieve it"
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Serialized byte size of the section"
}
},
"description": "One retrievable section of the record: its name and its serialized size.",
"additionalProperties": false
},
"description": "Every section of the record, largest first. Pass the names back in `sections` to retrieve them."
},
"urlAlias": {
"type": "string",
"description": "Canonical ReliefWeb URL for this training listing."
},
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Countries tagged on this training."
},
"dateStart": {
"type": "string",
"description": "Training start date (ISO 8601)."
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Language codes of the listing (ISO 639-1)."
},
"dateCreated": {
"type": "string",
"description": "Date this listing was indexed (ISO 8601)."
},
"howToRegister": {
"type": "string",
"description": "Registration instructions (Markdown) as published by the organizer."
},
"outlineNotice": {
"type": "string",
"description": "How to re-call this tool for specific sections of the record."
},
"feeInformation": {
"type": "string",
"description": "Fee detail as published by the organizer — amounts, inclusions, and conditions."
},
"careerCategories": {
"type": "array",
"items": {
"type": "string"
},
"description": "Career category names (humanitarian tracks)."
},
"dateRegistration": {
"type": "string",
"description": "Registration deadline (ISO 8601)."
},
"trainingLanguages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Language codes the training is delivered in (ISO 639-1)."
}
},
"additionalProperties": false
}reliefweb_get_training annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}reliefweb_list_sources — List ReliefWeb Sources
Advertised read-onlyOpen-world
Browse source organizations that contribute content to ReliefWeb, optionally filtered by name text or organization type. Returns short names, types, and URLs. Use the shortname value with the source filter in reliefweb_search_reports, reliefweb_search_jobs, and reliefweb_search_training.
reliefweb_list_sources input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"text": {
"type": "string",
"description": "Full-text search query. Matches against organization name and short name."
},
"type": {
"enum": [
"Non-governmental Organization",
"International Organization",
"Academic and Research Institution",
"Other",
"Government",
"Media",
"Red Cross/Red Crescent Movement"
],
"type": "string",
"description": "Organization type. One of: Non-governmental Organization, International Organization, Academic and Research Institution, Other, Government, Media, Red Cross/Red Crescent Movement. Filters on type.name."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of results to return (1–1000, default 10). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Each call counts against the 1,000-calls/day quota."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results."
}
},
"additionalProperties": false
}reliefweb_list_sources output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"invalid_query",
"upstream_error"
],
"description": "Machine-readable failure mode. Declared by this tool: `invalid_query`: ReliefWeb rejected the request as malformed rather than failing to serve it. `upstream_error`: The ReliefWeb API was unreachable, timed out, or returned a server error. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "number",
"description": "ReliefWeb numeric source ID."
},
"url": {
"type": "string",
"description": "Organization ReliefWeb profile URL."
},
"name": {
"type": "string",
"description": "Full organization name."
},
"types": {
"type": "array",
"items": {
"type": "string"
},
"description": "Organization type names."
},
"homepage": {
"type": "string",
"description": "Organization website URL."
},
"shortname": {
"type": "string",
"description": "Organization short name — use this value in the source filter for other search tools."
}
},
"description": "A source organization contributing content to ReliefWeb.",
"additionalProperties": false
},
"description": "Source organizations contributing content to ReliefWeb."
},
"notice": {
"type": "string",
"description": "Discloses requested and applied limits when clamped. For empty pages, names the match count and last reachable offset when records matched; otherwise echoes filters and suggests how to broaden."
},
"totalCount": {
"type": "number",
"description": "Total sources matching the query before pagination."
}
},
"additionalProperties": false
}reliefweb_list_sources annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}Prompts
1 advertised
reliefweb_crisis_briefing
Generate a structured humanitarian briefing for a country or disaster. Instructs the agent to use available ReliefWeb tools to gather recent reports, active disasters, open positions, and training opportunities, then synthesize a concise situation overview. Specify focus=situation for a situation-only brief, focus=jobs for open positions, or focus=full for the complete briefing.
- country_or_disaster
- Country name or ISO3 code (e.g., "Afghanistan" or "AFG"), or a disaster name/GLIDE number (e.g., "Syria earthquake" or "EQ-2023-000053-TUR"). (required)
- focus
- Briefing scope. situation = situation overview and recent reports only. jobs = open positions and training only. full = complete briefing including situation, reports, disasters, jobs, and training (default).
Resources
1 advertised
reliefweb-guide
Use reliefweb_* tools for country or disaster research and humanitarian job or training shortlists. Resolve names, distinguish historical coverage, and check completeness before concluding that evidence or opportunities are absent.
reliefweb-guide URI
skill://reliefweb-guide/SKILL.mdreliefweb-report — ReliefWeb Report
Full report record by ReliefWeb numeric ID — metadata, body text, and file URLs. Always returns the whole record, however large: a resource read has no way to name sections, so reliefweb_get_report is the path for an oversized report — it answers with a section outline and takes a sections selector.
reliefweb-report URI template
reliefweb://reports/{id}reliefweb-disaster — ReliefWeb Disaster
Disaster record by ReliefWeb numeric ID — type, status, affected countries, GLIDE number, description, and curated content links. Always returns the whole record, however large: a resource read has no way to name sections, so reliefweb_get_disaster is the path for an oversized disaster — it answers with a section outline and takes a sections selector.
reliefweb-disaster URI template
reliefweb://disasters/{id}reliefweb-country — ReliefWeb Country Profile
Country profile by ISO3 code — overview, humanitarian situation summary, key content links, and active response plans. Equivalent to calling reliefweb_get_country.
reliefweb-country URI template
reliefweb://countries/{iso3}io.modelcontextprotocol/skills
io.modelcontextprotocol/skills URI template
skill://{+path}90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 619 ms
- 95th percentile latency
- 619 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 619 ms · metadata changed · 11 tool(s), 1 resource(s), 4 resource template(s), 1 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http reliefweb-mcp-server https://reliefweb.caseyjhand.com/mcpCodex
Codex configuration
codex mcp add reliefweb-mcp-server --url https://reliefweb.caseyjhand.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"reliefweb-mcp-server": {
"url": "https://reliefweb.caseyjhand.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"reliefweb-mcp-server": {
"type": "streamableHttp",
"url": "https://reliefweb.caseyjhand.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"reliefweb-mcp-server": {
"type": "http",
"url": "https://reliefweb.caseyjhand.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http reliefweb-mcp-server https://reliefweb.caseyjhand.com/mcpClaude Desktop
Claude Desktop configuration
https://reliefweb.caseyjhand.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"reliefweb-mcp-server": {
"serverUrl": "https://reliefweb.caseyjhand.com/mcp"
}
}
}Let your agent find its tools
Find servers like reliefweb-mcp-server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.