Reliefweb MCP Server

by cyanheads Your server? Claim it

answering

Reliefweb MCP Server is answering right now. Last checked 3 min ago. 73 installs a week from npm. It exposes 11 tools. Last commit 25 Aug 2026.

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

Installs per day peak 155 · avg 16 · +108% w/w

a month agotoday

Uptime history 47 days of history · worst day 0%

47 days agonow

100.0%

Uptime 24h

92 of 92 checks

Tools

read from the server

332 ms

Response time

average over 24h

Installs / week

npm and PyPI

What changed 12

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 25 August 2026. No other catalogue keeps this.

25 Aug 11 tools changed the parameters they ask for reliefweb_get_country, reliefweb_get_disaster, reliefweb_get_job and 8 more

25 Aug a tool changed version

Nothing serious here today

Today is the operative word: we check Reliefweb MCP Server every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 3 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"
    }
  }
}

This one needs environment variables set before it will start: RELIEFWEB_APP_NAME (Pre-approved appname for the ReliefWeb API v2. Required since November 2025.), MCP_HTTP_HOST (The hostname for the HTTP server.), MCP_HTTP_PORT (The port to run the HTTP server on.), MCP_HTTP_ENDPOINT_PATH (The endpoint path for the MCP server.), MCP_PUBLIC_URL (Public origin override for deployments behind a TLS-terminating reverse proxy.), MCP_AUTH_MODE (Authentication mode to use: 'none', 'jwt', or 'oauth'.), MCP_LOG_LEVEL (Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').). The author declared them in the registry entry; get the values from the project itself.

Available tools 11

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

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

reliefweb_get_job

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.

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

reliefweb_get_training

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.

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

reliefweb_search_jobs

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.

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

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

Endpoints

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

Alternatives to Reliefweb MCP Server

same job, measured the same way

Timen

by vahtel

Timen time tracking — timers, time entries, reports, projects, and clients.

answering

Compoid MCP

by compoid

A collaborative repository where AI agents and humans share research, images, videos and papers.

13 tools answering

Seal Security

by sealsecurity

Vulnerability management: scan projects, search sealed packages, manage sealing rules and reports.

answering

Mailchimp MCP Server

by cyanheads

Mailchimp via MCP: draft, test, and send campaigns; manage audiences and subscribers; pull reports.

101 installs/wk local only

Klaviyo MCP

by scalably

Klaviyo MCP: campaigns, flows, segments, metrics, reports, profiles across many accounts. 24 tools.

44 installs/wk local only

Secobserve MCP

by nh4ttruong

MCP server for SecObserve: triage findings, manage products, import scan reports and SBOMs.

local only

Github

by davidweb3-ctrl

GitHub MCP Server - List PRs, issues, repo info, and search code

21 installs/wk local only

Npi Providers MCP Server

by cyanheads

Search NPPES providers and resolve NUCC specialty codes via MCP over STDIO or Streamable HTTP.

78 installs/wk 3 tools answering

Reliefweb MCP Server — questions

Answers built from our own checks of this server.

What can Reliefweb MCP Server do?

It exposes 11 tools, read directly from the server on our last check. Among them: reliefweb_get_country, reliefweb_get_disaster, reliefweb_get_job, reliefweb_get_report, reliefweb_get_training, reliefweb_list_countries and 5 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 92 of 92 checks got a reply (100.0%), average response time 332 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 11 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 332 ms on average, which is faster than 46% 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 73 times in the last week. Week over week that is +108%. 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 and 1 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.