How do I install the reliefweb mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `MCP_TRANSPORT_TYPE`, `MCP_LOG_LEVEL`, `RELIEFWEB_APP_NAME`, `MCP_HTTP_ENDPOINT_PATH`, `MCP_PUBLIC_URL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Reliefweb MCP Server

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

Remote serverstreamable-http

What is the Reliefweb MCP Server?

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

What it actually does

Declarative tool definitions — single file per tool, framework handles registration and validation
Unified error handling across all tools
Pluggable auth (none, jwt, oauth)
Swappable storage backends: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1
Structured logging with optional OpenTelemetry tracing
Runs locally (stdio/HTTP) or on Cloudflare Workers from the same codebase

Configuration

Bun v1.3.2 or higher. - A pre-approved ReliefWeb appname — register at ReliefWeb API and set RELIEFWEB_APP_NAME. The API has required pre-approved appnames since November 2025; requests without one are rejected.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
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_search_training	Search training and learning opportunities by format, country, career category, and date
reliefweb_list_sources	Browse contributing organizations by name and type

How to install the Reliefweb MCP Server

{
  "mcpServers": {
    "reliefweb-mcp-server": {
      "type": "streamable-http",
      "url": "https://reliefweb.caseyjhand.com/mcp"
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Bun v1.3.2 or higher. - A pre-approved ReliefWeb appname — register at ReliefWeb API and set RELIEFWEB_APP_NAME. The API has required pre-approved appnames since November 2025; requests without one are rejected.

Variable	Description	Required
MCP_TRANSPORT_TYPE	Configuration value read at startup.	Optional
MCP_LOG_LEVEL	Configuration value read at startup.	Optional
RELIEFWEB_APP_NAME	Configuration value read at startup.	Optional
MCP_HTTP_ENDPOINT_PATH	Filesystem location the server is allowed to use.	Optional
MCP_PUBLIC_URL	Endpoint or connection string the server talks to.	Yes

Example prompts to try

“Use Reliefweb to reliefweb search reports.”
“Use Reliefweb to reliefweb get report.”
“Use Reliefweb to reliefweb search disasters.”

Frequently asked questions

Search ReliefWeb humanitarian reports, disasters, jobs, training, and country profiles via MCP. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.