Server definition
- Hash
- sha256:7cce9a6c3306b4c1368cd0edcb369d77f6d186c32aff442a846d7cfe130459b6
- What it is
- What a remote MCP server returned when asked what it offers: 11 tools
The blob, as servednamed by its sha256
{
"instructions": "Use the reliefweb_* tools to query ReliefWeb (OCHA humanitarian data) for reports, disasters, countries, jobs, and training. A pre-approved RELIEFWEB_APP_NAME is required. Countries use ISO3 codes (e.g. SYR), everything else uses numeric IDs, and organizations use a shortname (e.g. WFP). Workflow: the reliefweb_search_* tools return summaries with the document text excluded, then the matching reliefweb_get_* tool fetches one record in full — reports, disasters, jobs, and training each have one; a disaster ID also feeds the disaster_id report filter. Every reliefweb_get_* tool returns a section outline instead of the record when it exceeds the response budget: re-call the same tool with sections to pull named sections. Country and disaster profiles carry only each curated link list's active entries; re-call with archive to page a list's archived ones — sections and archive are alternative modes and cannot be combined. Quota: 1,000 calls/day.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"archive": {
"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.",
"properties": {
"limit": {
"default": 25,
"description": "Maximum archived entries in one page (1-100).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"list": {
"description": "Which curated list to page. The archived entries of that list are the ones the profile itself leaves out.",
"enum": [
"keyContent",
"appealsResponsePlans",
"usefulLinks"
],
"type": "string"
},
"offset": {
"default": 0,
"description": "Zero-based index of the first archived entry to return. Send back the nextOffset from the previous page to continue.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"list"
],
"type": "object"
},
"iso3": {
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Used to look up the country's ReliefWeb profile.",
"maxLength": 3,
"minLength": 3,
"type": "string"
},
"sections": {
"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. 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.",
"items": {
"description": "A section name exactly as the outline response spelled it.",
"type": "string"
},
"type": "array"
}
},
"required": [
"iso3"
],
"type": "object"
},
"name": "reliefweb_get_country",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"kind"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appealsResponsePlans": {
"description": "Currently-active humanitarian appeals and response plans for this country — the present set. The archived entries are reachable with archive: { list: \"appealsResponsePlans\" }.",
"items": {
"additionalProperties": false,
"description": "An appeal or response plan entry.",
"properties": {
"date": {
"description": "Publication date.",
"type": "string"
},
"title": {
"description": "Appeal or response plan title.",
"type": "string"
},
"url": {
"description": "Link URL.",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"archive": {
"additionalProperties": false,
"description": "One page of a curated list's archived entries, returned in place of the record.",
"properties": {
"entries": {
"description": "The archived entries in this page, in ReliefWeb's own archive order.",
"items": {
"additionalProperties": false,
"description": "One archived entry.",
"properties": {
"date": {
"description": "Publication date, carried by appeals and response plans.",
"type": "string"
},
"title": {
"description": "Entry title.",
"type": "string"
},
"url": {
"description": "Entry URL.",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"list": {
"description": "The curated list this page was read from.",
"enum": [
"keyContent",
"appealsResponsePlans",
"usefulLinks"
],
"type": "string"
},
"nextOffset": {
"description": "Offset to send back to read the next page. Absent when this page reaches the end of the archive.",
"type": "number"
},
"offset": {
"description": "Zero-based index of the first entry in this page.",
"type": "number"
},
"shown": {
"description": "Number of entries in this page.",
"type": "number"
},
"total": {
"description": "Total archived entries in that list for this record.",
"type": "number"
}
},
"required": [
"list",
"total",
"shown",
"offset",
"entries"
],
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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.",
"examples": [
"not_found",
"selector_conflict"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"id": {
"description": "ReliefWeb numeric country ID.",
"type": "number"
},
"iso3": {
"description": "ISO 3166-1 alpha-3 code.",
"type": "string"
},
"keyContent": {
"description": "Currently-active curated key content links maintained by ReliefWeb editors — the present curated set. The archived entries are reachable with archive: { list: \"keyContent\" }.",
"items": {
"additionalProperties": false,
"description": "A curated key content link.",
"properties": {
"title": {
"description": "Link title.",
"type": "string"
},
"url": {
"description": "Link URL.",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"kind": {
"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.",
"enum": [
"full",
"outline",
"archive"
],
"type": "string"
},
"name": {
"description": "Country name.",
"type": "string"
},
"outlineNotice": {
"description": "How to re-call this tool for specific sections of the record.",
"type": "string"
},
"profileOverview": {
"description": "Situation overview text from the ReliefWeb editorial team.",
"type": "string"
},
"sections": {
"description": "Every section of the record, largest first. Pass the names back in `sections` to retrieve them.",
"items": {
"additionalProperties": false,
"description": "One retrievable section of the record: its name and its serialized size.",
"properties": {
"bytes": {
"description": "Serialized byte size of the section",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Section identifier — pass in `sections` to retrieve it",
"type": "string"
}
},
"required": [
"name",
"bytes"
],
"type": "object"
},
"type": "array"
},
"status": {
"description": "Humanitarian situation status.",
"type": "string"
},
"urlAlias": {
"description": "Canonical ReliefWeb URL for this country page.",
"type": "string"
},
"usefulLinks": {
"description": "Currently-active useful external links curated by ReliefWeb editors — the present set. The archived entries are reachable with archive: { list: \"usefulLinks\" }.",
"items": {
"additionalProperties": false,
"description": "A useful external link.",
"properties": {
"title": {
"description": "Link title.",
"type": "string"
},
"url": {
"description": "Link URL.",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"archive": {
"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.",
"properties": {
"limit": {
"default": 25,
"description": "Maximum archived entries in one page (1-100).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"list": {
"description": "Which curated list to page. The archived entries of that list are the ones the profile itself leaves out.",
"enum": [
"keyContent",
"appealsResponsePlans",
"usefulLinks"
],
"type": "string"
},
"offset": {
"default": 0,
"description": "Zero-based index of the first archived entry to return. Send back the nextOffset from the previous page to continue.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"list"
],
"type": "object"
},
"id": {
"description": "ReliefWeb numeric disaster ID. Obtained from reliefweb_search_disasters results.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"sections": {
"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. 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.",
"items": {
"description": "A section name exactly as the outline response spelled it.",
"type": "string"
},
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "reliefweb_get_disaster",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"kind"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appealsResponsePlans": {
"description": "Currently-active appeals and response plans linked to this disaster — the present set. The archived entries are reachable with archive: { list: \"appealsResponsePlans\" }.",
"items": {
"additionalProperties": false,
"description": "An appeal or response plan entry.",
"properties": {
"date": {
"description": "Publication date.",
"type": "string"
},
"title": {
"description": "Appeal or response plan title.",
"type": "string"
},
"url": {
"description": "Link URL.",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"archive": {
"additionalProperties": false,
"description": "One page of a curated list's archived entries, returned in place of the record.",
"properties": {
"entries": {
"description": "The archived entries in this page, in ReliefWeb's own archive order.",
"items": {
"additionalProperties": false,
"description": "One archived entry.",
"properties": {
"date": {
"description": "Publication date, carried by appeals and response plans.",
"type": "string"
},
"title": {
"description": "Entry title.",
"type": "string"
},
"url": {
"description": "Entry URL.",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"list": {
"description": "The curated list this page was read from.",
"enum": [
"keyContent",
"appealsResponsePlans",
"usefulLinks"
],
"type": "string"
},
"nextOffset": {
"description": "Offset to send back to read the next page. Absent when this page reaches the end of the archive.",
"type": "number"
},
"offset": {
"description": "Zero-based index of the first entry in this page.",
"type": "number"
},
"shown": {
"description": "Number of entries in this page.",
"type": "number"
},
"total": {
"description": "Total archived entries in that list for this record.",
"type": "number"
}
},
"required": [
"list",
"total",
"shown",
"offset",
"entries"
],
"type": "object"
},
"countries": {
"description": "All countries tagged on this disaster.",
"items": {
"type": "string"
},
"type": "array"
},
"dateCreated": {
"description": "ReliefWeb index date (ISO 8601).",
"type": "string"
},
"dateEvent": {
"description": "Event date (ISO 8601), when available.",
"type": "string"
},
"description": {
"description": "Full disaster description text.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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.",
"examples": [
"not_found",
"selector_conflict"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"glide": {
"description": "GLIDE number for cross-system correlation.",
"type": "string"
},
"id": {
"description": "ReliefWeb numeric disaster ID.",
"type": "number"
},
"keyContent": {
"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\" }.",
"items": {
"additionalProperties": false,
"description": "A curated key content link.",
"properties": {
"title": {
"description": "Link title.",
"type": "string"
},
"url": {
"description": "Link URL.",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"kind": {
"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.",
"enum": [
"full",
"outline",
"archive"
],
"type": "string"
},
"name": {
"description": "Disaster name.",
"type": "string"
},
"outlineNotice": {
"description": "How to re-call this tool for specific sections of the record.",
"type": "string"
},
"primaryCountry": {
"description": "Primary affected country.",
"type": "string"
},
"primaryType": {
"description": "Primary disaster type.",
"type": "string"
},
"profileOverview": {
"description": "Profile overview text from the ReliefWeb editorial team.",
"type": "string"
},
"sections": {
"description": "Every section of the record, largest first. Pass the names back in `sections` to retrieve them.",
"items": {
"additionalProperties": false,
"description": "One retrievable section of the record: its name and its serialized size.",
"properties": {
"bytes": {
"description": "Serialized byte size of the section",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Section identifier — pass in `sections` to retrieve it",
"type": "string"
}
},
"required": [
"name",
"bytes"
],
"type": "object"
},
"type": "array"
},
"status": {
"description": "Disaster status: alert, ongoing, past, or alert-archive.",
"type": "string"
},
"types": {
"description": "Disaster type names.",
"items": {
"type": "string"
},
"type": "array"
},
"urlAlias": {
"description": "Canonical ReliefWeb URL for this disaster.",
"type": "string"
},
"usefulLinks": {
"description": "Currently-active useful external links curated by ReliefWeb editors — the present set. The archived entries are reachable with archive: { list: \"usefulLinks\" }.",
"items": {
"additionalProperties": false,
"description": "A useful external link.",
"properties": {
"title": {
"description": "Link title.",
"type": "string"
},
"url": {
"description": "Link URL.",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"description": "ReliefWeb numeric job ID. Obtained from reliefweb_search_jobs results.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"sections": {
"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. 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.",
"items": {
"description": "A section name exactly as the outline response spelled it.",
"type": "string"
},
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "reliefweb_get_job",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"kind"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"body": {
"description": "Full vacancy description (HTML) — duties, requirements, and conditions.",
"type": "string"
},
"careerCategories": {
"description": "Career category names (humanitarian tracks).",
"items": {
"type": "string"
},
"type": "array"
},
"countries": {
"description": "Countries tagged on this job.",
"items": {
"type": "string"
},
"type": "array"
},
"dateChanged": {
"description": "Date this posting was last modified (ISO 8601).",
"type": "string"
},
"dateClosing": {
"description": "Application closing date (ISO 8601).",
"type": "string"
},
"dateCreated": {
"description": "Date this posting was indexed (ISO 8601).",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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.",
"examples": [
"not_found"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"experienceLevels": {
"description": "Required experience levels.",
"items": {
"type": "string"
},
"type": "array"
},
"howToApply": {
"description": "Application instructions (HTML) as published by the hiring organization.",
"type": "string"
},
"id": {
"description": "ReliefWeb numeric job ID.",
"type": "number"
},
"kind": {
"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.",
"enum": [
"full",
"outline"
],
"type": "string"
},
"outlineNotice": {
"description": "How to re-call this tool for specific sections of the record.",
"type": "string"
},
"sections": {
"description": "Every section of the record, largest first. Pass the names back in `sections` to retrieve them.",
"items": {
"additionalProperties": false,
"description": "One retrievable section of the record: its name and its serialized size.",
"properties": {
"bytes": {
"description": "Serialized byte size of the section",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Section identifier — pass in `sections` to retrieve it",
"type": "string"
}
},
"required": [
"name",
"bytes"
],
"type": "object"
},
"type": "array"
},
"sources": {
"description": "Hiring organizations (short names).",
"items": {
"type": "string"
},
"type": "array"
},
"status": {
"description": "Posting status: published while the vacancy is open, expired once it has closed.",
"type": "string"
},
"themes": {
"description": "Humanitarian theme/sector names.",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Job title.",
"type": "string"
},
"types": {
"description": "Job type names, such as Job or Consultancy.",
"items": {
"type": "string"
},
"type": "array"
},
"url": {
"description": "ReliefWeb node URL for this job listing.",
"type": "string"
},
"urlAlias": {
"description": "Canonical ReliefWeb URL for this job listing.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"description": "ReliefWeb numeric report ID. Obtained from reliefweb_search_reports results.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"sections": {
"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. 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.",
"items": {
"description": "A section name exactly as the outline response spelled it.",
"type": "string"
},
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "reliefweb_get_report",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"kind"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"body": {
"description": "Full report body text (HTML). Present for most reports; absent for binary-only documents.",
"type": "string"
},
"countries": {
"description": "All countries tagged on this report.",
"items": {
"type": "string"
},
"type": "array"
},
"dateCreated": {
"description": "ReliefWeb index date (ISO 8601).",
"type": "string"
},
"dateOriginal": {
"description": "Source publication date (ISO 8601).",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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.",
"examples": [
"not_found"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"fileUrls": {
"description": "Direct file download URLs attached to this report.",
"items": {
"type": "string"
},
"type": "array"
},
"formats": {
"description": "Content format names.",
"items": {
"type": "string"
},
"type": "array"
},
"headlineSummary": {
"description": "Short editorial summary from the headline block, when present.",
"type": "string"
},
"id": {
"description": "ReliefWeb numeric report ID.",
"type": "number"
},
"kind": {
"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.",
"enum": [
"full",
"outline"
],
"type": "string"
},
"languages": {
"description": "Language codes (ISO 639-1).",
"items": {
"type": "string"
},
"type": "array"
},
"outlineNotice": {
"description": "How to re-call this tool for specific sections of the record.",
"type": "string"
},
"primaryCountry": {
"description": "Primary country name for this report.",
"type": "string"
},
"sections": {
"description": "Every section of the record, largest first. Pass the names back in `sections` to retrieve them.",
"items": {
"additionalProperties": false,
"description": "One retrievable section of the record: its name and its serialized size.",
"properties": {
"bytes": {
"description": "Serialized byte size of the section",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Section identifier — pass in `sections` to retrieve it",
"type": "string"
}
},
"required": [
"name",
"bytes"
],
"type": "object"
},
"type": "array"
},
"sources": {
"description": "Publishing organizations (short names).",
"items": {
"type": "string"
},
"type": "array"
},
"themes": {
"description": "Humanitarian theme/sector names.",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Report title.",
"type": "string"
},
"urlAlias": {
"description": "Canonical ReliefWeb URL for this report.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"description": "ReliefWeb numeric training ID. Obtained from reliefweb_search_training results.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"sections": {
"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. 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.",
"items": {
"description": "A section name exactly as the outline response spelled it.",
"type": "string"
},
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "reliefweb_get_training",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"kind"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"body": {
"description": "Full training description (HTML) — content, audience, and logistics.",
"type": "string"
},
"careerCategories": {
"description": "Career category names (humanitarian tracks).",
"items": {
"type": "string"
},
"type": "array"
},
"cities": {
"description": "Host cities, for on-site training.",
"items": {
"type": "string"
},
"type": "array"
},
"cost": {
"description": "Cost class as ReliefWeb records it, such as free or fee-based.",
"type": "string"
},
"countries": {
"description": "Countries tagged on this training.",
"items": {
"type": "string"
},
"type": "array"
},
"dateCreated": {
"description": "Date this listing was indexed (ISO 8601).",
"type": "string"
},
"dateEnd": {
"description": "Training end date (ISO 8601).",
"type": "string"
},
"dateRegistration": {
"description": "Registration deadline (ISO 8601).",
"type": "string"
},
"dateStart": {
"description": "Training start date (ISO 8601).",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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.",
"examples": [
"not_found"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"eventUrl": {
"description": "The organizer's own page for this training, when published.",
"type": "string"
},
"feeInformation": {
"description": "Fee detail as published by the organizer — amounts, inclusions, and conditions.",
"type": "string"
},
"formats": {
"description": "Training format names: on-site or online.",
"items": {
"type": "string"
},
"type": "array"
},
"howToRegister": {
"description": "Registration instructions (HTML) as published by the organizer.",
"type": "string"
},
"id": {
"description": "ReliefWeb numeric training ID.",
"type": "number"
},
"kind": {
"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.",
"enum": [
"full",
"outline"
],
"type": "string"
},
"languages": {
"description": "Language codes of the listing (ISO 639-1).",
"items": {
"type": "string"
},
"type": "array"
},
"outlineNotice": {
"description": "How to re-call this tool for specific sections of the record.",
"type": "string"
},
"sections": {
"description": "Every section of the record, largest first. Pass the names back in `sections` to retrieve them.",
"items": {
"additionalProperties": false,
"description": "One retrievable section of the record: its name and its serialized size.",
"properties": {
"bytes": {
"description": "Serialized byte size of the section",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Section identifier — pass in `sections` to retrieve it",
"type": "string"
}
},
"required": [
"name",
"bytes"
],
"type": "object"
},
"type": "array"
},
"sources": {
"description": "Organizing organizations (short names).",
"items": {
"type": "string"
},
"type": "array"
},
"status": {
"description": "Listing status: published while the training is current, expired once concluded.",
"type": "string"
},
"themes": {
"description": "Humanitarian theme/sector names.",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Training title.",
"type": "string"
},
"trainingLanguages": {
"description": "Language codes the training is delivered in (ISO 639-1).",
"items": {
"type": "string"
},
"type": "array"
},
"types": {
"description": "Training type names, such as Training/Workshop or Course.",
"items": {
"type": "string"
},
"type": "array"
},
"url": {
"description": "ReliefWeb node URL for this training listing.",
"type": "string"
},
"urlAlias": {
"description": "Canonical ReliefWeb URL for this training listing.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"crisis_only": {
"description": "When true, filters to countries with an active humanitarian situation (status ongoing). Default false returns all countries.",
"type": "boolean"
},
"limit": {
"default": 100,
"description": "Number of results to return (1–1000, default 100). Each call counts against the 1,000-calls/day quota.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "reliefweb_list_countries",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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.",
"examples": [
"invalid_query",
"upstream_error"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"items": {
"description": "Countries tracked by ReliefWeb.",
"items": {
"additionalProperties": false,
"description": "A country or territory tracked by ReliefWeb.",
"properties": {
"id": {
"description": "ReliefWeb numeric country ID.",
"type": "number"
},
"iso3": {
"description": "ISO 3166-1 alpha-3 code for use with reliefweb_get_country.",
"type": "string"
},
"name": {
"description": "Country or territory name.",
"type": "string"
},
"status": {
"description": "Humanitarian situation status: ongoing (active crisis) or normal (non-crisis).",
"type": "string"
},
"urlAlias": {
"description": "Canonical ReliefWeb URL for this country page.",
"type": "string"
}
},
"required": [
"id",
"name"
],
"type": "object"
},
"type": "array"
},
"notice": {
"description": "Present only when the page is empty. Names the match count and the last reachable offset when the query matched records; otherwise echoes the filters applied and suggests how to broaden.",
"type": "string"
},
"totalCount": {
"description": "Total countries matching the filter before pagination.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 10,
"description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"text": {
"description": "Full-text search query. Matches against organization name and short name.",
"type": "string"
},
"type": {
"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.",
"enum": [
"Non-governmental Organization",
"International Organization",
"Academic and Research Institution",
"Other",
"Government",
"Media",
"Red Cross/Red Crescent Movement"
],
"type": "string"
}
},
"type": "object"
},
"name": "reliefweb_list_sources",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"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.",
"examples": [
"invalid_query",
"upstream_error"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"items": {
"description": "Source organizations contributing content to ReliefWeb.",
"items": {
"additionalProperties": false,
"description": "A source organization contributing content to ReliefWeb.",
"properties": {
"homepage": {
"description": "Organization website URL.",
"type": "string"
},
"id": {
"description": "ReliefWeb numeric source ID.",
"type": "number"
},
"name": {
"description": "Full organization name.",
"type": "string"
},
"shortname": {
"description": "Organization short name — use this value in the source filter for other search tools.",
"type": "string"
},
"types": {
"description": "Organization type names.",
"items": {
"type": "string"
},
"type": "array"
},
"url": {
"description": "Organization ReliefWeb profile URL.",
"type": "string"
}
},
"required": [
"id",
"name"
],
"type": "object"
},
"type": "array"
},
"notice": {
"description": "Present only when the page is empty. Names the match count and the last reachable offset when the query matched records; otherwise echoes the filters applied and suggests how to broaden.",
"type": "string"
},
"totalCount": {
"description": "Total sources matching the query before pagination.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"country": {
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to disasters tagged with this country.",
"type": "string"
},
"date_from": {
"anyOf": [
{
"const": "",
"type": "string"
},
{
"description": "Calendar date (2024-01-15) or full ISO 8601 datetime (2024-01-15T00:00:00+00:00).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"type": "string"
}
],
"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."
},
"date_to": {
"anyOf": [
{
"const": "",
"type": "string"
},
{
"description": "Calendar date (2024-01-31) or full ISO 8601 datetime (2024-01-31T23:59:59+00:00).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"type": "string"
}
],
"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."
},
"disaster_type": {
"description": "Disaster type name (e.g., Earthquake, Flood, Drought, Cyclone). Filters on type.name.",
"type": "string"
},
"glide": {
"description": "GLIDE number (global disaster identifier, e.g., EQ-2023-000053-TUR). Use for cross-system disaster correlation.",
"type": "string"
},
"include_archived": {
"description": "Include alert-archive disasters in results, alongside alert, ongoing, and past. Uses preset=analysis. Off by default.",
"type": "boolean"
},
"limit": {
"default": 10,
"description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"sort": {
"description": "Sort order. Use date.created:desc for newest first (default), date.created:asc for oldest, score:desc for relevance.",
"type": "string"
},
"status": {
"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.",
"type": "string"
},
"text": {
"description": "Full-text search query. Matches against disaster name and description.",
"type": "string"
}
},
"type": "object"
},
"name": "reliefweb_search_disasters",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"appliedFilters",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"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.",
"properties": {
"country": {
"description": "Country code as normalized (uppercased ISO3).",
"type": "string"
},
"dateFrom": {
"description": "Earliest creation date filter applied.",
"type": "string"
},
"dateTo": {
"description": "Latest creation date filter applied.",
"type": "string"
},
"disasterType": {
"description": "Disaster type name filter applied.",
"type": "string"
},
"glide": {
"description": "GLIDE number filter applied.",
"type": "string"
},
"limit": {
"description": "Result limit the query used.",
"type": "number"
},
"offset": {
"description": "Pagination offset the query used.",
"type": "number"
},
"preset": {
"description": "ReliefWeb preset the query used: latest (default) or analysis when include_archived.",
"type": "string"
},
"sort": {
"description": "Sort order the query used (resolved, including the default).",
"type": "string"
},
"status": {
"description": "Status filter applied, in canonical spelling (comma-joined when multiple).",
"type": "string"
},
"text": {
"description": "Full-text query the search used.",
"type": "string"
}
},
"required": [
"sort",
"preset",
"limit",
"offset"
],
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `unknown_status`: A status token does not name a ReliefWeb disaster status. `invalid_query`: ReliefWeb rejected the query — 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.",
"examples": [
"unknown_status",
"invalid_query",
"upstream_error"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"items": {
"description": "Matching disasters.",
"items": {
"additionalProperties": false,
"description": "A matching disaster record.",
"properties": {
"countries": {
"description": "All countries tagged on this disaster.",
"items": {
"type": "string"
},
"type": "array"
},
"dateCreated": {
"description": "ReliefWeb index date (ISO 8601).",
"type": "string"
},
"dateEvent": {
"description": "Event date (ISO 8601), when available.",
"type": "string"
},
"glide": {
"description": "GLIDE number for cross-system correlation.",
"type": "string"
},
"id": {
"description": "ReliefWeb numeric disaster ID.",
"type": "number"
},
"name": {
"description": "Disaster name.",
"type": "string"
},
"primaryCountry": {
"description": "Primary affected country.",
"type": "string"
},
"primaryType": {
"description": "Primary disaster type.",
"type": "string"
},
"status": {
"description": "Disaster status: alert, ongoing, past, or alert-archive.",
"type": "string"
},
"types": {
"description": "Disaster type names.",
"items": {
"type": "string"
},
"type": "array"
},
"urlAlias": {
"description": "Canonical ReliefWeb URL for this disaster.",
"type": "string"
}
},
"required": [
"id",
"name"
],
"type": "object"
},
"type": "array"
},
"notice": {
"description": "Present only when the page is empty. Names the match count and the last reachable offset when the query matched records; otherwise echoes the filters applied and suggests how to broaden.",
"type": "string"
},
"totalCount": {
"description": "Total disasters matching the query before pagination.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"career_category": {
"description": "Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology, Logistics and Telecommunications). Filters on career_categories.name.",
"type": "string"
},
"country": {
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to jobs tagged with this country.",
"type": "string"
},
"experience": {
"description": "Experience level (e.g., 0-2 years, 3-4 years, 5-9 years). Filters on experience.name.",
"type": "string"
},
"include_archived": {
"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.",
"type": "boolean"
},
"limit": {
"default": 10,
"description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"sort": {
"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.",
"type": "string"
},
"source": {
"description": "Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname.",
"type": "string"
},
"text": {
"description": "Full-text search query. Matches against job title, body, and key metadata fields.",
"type": "string"
},
"theme": {
"description": "Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Protection). Filters on theme.name.",
"type": "string"
}
},
"type": "object"
},
"name": "reliefweb_search_jobs",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"appliedFilters",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"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.",
"properties": {
"careerCategory": {
"description": "Career category name filter applied.",
"type": "string"
},
"country": {
"description": "Country code as normalized (uppercased ISO3).",
"type": "string"
},
"experience": {
"description": "Experience level filter applied.",
"type": "string"
},
"limit": {
"description": "Result limit the query used.",
"type": "number"
},
"offset": {
"description": "Pagination offset the query used.",
"type": "number"
},
"preset": {
"description": "ReliefWeb preset the query used: latest (open postings only, default) or analysis when include_archived.",
"type": "string"
},
"sort": {
"description": "Sort order the query used (resolved, including the default).",
"type": "string"
},
"source": {
"description": "Source short name filter applied.",
"type": "string"
},
"text": {
"description": "Full-text query the search used.",
"type": "string"
},
"theme": {
"description": "Theme name filter applied.",
"type": "string"
}
},
"required": [
"sort",
"preset",
"limit",
"offset"
],
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_query`: ReliefWeb rejected the query — typically 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.",
"examples": [
"invalid_query",
"upstream_error"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"items": {
"description": "Matching job listings.",
"items": {
"additionalProperties": false,
"description": "A matching job listing.",
"properties": {
"careerCategories": {
"description": "Career category names (humanitarian tracks).",
"items": {
"type": "string"
},
"type": "array"
},
"countries": {
"description": "Countries tagged on this job.",
"items": {
"type": "string"
},
"type": "array"
},
"dateClosing": {
"description": "Application closing date (ISO 8601).",
"type": "string"
},
"dateCreated": {
"description": "Date this job was indexed (ISO 8601).",
"type": "string"
},
"experienceLevels": {
"description": "Required experience levels.",
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"description": "ReliefWeb numeric job ID.",
"type": "number"
},
"sources": {
"description": "Hiring organizations (short names).",
"items": {
"type": "string"
},
"type": "array"
},
"themes": {
"description": "Humanitarian theme/sector names.",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Job title.",
"type": "string"
},
"types": {
"description": "Job type names.",
"items": {
"type": "string"
},
"type": "array"
},
"urlAlias": {
"description": "Canonical ReliefWeb URL for this job listing.",
"type": "string"
}
},
"required": [
"id",
"title"
],
"type": "object"
},
"type": "array"
},
"notice": {
"description": "Present only when the page is empty. Names the match count and the last reachable offset when the query matched records; otherwise echoes the filters applied and suggests how to broaden.",
"type": "string"
},
"totalCount": {
"description": "Total jobs matching the query before pagination.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"country": {
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to content tagged with this country.",
"type": "string"
},
"date_from": {
"anyOf": [
{
"const": "",
"type": "string"
},
{
"description": "Calendar date (2024-01-15) or full ISO 8601 datetime (2024-01-15T00:00:00+00:00).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"type": "string"
}
],
"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."
},
"date_to": {
"anyOf": [
{
"const": "",
"type": "string"
},
{
"description": "Calendar date (2024-01-31) or full ISO 8601 datetime (2024-01-31T23:59:59+00:00).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"type": "string"
}
],
"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."
},
"disaster_id": {
"description": "ReliefWeb numeric disaster ID. Filters to reports linked to a specific disaster. Get the ID from reliefweb_search_disasters.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"filter": {
"additionalProperties": {},
"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"
},
"type": "object"
},
"format": {
"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.",
"type": "string"
},
"include_archived": {
"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.",
"type": "boolean"
},
"language": {
"description": "ISO 639-1 language code (e.g., en, fr, es, ar). Filters on language.code.",
"type": "string"
},
"limit": {
"default": 10,
"description": "Number of results to return (1–1000, default 10). Use a smaller value for targeted lookups; larger for bulk research. Each call counts against the 1,000-calls/day quota.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through large result sets.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"sort": {
"description": "Sort order. Use date.original:desc for newest first (default), date.original:asc for oldest first, score:desc for relevance.",
"type": "string"
},
"source": {
"description": "Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname.",
"type": "string"
},
"text": {
"description": "Full-text search query. Matches against title, body, and key metadata fields. Use plain natural language or keywords.",
"type": "string"
},
"theme": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "reliefweb_search_reports",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"appliedFilters",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"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.",
"properties": {
"country": {
"description": "Country code as normalized (uppercased ISO3).",
"type": "string"
},
"dateFrom": {
"description": "Earliest publication date filter applied.",
"type": "string"
},
"dateTo": {
"description": "Latest publication date filter applied.",
"type": "string"
},
"disasterId": {
"description": "Disaster ID filter applied.",
"type": "number"
},
"format": {
"description": "Format name filter applied, in its canonical ReliefWeb spelling.",
"type": "string"
},
"language": {
"description": "Language code filter applied.",
"type": "string"
},
"limit": {
"description": "Result limit the query used.",
"type": "number"
},
"offset": {
"description": "Pagination offset the query used.",
"type": "number"
},
"preset": {
"description": "ReliefWeb preset the query used. Always latest for reports — no preset changes which reports match.",
"type": "string"
},
"rawFilter": {
"description": "True when a raw compound filter object was merged into the query.",
"type": "boolean"
},
"sort": {
"description": "Sort order the query used (resolved, including the default).",
"type": "string"
},
"source": {
"description": "Source short name filter applied.",
"type": "string"
},
"text": {
"description": "Full-text query the search used.",
"type": "string"
},
"theme": {
"description": "Theme name filter applied.",
"type": "string"
}
},
"required": [
"sort",
"preset",
"limit",
"offset"
],
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `unknown_format`: The format value does not name a ReliefWeb report format. `invalid_query`: ReliefWeb rejected the query — 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.",
"examples": [
"unknown_format",
"invalid_query",
"upstream_error"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"items": {
"description": "Matching reports (summaries only — use reliefweb_get_report for full body).",
"items": {
"additionalProperties": false,
"description": "A matching report summary.",
"properties": {
"countries": {
"description": "All countries tagged on this report.",
"items": {
"type": "string"
},
"type": "array"
},
"dateCreated": {
"description": "ReliefWeb index date (ISO 8601).",
"type": "string"
},
"dateOriginal": {
"description": "Source publication date (ISO 8601).",
"type": "string"
},
"fileUrls": {
"description": "Direct file download URLs attached to this report.",
"items": {
"type": "string"
},
"type": "array"
},
"formats": {
"description": "Content format names.",
"items": {
"type": "string"
},
"type": "array"
},
"headlineSummary": {
"description": "Short editorial summary from the headline block, when present.",
"type": "string"
},
"id": {
"description": "ReliefWeb numeric report ID.",
"type": "number"
},
"languages": {
"description": "Language codes (ISO 639-1).",
"items": {
"type": "string"
},
"type": "array"
},
"primaryCountry": {
"description": "Primary country name for this report.",
"type": "string"
},
"sources": {
"description": "Publishing organizations (short names).",
"items": {
"type": "string"
},
"type": "array"
},
"themes": {
"description": "Humanitarian theme/sector names.",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Report title.",
"type": "string"
},
"urlAlias": {
"description": "Canonical ReliefWeb URL for this report.",
"type": "string"
}
},
"required": [
"id",
"title"
],
"type": "object"
},
"type": "array"
},
"notice": {
"description": "Present only when the page is empty. Names the match count and the last reachable offset when the query matched records; otherwise echoes the filters applied and suggests how to broaden.",
"type": "string"
},
"totalCount": {
"description": "Total reports matching the query before pagination.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Search humanitarian training and learning opportunities on ReliefWeb by country, format, date, source, career category, and 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"career_category": {
"description": "Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology). Filters on career_categories.name.",
"type": "string"
},
"country": {
"description": "ISO 3166-1 alpha-3 country code (e.g., KEN, ETH, COD). Filters to training tagged with this country.",
"type": "string"
},
"date_start_from": {
"anyOf": [
{
"const": "",
"type": "string"
},
{
"description": "Calendar date (2024-06-01) or full ISO 8601 datetime (2024-06-01T00:00:00+00:00).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"type": "string"
}
],
"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."
},
"date_start_to": {
"anyOf": [
{
"const": "",
"type": "string"
},
{
"description": "Calendar date (2024-12-31) or full ISO 8601 datetime (2024-12-31T23:59:59+00:00).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"type": "string"
}
],
"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."
},
"format": {
"description": "Training format. Valid values: on-site, online. Filters on format.name.",
"enum": [
"on-site",
"online"
],
"type": "string"
},
"include_archived": {
"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.",
"type": "boolean"
},
"language": {
"description": "ISO 639-1 language code (e.g., en, fr, es). Filters on language.code.",
"type": "string"
},
"limit": {
"default": 10,
"description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"sort": {
"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.",
"type": "string"
},
"source": {
"description": "Organization short name. Filters on source.shortname.",
"type": "string"
},
"text": {
"description": "Full-text search query. Matches against training title and description.",
"type": "string"
}
},
"type": "object"
},
"name": "reliefweb_search_training",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"items",
"appliedFilters",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"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.",
"properties": {
"careerCategory": {
"description": "Career category name filter applied.",
"type": "string"
},
"country": {
"description": "Country code as normalized (uppercased ISO3).",
"type": "string"
},
"dateStartFrom": {
"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.",
"type": "string"
},
"dateStartTo": {
"description": "Training start date upper bound applied.",
"type": "string"
},
"format": {
"description": "Training format name filter applied.",
"type": "string"
},
"language": {
"description": "Language code filter applied.",
"type": "string"
},
"limit": {
"description": "Result limit the query used.",
"type": "number"
},
"offset": {
"description": "Pagination offset the query used.",
"type": "number"
},
"preset": {
"description": "ReliefWeb preset the query used: latest (current listings only, default) or analysis when include_archived.",
"type": "string"
},
"sort": {
"description": "Sort order the query used (resolved, including the default).",
"type": "string"
},
"source": {
"description": "Source short name filter applied.",
"type": "string"
},
"text": {
"description": "Full-text query the search used.",
"type": "string"
}
},
"required": [
"sort",
"preset",
"limit",
"offset"
],
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_query`: ReliefWeb rejected the query — 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.",
"examples": [
"invalid_query",
"upstream_error"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"items": {
"description": "Matching training opportunities.",
"items": {
"additionalProperties": false,
"description": "A matching training opportunity.",
"properties": {
"careerCategories": {
"description": "Career category names (humanitarian tracks).",
"items": {
"type": "string"
},
"type": "array"
},
"countries": {
"description": "Countries tagged on this training.",
"items": {
"type": "string"
},
"type": "array"
},
"dateEnd": {
"description": "Training end date (ISO 8601).",
"type": "string"
},
"dateRegistration": {
"description": "Registration deadline (ISO 8601).",
"type": "string"
},
"dateStart": {
"description": "Training start date (ISO 8601).",
"type": "string"
},
"formats": {
"description": "Training format names.",
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"description": "ReliefWeb numeric training ID.",
"type": "number"
},
"languages": {
"description": "Language codes (ISO 639-1).",
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"description": "Organizing organizations (short names).",
"items": {
"type": "string"
},
"type": "array"
},
"themes": {
"description": "Humanitarian theme/sector names.",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Training title.",
"type": "string"
},
"urlAlias": {
"description": "Canonical ReliefWeb URL for this training listing.",
"type": "string"
}
},
"required": [
"id",
"title"
],
"type": "object"
},
"type": "array"
},
"notice": {
"description": "Present only when the page is empty. Names the match count and the last reachable offset when the query matched records; otherwise echoes the filters applied and suggests how to broaden.",
"type": "string"
},
"totalCount": {
"description": "Total training listings matching the query before pagination.",
"type": "number"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:7cce9a6c3306b4c1368cd0edcb369d77f6d186c32aff442a846d7cfe130459b6 | sha256sum