reliefweb-mcp-server
Server Details
Search ReliefWeb humanitarian reports, disasters, jobs, training, and country profiles via MCP.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
- Repository
- cyanheads/reliefweb-mcp-server
- GitHub Stars
- 1
- Server Listing
- @cyanheads/reliefweb-mcp-server
Glama MCP Gateway
Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.
Full call logging
Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.
Tool access control
Enable or disable individual tools per connector, so you decide what your agents can and cannot do.
Managed credentials
Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.
Usage analytics
See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.
Tool Definition Quality
Average 4.5/5 across 9 of 9 tools scored.
Each tool has a clearly distinct purpose: get vs list vs search for different resource types (country, disaster, report, etc.). No two tools overlap in function.
All tools follow a consistent 'reliefweb_verb_noun' pattern (e.g., reliefweb_get_country, reliefweb_search_reports). No mixing of conventions.
9 tools is well within the ideal 3-15 range. The set covers listing, searching, and getting details for the main ReliefWeb entities without being bloated.
Core read operations are covered: listing sources/countries, searching content, and getting full records for country/disaster/report. Missing get_job and get_training tools is a minor gap.
Available Tools
9 toolsreliefweb_get_countryGet ReliefWeb Country ProfileRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| iso3 | Yes | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Used to look up the country's ReliefWeb profile. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | Yes | ReliefWeb numeric country ID. |
| iso3 | No | ISO 3166-1 alpha-3 code. |
| name | Yes | Country name. |
| status | No | Humanitarian situation status. |
| urlAlias | No | Canonical ReliefWeb URL for this country page. |
| keyContent | No | Currently-active curated key content links maintained by ReliefWeb editors — the present curated set, not the full historical archive. |
| usefulLinks | No | Currently-active useful external links curated by ReliefWeb editors — the present set, not the full historical archive. |
| profileOverview | No | Situation overview text from the ReliefWeb editorial team. |
| appealsResponsePlans | No | Currently-active humanitarian appeals and response plans for this country — the present set, not the full historical archive. |
reliefweb_get_disasterGet ReliefWeb DisasterRead-onlyIdempotentInspect
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. Description and profile overview can together run to tens of KB for major disasters; call this only when you need the full narrative text.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ReliefWeb numeric disaster ID. Obtained from reliefweb_search_disasters results. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | Yes | ReliefWeb numeric disaster ID. |
| name | Yes | Disaster name. |
| glide | No | GLIDE number for cross-system correlation. |
| types | No | Disaster type names. |
| status | No | Disaster status (alert, current, past, archive). |
| urlAlias | No | Canonical ReliefWeb URL for this disaster. |
| countries | No | All countries tagged on this disaster. |
| dateEvent | No | Event date (ISO 8601), when available. |
| keyContent | No | Currently-active curated key content links from the ReliefWeb editorial team — the present curated set, not the full historical archive. |
| dateCreated | No | ReliefWeb index date (ISO 8601). |
| description | No | Full disaster description text. |
| primaryType | No | Primary disaster type. |
| usefulLinks | No | Currently-active useful external links curated by ReliefWeb editors — the present set, not the full historical archive. |
| primaryCountry | No | Primary affected country. |
| profileOverview | No | Profile overview text from the ReliefWeb editorial team. |
| appealsResponsePlans | No | Currently-active appeals and response plans linked to this disaster — the present set, not the full historical archive. |
reliefweb_get_reportGet ReliefWeb ReportRead-onlyIdempotentInspect
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; call this only when you need the full document text.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ReliefWeb numeric report ID. Obtained from reliefweb_search_reports results. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | Yes | ReliefWeb numeric report ID. |
| body | No | Full report body text (HTML). Present for most reports; absent for binary-only documents. |
| title | Yes | Report title. |
| themes | No | Humanitarian theme/sector names. |
| formats | No | Content format names. |
| sources | No | Publishing organizations (short names). |
| fileUrls | No | Direct file download URLs attached to this report. |
| urlAlias | No | Canonical ReliefWeb URL for this report. |
| countries | No | All countries tagged on this report. |
| languages | No | Language codes (ISO 639-1). |
| dateCreated | No | ReliefWeb index date (ISO 8601). |
| dateOriginal | No | Source publication date (ISO 8601). |
| primaryCountry | No | Primary country name for this report. |
| headlineSummary | No | Short editorial summary from the headline block, when present. |
reliefweb_list_countriesList ReliefWeb CountriesRead-onlyIdempotentInspect
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 | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of results to return (1–1000, default 100). Each call counts against the 1,000-calls/day quota. | |
| offset | No | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. | |
| crisis_only | No | When true, filters to countries with an active humanitarian situation (status ongoing). Default false returns all countries. |
Output Schema
| Name | Required | Description |
|---|---|---|
| items | Yes | Countries tracked by ReliefWeb. |
| notice | No | Recovery hint when results are empty — echoes the active filter and suggests how to broaden. Absent on successful result pages. |
| totalCount | Yes | Total countries matching the filter before pagination. |
reliefweb_list_sourcesList ReliefWeb SourcesRead-onlyIdempotentInspect
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 | Required | Description | Default |
|---|---|---|---|
| text | No | Full-text search query. Matches against organization name and short name. | |
| type | No | 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 | No | Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota. | |
| offset | No | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. |
Output Schema
| Name | Required | Description |
|---|---|---|
| items | Yes | Source organizations contributing content to ReliefWeb. |
| notice | No | Recovery hint when results are empty — echoes the active filters and suggests how to broaden. Absent on successful result pages. |
| totalCount | Yes | Total sources matching the query before pagination. |
reliefweb_search_disastersSearch ReliefWeb DisastersRead-onlyIdempotentInspect
Search active and historical disasters on ReliefWeb by type, country, status, date range, and GLIDE number. Default preset covers alert, current, and past disasters. Use include_archived=true to include alert-archive and archive entries for historical research. Returns IDs suitable for use with reliefweb_get_disaster and as disaster_id filter in reliefweb_search_reports.
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order. Use date.created:desc for newest first (default), date.created:asc for oldest, score:desc for relevance. | |
| text | No | Full-text search query. Matches against disaster name and description. | |
| glide | No | GLIDE number (global disaster identifier, e.g., EQ-2023-000053-TUR). Use for cross-system disaster correlation. | |
| limit | No | Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota. | |
| offset | No | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. | |
| status | No | Disaster status filter. Values: alert (newly declared), current (ongoing), past (resolved), alert-archive, archive. Separate multiple values with commas. Default preset includes alert, current, past. | |
| country | No | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to disasters tagged with this country. | |
| date_to | No | Latest disaster creation date (ISO 8601). Pair with date_from for a date range. | |
| date_from | No | Earliest disaster creation date (ISO 8601). Filters on date.created. | |
| disaster_type | No | Disaster type name (e.g., Earthquake, Flood, Drought, Cyclone). Filters on type.name. | |
| include_archived | No | Include alert-archive and archive disasters in results. Uses preset=analysis. Off by default. |
Output Schema
| Name | Required | Description |
|---|---|---|
| items | Yes | Matching disasters. |
| notice | No | Recovery hint when results are empty — echoes filters applied and suggests how to broaden. |
| totalCount | Yes | Total disasters matching the query before pagination. |
| appliedFilters | Yes | 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. |
reliefweb_search_jobsSearch ReliefWeb JobsRead-onlyIdempotentInspect
Search humanitarian job listings on ReliefWeb by country, organization, career category, theme, and experience level. Returns current open positions — archived or expired jobs are excluded by default. Use text search for role titles and job descriptions.
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | 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 | No | Full-text search query. Matches against job title, body, and key metadata fields. | |
| limit | No | Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota. | |
| theme | No | Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Protection). Filters on theme.name. | |
| offset | No | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. | |
| source | No | Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname. | |
| country | No | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to jobs tagged with this country. | |
| experience | No | Experience level (e.g., 0-2 years, 3-4 years, 5-9 years). Filters on experience.name. | |
| career_category | No | Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology, Logistics and Telecommunications). Filters on career_categories.name. |
Output Schema
| Name | Required | Description |
|---|---|---|
| items | Yes | Matching job listings. |
| notice | No | Recovery hint when results are empty — echoes filters applied and suggests how to broaden. |
| totalCount | Yes | Total jobs matching the query before pagination. |
| appliedFilters | Yes | 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. |
reliefweb_search_reportsSearch ReliefWeb ReportsRead-onlyIdempotentInspect
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. Use preset include_archived=true to include expired or archived reports in historical research. Note: each call counts against the 1,000 calls/day quota.
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order. Use date.original:desc for newest first (default), date.original:asc for oldest first, score:desc for relevance. | |
| text | No | Full-text search query. Matches against title, body, and key metadata fields. Use plain natural language or keywords. | |
| limit | No | Number of results to return (1–1000, default 10). Use a smaller value for targeted lookups; larger for bulk research. Each call counts against the 1,000-calls/day quota. | |
| theme | No | Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Shelter and NFI, Protection). Matches theme.name. | |
| filter | No | 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"}]}. | |
| format | No | Content format filter. Valid values: Situation Report, Assessment, Analysis, Map, Infographic, Manual and Guideline, News and Press Release, Policy Document, Appeal, Financial Report, Evaluation and Lessons Learned, Other. | |
| offset | No | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through large result sets. | |
| source | No | Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname. | |
| country | No | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to content tagged with this country. | |
| date_to | No | Latest publication date (ISO 8601). Pair with date_from for a date range. | |
| language | No | ISO 639-1 language code (e.g., en, fr, es, ar). Filters on language.code. | |
| date_from | No | Earliest publication date (ISO 8601, e.g., 2024-01-15T00:00:00+00:00). Filters on date.original (source publication date). | |
| disaster_id | No | ReliefWeb numeric disaster ID. Filters to reports linked to a specific disaster. Get the ID from reliefweb_search_disasters. | |
| include_archived | No | Include archived and to-review content in addition to published. Uses preset=analysis. Off by default. |
Output Schema
| Name | Required | Description |
|---|---|---|
| items | Yes | Matching reports (summaries only — use reliefweb_get_report for full body). |
| notice | No | Recovery hint when results are empty — echoes the filters applied and suggests how to broaden. Absent on successful result pages. |
| totalCount | Yes | Total reports matching the query before pagination. |
| appliedFilters | Yes | 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. |
reliefweb_search_trainingSearch ReliefWeb TrainingRead-onlyIdempotentInspect
Search humanitarian training and learning opportunities on ReliefWeb by country, format, date, source, career category, and language. Covers on-site and online capacity-building events. Training date fields use date.start / date.end — different from report date fields. Use date_start_from and date_start_to to find upcoming training within a window. Results default to soonest-starting first (date.start:asc).
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | 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 | No | Full-text search query. Matches against training title and description. | |
| limit | No | Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota. | |
| format | No | Training format. Valid values: on-site, online. Filters on format.name. | |
| offset | No | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. | |
| source | No | Organization short name. Filters on source.shortname. | |
| country | No | ISO 3166-1 alpha-3 country code (e.g., KEN, ETH, COD). Filters to training tagged with this country. | |
| language | No | ISO 639-1 language code (e.g., en, fr, es). Filters on language.code. | |
| date_start_to | No | Training start date upper bound (ISO 8601). Filters on date.start — pair with date_start_from for a window. | |
| career_category | No | Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology). Filters on career_categories.name. | |
| date_start_from | No | Training start date lower bound (ISO 8601). Filters on date.start — use to find training starting after a given date. |
Output Schema
| Name | Required | Description |
|---|---|---|
| items | Yes | Matching training opportunities. |
| notice | No | Recovery hint when results are empty — echoes filters applied and suggests how to broaden. |
| totalCount | Yes | Total training listings matching the query before pagination. |
| appliedFilters | Yes | 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. |
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [{ "email": "your-email@example.com" }]
}The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!
Your Connectors
Sign in to create a connector for this server.