Reliefweb MCP Server

io.github.cyanheads/reliefweb-mcp-server

answering

Reliefweb MCP Server is answering right now. Last checked 4 min ago. 68 installs a week from npm. It exposes 9 tools. Last commit 13 Jul 2026.

Search ReliefWeb humanitarian reports, disasters, jobs, training, and country profiles via MCP.

Installs per day peak 245 · avg 24 · -29% w/w

a month agotoday

Uptime history 41 hours of history · worst hour 75%

41 hours agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

404 ms

Response time

average over 24h

Installs / week

npm and PyPI

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 4 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add reliefweb-mcp-server --transport http https://reliefweb.caseyjhand.com/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "reliefweb-mcp-server": {
      "url": "https://reliefweb.caseyjhand.com/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.reliefweb-mcp-server]
url = "https://reliefweb.caseyjhand.com/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "reliefweb-mcp-server": {
      "url": "https://reliefweb.caseyjhand.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "reliefweb-mcp-server": {
      "url": "https://reliefweb.caseyjhand.com/mcp"
    }
  }
}

Available tools 9

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

reliefweb

reliefweb_get_country

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.

reliefweb_get_disaster

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.

reliefweb_get_report

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.

reliefweb_list_countries

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.

reliefweb_list_sources

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.

reliefweb_search_disasters

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.

reliefweb_search_jobs

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.

reliefweb_search_reports

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.

reliefweb_search_training

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).

Endpoints

URL	Transport	State	Latency	Checked
https://reliefweb.caseyjhand.com/mcp	streamable-http	answering	460 ms	4 min ago

Reliefweb MCP Server — questions

Answers built from our own checks of this server.

What can Reliefweb MCP Server do?

It exposes 9 tools, read directly from the server on our last check. Among them: reliefweb_get_country, reliefweb_get_disaster, reliefweb_get_report, reliefweb_list_countries, reliefweb_list_sources, reliefweb_search_disasters and 3 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Reliefweb MCP Server working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 404 ms. The bar chart above shows every period we have measured.

How do I connect Reliefweb MCP Server?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Reliefweb MCP Server need an API key?

No. Reliefweb MCP Server completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 9 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Reliefweb MCP Server?

It answers our handshake in 404 ms on average, which is faster than 33% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

How many people use Reliefweb MCP Server?

The npm package @cyanheads/reliefweb-mcp-server was installed 68 times in the last week. Week over week that is -29%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Reliefweb MCP Server open source?

Yes — it is published under the Apache-2.0 licence, written in TypeScript, 1 stars on GitHub and 10 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.