Reliefweb MCP Server

Name: Reliefweb MCP Server
Author: cyanheads

by cyanheadsversion 0.3.0i★ –iComputer or cloud

Registry nameio.github.cyanheads/reliefweb-mcp-server

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi3 of 3 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Computer or cloud
Transport: stdio, Streamable HTTP
Category: Search & AI memory
You need to fill in: RELIEFWEB_APP_NAME

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 3 of 3 passed
Runs on the maker’s server: what you ask it goes through their server.
Can do 11 things (tools) reliefweb_search_reports, reliefweb_get_report, reliefweb_search_disasters, reliefweb_get_disaster …
You fill in yourself: RELIEFWEB_APP_NAME, RELIEFWEB_CLAMP_LIMITS, MCP_LOG_LEVEL

You need

Runs in the cloudNothing to install; it connects over the internet
npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

Open Settings → Connectors
Press Add custom connector
Paste the address below and press Add
If it asks you to sign in, sign in with the maker

https://reliefweb.caseyjhand.com/mcp

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "reliefweb": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/reliefweb-mcp-server"
      ],
      "env": {
        "RELIEFWEB_APP_NAME": "your-value",
        "RELIEFWEB_CLAMP_LIMITS": "your-value",
        "MCP_LOG_LEVEL": "your-value"
      }
    }
  }
}

Run this in your terminal

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

Or run it on your computer

claude mcp add reliefweb --env RELIEFWEB_APP_NAME=your-value --env RELIEFWEB_CLAMP_LIMITS=your-value --env MCP_LOG_LEVEL=your-value -- npx -y @cyanheads/reliefweb-mcp-server

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

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

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "reliefweb": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/reliefweb-mcp-server"
      ],
      "env": {
        "RELIEFWEB_APP_NAME": "your-value",
        "RELIEFWEB_CLAMP_LIMITS": "your-value",
        "MCP_LOG_LEVEL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "reliefweb": {
      "type": "http",
      "url": "https://reliefweb.caseyjhand.com/mcp"
    }
  }
}

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "reliefweb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/reliefweb-mcp-server"
      ],
      "env": {
        "RELIEFWEB_APP_NAME": "your-value",
        "RELIEFWEB_CLAMP_LIMITS": "your-value",
        "MCP_LOG_LEVEL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

Open ChatGPT on the web → Settings → Connectors (Apps)
Press Create or Add (some plans need Developer mode under Advanced first)
Paste the address below, give it a name and save
If it asks you to sign in, sign in with the maker

https://reliefweb.caseyjhand.com/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

RELIEFWEB_APP_NAME required env
Pre-approved appname for the ReliefWeb API v2. Required since November 2025.
RELIEFWEB_CLAMP_LIMITS env
Clamp over-cap page limits with a notice; false restores strict schema maxima.
MCP_LOG_LEVEL env
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.

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 docu
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
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 fo
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
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 f
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
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 t
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. R
reliefweb_search_training
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 fr
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
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_t

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account cyanheads, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
✓ Pass
Endpoint responds
Responded in 200 ms (HTTP 200)
– Not applicable
Sign-in with OAuth
No sign-in needed
✓ Pass
No hidden instructions in tool descriptions
Read 11 tool descriptions and found no hidden instructions to the AI

Compared with others in Search & AI memoryi

More stars than 0% of the other 5666 servers in this category
Published to the registry more recently than 75% of the other 5666 servers in this category
Basic checks equal to or better than 100% of the other 5666 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Reliefweb MCP Server safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: RELIEFWEB_APP_NAME

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.3.0) reached the registry 12 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Context7, Codebase Memory, Exa

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Context7

by upstash

Feeds AI the latest docs for libraries and frameworks before it answers, so code it writes does not use outdated, removed functions.

Computer or cloud★ 64,224MITUpdated yesterday

Install

Codebase Memory

by DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

Runs on your computer★ 48,148MITUpdated 21 days ago

Install

Exa

by exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

Runs in the cloud★ 5,213MITUpdated 2 months ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

@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

Tool	Description
`reliefweb_search_reports`	Search humanitarian reports with filtering by country, disaster, format, theme, language, source, and date
`reliefweb_get_report`	Fetch a single report by numeric ID with full body text and metadata
`reliefweb_search_disasters`	Search disasters by type, country, status, GLIDE number, and date range
`reliefweb_get_disaster`	Fetch a disaster record with profile, key content links, appeals, and response plans
`reliefweb_get_country`	Fetch a country profile by ISO3 code with overview, appeals, and curated links
`reliefweb_list_countries`	List all countries tracked by ReliefWeb, filterable to active humanitarian situations
`reliefweb_search_jobs`	Search humanitarian job listings by country, organization, career category, and experience level
`reliefweb_get_job`	Fetch a job posting by numeric ID with the full vacancy description and application instructions
`reliefweb_search_training`	Search training by format, country, career category, cost, listing or delivery language, and date — upcoming starts by default
`reliefweb_get_training`	Fetch a training listing by numeric ID with the full description, registration instructions, and cost detail
`reliefweb_list_sources`	Browse contributing organizations by name and type

Resources

Resource	Description
`reliefweb://reports/{id}`	Full report record by numeric ID — metadata, body text, and file URLs. The ID segment must be digits only
`reliefweb://disasters/{id}`	Disaster record by numeric ID — type, status, GLIDE, description, and content links. The ID segment must be digits only
`reliefweb://countries/{iso3}`	Country profile by ISO3 code — overview, situation summary, and active response plans

Prompts

Prompt	Description
`reliefweb_crisis_briefing`	Generate a structured humanitarian briefing for a country or disaster

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

Only the beginning is shown; read the rest in the repo

Reliefweb MCP Server

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Or run it on your computer

Or run it on your computer

Or run it on your computer

Or run it on your computer

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Search & AI memoryi

Common questions

Alternatives

Context7

Codebase Memory

Exa

README from the maker

Overview

Tools

Resources

Prompts

Capability reference

reliefweb_search_reports tool

reliefweb_get_report tool

reliefweb_search_disasters tool

reliefweb_get_disaster tool

reliefweb_get_country tool

reliefweb_list_countries tool

reliefweb_search_jobs tool

reliefweb_get_job tool

reliefweb_search_training tool

reliefweb_get_training tool

reliefweb_list_sources tool

reliefweb://reports/{id} resource

`reliefweb_search_reports` tool

`reliefweb_get_report` tool

`reliefweb_search_disasters` tool

`reliefweb_get_disaster` tool

`reliefweb_get_country` tool

`reliefweb_list_countries` tool

`reliefweb_search_jobs` tool

`reliefweb_get_job` tool

`reliefweb_search_training` tool

`reliefweb_get_training` tool

`reliefweb_list_sources` tool

`reliefweb://reports/{id}` resource