Reliefweb MCP Server
by cyanheadsio.github.cyanheads/reliefweb-mcp-serverv0.2.2
Search ReliefWeb humanitarian reports, disasters, jobs, training, and country profiles via MCP.
context tax
queued
security
queued
cold start
queued
freshness
Active19d ago
Install Reliefweb MCP server
Install in Claude Code
claude mcp add reliefweb -e RELIEFWEB_APP_NAME='<reliefweb-app-name>' -- npx -y @cyanheads/reliefweb-mcp-server run start:stdioInstall in Cursor
{
"mcpServers": {
"reliefweb": {
"command": "npx",
"args": [
"-y",
"@cyanheads/reliefweb-mcp-server",
"run",
"start:stdio"
],
"env": {
"RELIEFWEB_APP_NAME": "<reliefweb-app-name>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"reliefweb": {
"command": "npx",
"args": [
"-y",
"@cyanheads/reliefweb-mcp-server",
"run",
"start:stdio"
],
"env": {
"RELIEFWEB_APP_NAME": "<reliefweb-app-name>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"reliefweb": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/reliefweb-mcp-server",
"run",
"start:stdio"
],
"env": {
"RELIEFWEB_APP_NAME": "<reliefweb-app-name>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"reliefweb": {
"command": "npx",
"args": [
"-y",
"@cyanheads/reliefweb-mcp-server",
"run",
"start:stdio"
],
"env": {
"RELIEFWEB_APP_NAME": "<reliefweb-app-name>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| RELIEFWEB_APP_NAME | yes | — | Pre-approved appname for the ReliefWeb API v2. Required since November 2025. |
| MCP_LOG_LEVEL | — | — | Sets the minimum log level for output (e.g., 'debug', 'info', 'warn'). |
| 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'. |
Remote endpoints
- streamable-http
https://reliefweb.caseyjhand.com/mcp
Freshness
Active — last maintenance signal 19d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-20 · 19d ago · GitHub
Latest release
2026-09-20 · 19d ago · GitHub · v0.2.2
Package published
no data · npm/PyPI
Registry entry updated
2026-09-20 · 19d ago · official registry · v0.2.2
FAQ
›How do I install the Reliefweb MCP server in Claude Code?
Run: claude mcp add reliefweb -e RELIEFWEB_APP_NAME='<reliefweb-app-name>' -- npx -y @cyanheads/reliefweb-mcp-server run start:stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Reliefweb require an API key?
Yes. It expects RELIEFWEB_APP_NAME.
›Can I use Reliefweb as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is Reliefweb in the official MCP registry?
Yes, as io.github.cyanheads/reliefweb-mcp-server.