Reliefweb MCP Server

@cyanheads/reliefweb-mcp-server Search ReliefWeb humanitarian reports, disasters, jobs, training, and country profiles via MCP. STDIO or Streamable HTTP. 11 Tools • 3 Resources • 1 Prompt • 1 Skill

Public Hosted Server: https://reliefweb.caseyjhand.com/mcp

Overview

Humanitarian reports, disasters, jobs, training, and country profiles from ReliefWeb, OCHA's information hub for crisis response. Search and read across every ReliefWeb content type.

Tools

Resources

Prompts

Capability reference

Search/list page limits above 1,000 and profile-archive limits above 100 are clamped with a notice showing the requested and applied values. Defaults are unchanged: 10 for searches and sources, 100 for countries, 25 for profile archives. Set RELIEFWEB_CLAMP_LIMITS=false to restore strict upper-bound validation. Zero, negative, and fractional limits are always rejected.

reliefweb_search_reports tool

• Full-text query plus filters: country (ISO3), disaster ID, format, theme, language (ISO 639-1), and source shortname
• Date range filtering on source publication date (date_from/date_to) — a bare 2024-01-15 works alongside full ISO 8601
• Format is a closed set: News and Press Release, Situation Report, Map, Infographic, Analysis, Other, Assessment, Manual and Guideline, Appeal, UN Document, Evaluation and Lessons Learned — matched ignoring case, spacing, and punctuation; anything else is rejected with the list
• Raw filter object for compound conditions the named params don't cover
• Pagination via offset/limit, up to 1,000 per call (default 10)
• include_archived has no effect — reports carry no archived class, so every report is already in scope

reliefweb_get_report tool

• Full body Markdown, all metadata, and file attachment URLs
• Use after reliefweb_search_reports to retrieve content — bodies run 10–100KB
• Over the response budget, returns a section outline instead; sections: ["body"] pulls the body back on its own
• Returns structured not_found when the ID doesn't exist

reliefweb_search_disasters tool

• Filtering by disaster type, country, status, and GLIDE number for cross-system correlation
• Date range filtering on disaster creation date (date_from/date_to) — a bare 2024-01-15 works alongside full ISO 8601
• Status is a closed set: alert, ongoing, past, alert-archive; comma-separate for multiple, matched ignoring case, spacing, and punctuation
• alert-archive is reachable only with include_archived=true — the default preset hides it
• Pagination via offset/limit, up to 1,000 per call (default 10)
• Returns IDs for reliefweb_get_disaster and as the disaster_id filter in reliefweb_search_reports

reliefweb_get_disaster tool

• Full description, profile overview, affected countries, and GLIDE number
• Retrieves archived disaster records as well as current ones
• Three curated lists — keyContent, appealsResponsePlans, usefulLinks — each returns only its currently-active entries; archived entries page via archive: { list: }
• Major disasters run to tens of KB; over the response budget the record becomes a section outline, and sections: ["description"] or ["profileOverview"] pulls one narrative at a time
• sections and archive are alternative modes — a call supplying both is rejected
• Returns structured not_found when the ID doesn't exist

reliefweb_get_country tool

• Situation overview text curated by OCHA editors
• Three curated lists — keyContent, appealsResponsePlans, usefulLinks — each returns only its currently-active entries; archived entries (thousands deep for a long-running crisis) page via archive: { list: }
• sections and archive are alternative modes — a call supplying both is rejected
• Carries the same section-outline behavior as the other detail tools, though an active-only profile is small enough that it rarely reaches the budget
• Use reliefweb_list_countries to discover valid ISO3 codes
• Returns structured not_found for an unknown ISO3 code

reliefweb_list_countries tool

• Optional crisis_only=true to limit to active humanitarian situations (status ongoing)
• Returns ISO3 codes, status, and canonical URLs — use ISO3 with reliefweb_get_country
• Pagination up to 1,000 entries per call (default 100)

reliefweb_search_jobs tool

• Filtering by country, organization shortname, career category, theme, and experience level
• Returns current open postings by default; include_archived=true reaches the closed archive, far larger than the open set
• Sortable by newest posting (date.created:desc, default) or soonest closing (date.closing:asc)
• Pagination via offset/limit, up to 1,000 per call (default 10)
• Returns IDs for reliefweb_get_job

reliefweb_get_job tool

• Full vacancy description and application instructions — neither is in search results
• Posting status, indexed / closing / last-modified dates, hiring organization, countries, career category, experience level, and job type
• Both canonical URLs (the readable alias and the node URL)
• Reaches expired postings as well as open ones
• Over the response budget, returns a section outline; sections: ["howToApply"] pulls the instructions without the whole description
• Returns structured not_found pointing back at reliefweb_search_jobs

reliefweb_search_training tool

• Filtering by country, source, format (on-site or online), career category, and cost (free or fee-based)
• language filters the listing language; training_language filters delivery language. Summaries include cost and delivery languages when supplied by the organizer
• Date range filtering on training start date (date_start_from/date_start_to) — a bare 2024-06-01 works alongside full ISO 8601
• Scoped to training starting from now when neither date bound is given; supply either one for an explicit range, including a historical one
• include_archived=true reaches concluded listings and drops the start-from-now default, so an otherwise unbounded search reaches the whole record
• Ordered by soonest start date by default (date.start:asc, distinct from report date fields); override with sort
• Returns IDs for reliefweb_get_training

reliefweb_get_training tool

• Full description and registration instructions — neither is in search results
• Cost class, the organizer's fee detail, and the organizer's own event URL
• Listing status, start / end / registration / indexed dates, host cities, format, type, listing and delivery languages, organizing source, and both canonical URLs
• Reaches concluded listings as well as current ones
• Over the response budget, returns a section outline; sections: ["cost", "feeInformation", "howToRegister"] pulls just the practicalities
• Returns structured not_found pointing back at reliefweb_search_training

reliefweb_list_sources tool

• Optional filtering by name text or organization type: Government, International Organization, Non-governmental Organization, Academic and Research Institution, Media, Red Cross/Red Crescent Movement, Other
• Returns short names, types, organization URLs, and homepage URLs
• Pagination via offset/limit, up to 1,000 per call (default 10)
• Use shortname with the source filter in reliefweb_search_reports, reliefweb_search_jobs, and reliefweb_search_training

reliefweb://reports/{id} resource

• Full report record as application/json — metadata, body text, and file URLs
• id must be digits o