reliefweb-mcp-server

{'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': 100, 'minimum': 1, 'description': 'Maximum archived entries in one page (1-100).'}, '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 â\x80\x94 sections slices the record, archive replaces it â\x80\x94 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. Identity metadata â\x80\x94 the record's ID, its name, and its canonical URL â\x80\x94 comes back alongside whatever is requested. The call is self-contained â\x80\x94 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 â\x80\x94 use archive for those."}}, 'additionalProperties': False}

{'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 â\x80\x94 or the sections asked for â\x80\x94 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': {}}, '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 â\x80\x94 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 â\x80\x94 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 â\x80\x94 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 â\x80\x94 the present set. The archived entries are reachable with archive: { list: "appealsResponsePlans" }.'}}, 'additionalProperties': False}

{'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': 100, 'minimum': 1, 'description': 'Maximum archived entries in one page (1-100).'}, '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 â\x80\x94 sections slices the record, archive replaces it â\x80\x94 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. Identity metadata â\x80\x94 the record's ID, its name, and its canonical URL â\x80\x94 comes back alongside whatever is requested. The call is self-contained â\x80\x94 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 â\x80\x94 use archive for those."}}, 'additionalProperties': False}

{'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 â\x80\x94 or the sections asked for â\x80\x94 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.'}, '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 â\x80\x94 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 â\x80\x94 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 â\x80\x94 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 â\x80\x94 the present set. The archived entries are reachable with archive: { list: "appealsResponsePlans" }.'}}, 'additionalProperties': False}

{'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. Identity metadata â\x80\x94 the record's ID, its name, and its canonical URL â\x80\x94 comes back alongside whatever is requested. The call is self-contained â\x80\x94 the record is re-fetched and sliced, so no prior call has to be repeated."}}, 'additionalProperties': False}

{'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 (HTML) â\x80\x94 duties, requirements, and conditions.'}, 'kind': {'enum': ['full', 'outline'], 'type': 'string', 'description': 'full when the record â\x80\x94 or the sections asked for â\x80\x94 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 â\x80\x94 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 (HTML) 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}

{'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. Identity metadata â\x80\x94 the record's ID, its name, and its canonical URL â\x80\x94 comes back alongside whatever is requested. The call is self-contained â\x80\x94 the record is re-fetched and sliced, so no prior call has to be repeated."}}, 'additionalProperties': False}

{'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 (HTML). Present for most reports; absent for binary-only documents.'}, 'kind': {'enum': ['full', 'outline'], 'type': 'string', 'description': 'full when the record â\x80\x94 or the sections asked for â\x80\x94 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 â\x80\x94 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}

{'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. Identity metadata â\x80\x94 the record's ID, its name, and its canonical URL â\x80\x94 comes back alongside whatever is requested. The call is self-contained â\x80\x94 the record is re-fetched and sliced, so no prior call has to be repeated."}}, 'additionalProperties': False}

{'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 (HTML) â\x80\x94 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 â\x80\x94 or the sections asked for â\x80\x94 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 â\x80\x94 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 (HTML) 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 â\x80\x94 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}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 100, 'maximum': 1000, 'minimum': 1, 'description': 'Number of results to return (1â\x80\x931000, default 100). 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}

{'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': '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.'}, 'totalCount': {'type': 'number', 'description': 'Total countries matching the filter before pagination.'}}, 'additionalProperties': False}

{'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': 1000, 'minimum': 1, 'description': 'Number of results to return (1â\x80\x931000, default 10). 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}

{'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 â\x80\x94 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': '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.'}, 'totalCount': {'type': 'number', 'description': 'Total sources matching the query before pagination.'}}, 'additionalProperties': False}

{'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': 1000, 'minimum': 1, 'description': 'Number of results to return (1â\x80\x931000, default 10). 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 â\x80\x94 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}

{'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_status', 'invalid_query', 'upstream_error'], '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 â\x80\x94 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': '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.'}, '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}

{'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': 1000, 'minimum': 1, 'description': 'Number of results to return (1â\x80\x931000, default 10). 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': 'Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology, Logistics and Telecommunications). Filters on career_categories.name.'}, 'include_archived': {'type': 'boolean', 'description': 'Search expired postings alongside the open ones. Uses preset=analysis. Off by default â\x80\x94 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}

{'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 â\x80\x94 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.'}, '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': '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.'}, '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}

{'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': 1000, 'minimum': 1, 'description': 'Number of results to return (1â\x80\x931000, default 10). 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 â\x80\x94 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 â\x80\x94 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}

{'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_format', 'invalid_query', 'upstream_error'], '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 â\x80\x94 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 â\x80\x94 use reliefweb_get_report for full body).'}, 'notice': {'type': 'string', '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.'}, '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 â\x80\x94 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}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'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': 1000, 'minimum': 1, 'description': 'Number of results to return (1â\x80\x931000, default 10). 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': 'ISO 639-1 language code (e.g., en, fr, es). Filters on language.code.'}, '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 â\x80\x94 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': 'Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology). 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 â\x80\x94 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.'}}, 'additionalProperties': False}

{'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 â\x80\x94 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.'}, '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': '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).'}}, 'description': 'A matching training opportunity.', 'additionalProperties': False}, 'description': 'Matching training opportunities.'}, 'notice': {'type': 'string', '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.'}, 'totalCount': {'type': 'number', 'description': 'Total training listings 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.'}, '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': 'Language code filter applied.'}, 'dateStartTo': {'type': 'string', 'description': 'Training start date upper bound applied.'}, 'dateStartFrom': {'type': 'string', 'description': 'Training start date lower bound applied â\x80\x94 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.'}}, '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}