io.github.cyanheads/reliefweb-mcp-server
REMOTE · RELIEFWEB.CASEYJHAND.COM · 2 COMPONENTS
Search ReliefWeb humanitarian reports, disasters, jobs, training, and country profiles via MCP.
Available components
Last scanned (23 hours ago)
Scores higher than 97% of remote servers
Reachable. Last reached 5 Nov 2026.
Category Search and Retrieval
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security83
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- No authorisation is required to call this server. Nothing on it is marked destructive, but we can't show that an anonymous caller can only read: full credit needs the server to list at least one tool and every tool to be verifiably read-only. We use a best-effort check of tool names and descriptions to tell read-only tools from tools that change things, so some genuinely read-only tools may not get full credit. Names that start with a read verb (get, list, read, search and similar) and accurate readOnlyHint annotations help. Meet that to earn full credit, or require authorisation. See how to fix → View diagnostics → Partial
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability75
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 4641 tokens (~386/item across 12 items; 11 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 11 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 13 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Checks we ran (13)
- TLS certificate
- Authorization
- HTTPS
- HSTS header
- DNSSEC
- Transport
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 26 Oct 26 0
- Tool “reliefweb_search_training” rewrote its description, which is the text the model reads security
- New resource “reliefweb-guide” functional
- Server version: 0.2.3 → 0.3.0 functional
- “reliefweb_search_training” added an optional parameter “cost” cosmetic
- “reliefweb_search_training” added an optional parameter “training_language” cosmetic
- “reliefweb_search_training” reworded the description of “limit” cosmetic
- “reliefweb_search_jobs” reworded the description of “career_category” cosmetic
- “reliefweb_search_jobs” reworded the description of “limit” cosmetic
- “reliefweb_search_reports” reworded the description of “limit” cosmetic
- “reliefweb_search_training” reworded the description of “career_category” cosmetic
- “reliefweb_search_training” reworded the description of “language” cosmetic
- “reliefweb_list_countries” reworded the description of “limit” cosmetic
- “reliefweb_list_sources” reworded the description of “limit” cosmetic
- “reliefweb_search_disasters” reworded the description of “limit” cosmetic
- 10 Oct 26 0
- Server version: 0.2.2 → 0.2.3 functional
- “reliefweb_get_country” reworded the description of “sections” cosmetic
- “reliefweb_get_disaster” reworded the description of “sections” cosmetic
- “reliefweb_get_job” reworded the description of “sections” cosmetic
- “reliefweb_get_report” reworded the description of “sections” cosmetic
- “reliefweb_get_training” reworded the description of “sections” cosmetic
- 28 Sept 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 25 Sept 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 20 Sept 26 0
- Server version: 0.2.1 → 0.2.2 functional
- 9 Sept 26 0
- Stability: 0.97 → pass security
- 7 Sept 26 0
- Stability: pass → 0.93 functional
- 26 Aug 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Probed https://reliefweb.caseyjhand.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=caseyjhand.com | CN=WE1,O=Google Trust Services,C=US | 2 Nov 2026 | 31 Jan 2027 | ECDSA 256 | ECDSA-SHA256 | 995a30681ab772540e934241ca1d576c |
| SANs: caseyjhand.com, *.caseyjhand.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC secure
Validation of reliefweb.caseyjhand.com. — Secure
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | Trust anchor | 20326, 38696 | 8, 8 | Verified |
| com. | DS published | 19718 | 13 | Verified |
| caseyjhand.com. | DS published | 2371 | 13 | Verified |
| reliefweb.caseyjhand.com. | Verified address RRset verified with the apex keys |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=63072000; includeSubDomains; preload |
| x-content-type-options | nosniff |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://reliefweb.caseyjhand.com/mcp | Verified | 200 | |
| http (plaintext) | http://reliefweb.caseyjhand.com/mcp | HTTPS enforced | 301 | https://reliefweb.caseyjhand.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
reliefweb_get_country Get ReliefWeb Country Profile ~428
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.
| Name | Type | Req | Description |
|---|---|---|---|
| archive | object | – | 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… |
| iso3 | string | yes | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Used to look up the country's ReliefWeb profile. |
| sections | array | – | 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 budge… |
| Name | Type | Req | Description |
|---|---|---|---|
| appealsResponsePlans | array | – | Currently-active humanitarian appeals and response plans for this country — the present set. The archived entries are reachable with archive: { list: "appealsResponsePlans" }. |
| archive | object | – | One page of a curated list's archived entries, returned in place of the record. |
| error | object | – | Present when the call failed. Absent on success. |
| id | number | – | ReliefWeb numeric country ID. |
| iso3 | string | – | ISO 3166-1 alpha-3 code. |
| keyContent | array | – | Currently-active curated key content links maintained by ReliefWeb editors — the present curated set. The archived entries are reachable with archive: { list: "keyContent" }. |
| kind | string | – | 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… |
| name | string | – | Country name. |
| notice | string | – | Requested and applied archive limits when the page size was clamped. |
| outlineNotice | string | – | How to re-call this tool for specific sections of the record. |
| profileOverview | string | – | Situation overview text from the ReliefWeb editorial team. |
| sections | array | – | Every section of the record, largest first. Pass the names back in `sections` to retrieve them. |
| status | string | – | Humanitarian situation status. |
| urlAlias | string | – | Canonical ReliefWeb URL for this country page. |
| usefulLinks | array | – | Currently-active useful external links curated by ReliefWeb editors — the present set. The archived entries are reachable with archive: { list: "usefulLinks" }. |
No examples provided.
reliefweb_get_disaster Get ReliefWeb Disaster ~408
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.
| Name | Type | Req | Description |
|---|---|---|---|
| archive | object | – | 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… |
| id | integer | yes | ReliefWeb numeric disaster ID. Obtained from reliefweb_search_disasters results. |
| sections | array | – | 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 budg… |
| Name | Type | Req | Description |
|---|---|---|---|
| appealsResponsePlans | array | – | Currently-active appeals and response plans linked to this disaster — the present set. The archived entries are reachable with archive: { list: "appealsResponsePlans" }. |
| archive | object | – | One page of a curated list's archived entries, returned in place of the record. |
| countries | array | – | All countries tagged on this disaster. |
| dateCreated | string | – | ReliefWeb index date (ISO 8601). |
| dateEvent | string | – | Event date (ISO 8601), when available. |
| description | string | – | Full disaster description text. |
| error | object | – | Present when the call failed. Absent on success. |
| glide | string | – | GLIDE number for cross-system correlation. |
| id | number | – | ReliefWeb numeric disaster ID. |
| keyContent | array | – | Currently-active curated key content links from the ReliefWeb editorial team — the present curated set. The archived entries are reachable with archive: { list: "keyContent" }. |
| kind | string | – | 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… |
| name | string | – | Disaster name. |
| notice | string | – | Requested and applied archive limits when the page size was clamped. |
| outlineNotice | string | – | How to re-call this tool for specific sections of the record. |
| primaryCountry | string | – | Primary affected country. |
| primaryType | string | – | Primary disaster type. |
| profileOverview | string | – | Profile overview text from the ReliefWeb editorial team. |
| sections | array | – | Every section of the record, largest first. Pass the names back in `sections` to retrieve them. |
| status | string | – | Disaster status: alert, ongoing, past, or alert-archive. |
| types | array | – | Disaster type names. |
| urlAlias | string | – | Canonical ReliefWeb URL for this disaster. |
| usefulLinks | array | – | Currently-active useful external links curated by ReliefWeb editors — the present set. The archived entries are reachable with archive: { list: "usefulLinks" }. |
No examples provided.
reliefweb_get_job Get ReliefWeb Job ~239
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.
| Name | Type | Req | Description |
|---|---|---|---|
| id | integer | yes | ReliefWeb numeric job ID. Obtained from reliefweb_search_jobs results. |
| sections | array | – | 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. R… |
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | – | Full vacancy description (Markdown) — duties, requirements, and conditions. |
| careerCategories | array | – | Career category names (humanitarian tracks). |
| countries | array | – | Countries tagged on this job. |
| dateChanged | string | – | Date this posting was last modified (ISO 8601). |
| dateClosing | string | – | Application closing date (ISO 8601). |
| dateCreated | string | – | Date this posting was indexed (ISO 8601). |
| error | object | – | Present when the call failed. Absent on success. |
| experienceLevels | array | – | Required experience levels. |
| howToApply | string | – | Application instructions (Markdown) as published by the hiring organization. |
| id | number | – | ReliefWeb numeric job ID. |
| kind | string | – | 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. |
| outlineNotice | string | – | How to re-call this tool for specific sections of the record. |
| sections | array | – | Every section of the record, largest first. Pass the names back in `sections` to retrieve them. |
| sources | array | – | Hiring organizations (short names). |
| status | string | – | Posting status: published while the vacancy is open, expired once it has closed. |
| themes | array | – | Humanitarian theme/sector names. |
| title | string | – | Job title. |
| types | array | – | Job type names, such as Job or Consultancy. |
| url | string | – | ReliefWeb node URL for this job listing. |
| urlAlias | string | – | Canonical ReliefWeb URL for this job listing. |
No examples provided.
reliefweb_get_report Get ReliefWeb Report ~237
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.
| Name | Type | Req | Description |
|---|---|---|---|
| id | integer | yes | ReliefWeb numeric report ID. Obtained from reliefweb_search_reports results. |
| sections | array | – | 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… |
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | – | Full report body text (Markdown). Present for most reports; absent for binary-only documents. |
| countries | array | – | All countries tagged on this report. |
| dateCreated | string | – | ReliefWeb index date (ISO 8601). |
| dateOriginal | string | – | Source publication date (ISO 8601). |
| error | object | – | Present when the call failed. Absent on success. |
| fileUrls | array | – | Direct file download URLs attached to this report. |
| formats | array | – | Content format names. |
| headlineSummary | string | – | Short editorial summary from the headline block, when present. |
| id | number | – | ReliefWeb numeric report ID. |
| kind | string | – | 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. |
| languages | array | – | Language codes (ISO 639-1). |
| outlineNotice | string | – | How to re-call this tool for specific sections of the record. |
| primaryCountry | string | – | Primary country name for this report. |
| sections | array | – | Every section of the record, largest first. Pass the names back in `sections` to retrieve them. |
| sources | array | – | Publishing organizations (short names). |
| themes | array | – | Humanitarian theme/sector names. |
| title | string | – | Report title. |
| urlAlias | string | – | Canonical ReliefWeb URL for this report. |
No examples provided.
reliefweb_get_training Get ReliefWeb Training ~247
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.
| Name | Type | Req | Description |
|---|---|---|---|
| id | integer | yes | ReliefWeb numeric training ID. Obtained from reliefweb_search_training results. |
| sections | array | – | 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 budg… |
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | – | Full training description (Markdown) — content, audience, and logistics. |
| careerCategories | array | – | Career category names (humanitarian tracks). |
| cities | array | – | Host cities, for on-site training. |
| cost | string | – | Cost class as ReliefWeb records it, such as free or fee-based. |
| countries | array | – | Countries tagged on this training. |
| dateCreated | string | – | Date this listing was indexed (ISO 8601). |
| dateEnd | string | – | Training end date (ISO 8601). |
| dateRegistration | string | – | Registration deadline (ISO 8601). |
| dateStart | string | – | Training start date (ISO 8601). |
| error | object | – | Present when the call failed. Absent on success. |
| eventUrl | string | – | The organizer's own page for this training, when published. |
| feeInformation | string | – | Fee detail as published by the organizer — amounts, inclusions, and conditions. |
| formats | array | – | Training format names: on-site or online. |
| howToRegister | string | – | Registration instructions (Markdown) as published by the organizer. |
| id | number | – | ReliefWeb numeric training ID. |
| kind | string | – | 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. |
| languages | array | – | Language codes of the listing (ISO 639-1). |
| outlineNotice | string | – | How to re-call this tool for specific sections of the record. |
| sections | array | – | Every section of the record, largest first. Pass the names back in `sections` to retrieve them. |
| sources | array | – | Organizing organizations (short names). |
| status | string | – | Listing status: published while the training is current, expired once concluded. |
| themes | array | – | Humanitarian theme/sector names. |
| title | string | – | Training title. |
| trainingLanguages | array | – | Language codes the training is delivered in (ISO 639-1). |
| types | array | – | Training type names, such as Training/Workshop or Course. |
| url | string | – | ReliefWeb node URL for this training listing. |
| urlAlias | string | – | Canonical ReliefWeb URL for this training listing. |
No examples provided.
reliefweb_list_countries List ReliefWeb Countries ~180
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.
| Name | Type | Req | Description |
|---|---|---|---|
| crisis_only | boolean | – | When true, filters to countries with an active humanitarian situation (status ongoing). Default false returns all countries. |
| limit | integer | – | Number of results to return (1–1000, default 100). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Each call counts against the 1,000-calls/da… |
| offset | integer | – | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| items | array | – | Countries tracked by ReliefWeb. |
| notice | string | – | Discloses requested and applied limits when clamped. For empty pages, names the match count and last reachable offset when records matched; otherwise echoes filters and suggests how to broaden. |
| totalCount | number | – | Total countries matching the filter before pagination. |
No examples provided.
reliefweb_list_sources List ReliefWeb Sources ~210
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Number of results to return (1–1000, default 10). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Each call counts against the 1,000-calls/day… |
| offset | integer | – | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. |
| text | string | – | Full-text search query. Matches against organization name and short name. |
| type | string | – | Organization type. One of: Non-governmental Organization, International Organization, Academic and Research Institution, Other, Government, Media, Red Cross/Red Crescent Movement. Filters on type.nam… |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| items | array | – | Source organizations contributing content to ReliefWeb. |
| notice | string | – | Discloses requested and applied limits when clamped. For empty pages, names the match count and last reachable offset when records matched; otherwise echoes filters and suggests how to broaden. |
| totalCount | number | – | Total sources matching the query before pagination. |
No examples provided.
reliefweb_search_disasters Search ReliefWeb Disasters ~531
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.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to disasters tagged with this country. |
| date_from | – | – | 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 U… |
| date_to | – | – | 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 resolve… |
| disaster_type | string | – | Disaster type name (e.g., Earthquake, Flood, Drought, Cyclone). Filters on type.name. |
| glide | string | – | GLIDE number (global disaster identifier, e.g., EQ-2023-000053-TUR). Use for cross-system disaster correlation. |
| include_archived | boolean | – | Include alert-archive disasters in results, alongside alert, ongoing, and past. Uses preset=analysis. Off by default. |
| limit | integer | – | Number of results to return (1–1000, default 10). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Each call counts against the 1,000-calls/day… |
| offset | integer | – | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. |
| sort | string | – | Sort order. Use date.created:desc for newest first (default), date.created:asc for oldest, score:desc for relevance. |
| status | string | – | 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… |
| text | string | – | Full-text search query. Matches against disaster name and description. |
| Name | Type | Req | Description |
|---|---|---|---|
| appliedFilters | object | – | 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. |
| error | object | – | Present when the call failed. Absent on success. |
| items | array | – | Matching disasters. |
| notice | string | – | Discloses requested and applied limits when clamped. For empty pages, names the match count and last reachable offset when records matched; otherwise echoes filters and suggests how to broaden. |
| totalCount | number | – | Total disasters matching the query before pagination. |
No examples provided.
reliefweb_search_jobs Search ReliefWeb Jobs ~441
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.
| Name | Type | Req | Description |
|---|---|---|---|
| career_category | string | – | ReliefWeb career-category name (e.g., Program/Project Management, Information and Communications Technology, Logistics/Procurement). Filters on career_categories.name. |
| country | string | – | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to jobs tagged with this country. |
| experience | string | – | Experience level (e.g., 0-2 years, 3-4 years, 5-9 years). Filters on experience.name. |
| include_archived | boolean | – | 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 hi… |
| limit | integer | – | Number of results to return (1–1000, default 10). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Each call counts against the 1,000-calls/day… |
| offset | integer | – | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. |
| sort | string | – | Sort order. Use date.created:desc for newest postings first (default), date.closing:asc to surface roles closing soonest, or score:desc for relevance. |
| source | string | – | Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname. |
| text | string | – | Full-text search query. Matches against job title, body, and key metadata fields. |
| theme | string | – | Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Protection). Filters on theme.name. |
| Name | Type | Req | Description |
|---|---|---|---|
| appliedFilters | object | – | 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. |
| error | object | – | Present when the call failed. Absent on success. |
| items | array | – | Matching job listings. |
| notice | string | – | Discloses requested and applied limits when clamped. For empty pages, names the match count and last reachable offset when records matched; otherwise echoes filters and suggests how to broaden. |
| totalCount | number | – | Total jobs matching the query before pagination. |
No examples provided.
reliefweb_search_reports Search ReliefWeb Reports ~737
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.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to content tagged with this country. |
| date_from | – | – | 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 of… |
| date_to | – | – | 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 U… |
| disaster_id | integer | – | ReliefWeb numeric disaster ID. Filters to reports linked to a specific disaster. Get the ID from reliefweb_search_disasters. |
| filter | object | – | Raw ReliefWeb filter object for compound conditions not covered by named params. Example: {"operator": "AND", "conditions": [{"field": "format.name", "value": "Map"}, {"field": "language.code", "valu… |
| format | string | – | 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… |
| include_archived | boolean | – | 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_searc… |
| language | string | – | ISO 639-1 language code (e.g., en, fr, es, ar). Filters on language.code. |
| limit | integer | – | Number of results to return (1–1000, default 10). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Use a smaller value for targeted lookups; la… |
| offset | integer | – | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through large result sets. |
| sort | string | – | Sort order. Use date.original:desc for newest first (default), date.original:asc for oldest first, score:desc for relevance. |
| source | string | – | Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname. |
| text | string | – | Full-text search query. Matches against title, body, and key metadata fields. Use plain natural language or keywords. |
| theme | string | – | 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| appliedFilters | object | – | 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. |
| error | object | – | Present when the call failed. Absent on success. |
| items | array | – | Matching reports (summaries only — use reliefweb_get_report for full body). |
| notice | string | – | Discloses requested and applied limits when clamped, an ignored empty raw filter, and empty-page guidance with the match count and last reachable offset or suggestions to broaden the search. |
| totalCount | number | – | Total reports matching the query before pagination. |
No examples provided.
reliefweb_search_training Search ReliefWeb Training ~733
Search humanitarian training and learning opportunities on ReliefWeb by country, format, date, source, career category, cost, listing language, and delivery language. Covers on-site and online capacity-building events. Training date fields use date.start / date.end — different from report date fields. Use date_start_from and date_start_to to find upcoming training within a window. Results default to soonest-starting first (date.start:asc). With neither date bound supplied the search is scoped to training starting from now, so the first page is upcoming opportunities; supply either bound to search an explicit range, including a historical one. Use include_archived=true to search concluded listings as well, which are far more numerous than the current ones.
| Name | Type | Req | Description |
|---|---|---|---|
| career_category | string | – | ReliefWeb career-category name (e.g., Program/Project Management, Information and Communications Technology, Logistics/Procurement). Filters on career_categories.name. |
| cost | string | – | Training cost: free or fee-based. Case, spacing, and punctuation are ignored; blank is omitted. |
| country | string | – | ISO 3166-1 alpha-3 country code (e.g., KEN, ETH, COD). Filters to training tagged with this country. |
| date_start_from | – | – | 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 offse… |
| date_start_to | – | – | 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 resolve… |
| format | string | – | Training format. Valid values: on-site, online. Filters on format.name. |
| include_archived | boolean | – | 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 thr… |
| language | string | – | Listing language code (ISO 639-1, e.g., en, fr, es). Filters on language.code; use training_language for the course delivery language. |
| limit | integer | – | Number of results to return (1–1000, default 10). Larger integers are clamped to 1000 with a notice when clamping is enabled; otherwise they are rejected. Each call counts against the 1,000-calls/day… |
| offset | integer | – | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. |
| sort | string | – | 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. |
| source | string | – | Organization short name. Filters on source.shortname. |
| text | string | – | Full-text search query. Matches against training title and description. |
| training_language | string | – | Course delivery language code (ISO 639-1, e.g., en, fr, es). Filters on training_language.code independently of the listing language. |
| Name | Type | Req | Description |
|---|---|---|---|
| appliedFilters | object | – | 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. |
| error | object | – | Present when the call failed. Absent on success. |
| items | array | – | Matching training opportunities. |
| notice | string | – | Discloses requested and applied limits when clamped. For empty pages, names the match count and last reachable offset when records matched; otherwise echoes filters and suggests how to broaden. |
| totalCount | number | – | Total training listings matching the query before pagination. |
No examples provided.
How do I install the io.github.cyanheads/reliefweb-mcp-server server?
io.github.cyanheads/reliefweb-mcp-server is a hosted endpoint at https://reliefweb.caseyjhand.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · reliefweb.caseyjhand.com
claude mcp add --transport http cyanheads-reliefweb-mcp-server 'https://reliefweb.caseyjhand.com/mcp'
What is the io.github.cyanheads/reliefweb-mcp-server server?
io.github.cyanheads/reliefweb-mcp-server is listed in the public MCP registry as io.github.cyanheads/reliefweb-mcp-server. Search ReliefWeb humanitarian reports, disasters, jobs, training, and country profiles via MCP. This page covers its hosted endpoint (https://reliefweb.caseyjhand.com/mcp).
Is the io.github.cyanheads/reliefweb-mcp-server server safe to use?
io.github.cyanheads/reliefweb-mcp-server scores 89 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.cyanheads/reliefweb-mcp-server server expose?
io.github.cyanheads/reliefweb-mcp-server exposes 11 tools: reliefweb_search_reports, reliefweb_get_report, reliefweb_search_disasters, reliefweb_get_disaster, reliefweb_get_country, and 6 more. Their descriptions and schemas cost roughly 4,391 tokens of context every time the server is loaded.
Does the io.github.cyanheads/reliefweb-mcp-server server require authentication?
No. We connected to io.github.cyanheads/reliefweb-mcp-server without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the io.github.cyanheads/reliefweb-mcp-server server still maintained?
io.github.cyanheads/reliefweb-mcp-server is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the io.github.cyanheads/reliefweb-mcp-server server?
VerifyMCP ran 13 checks on io.github.cyanheads/reliefweb-mcp-server, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.