# reliefweb-mcp-server

Search ReliefWeb for humanitarian reports, disasters, jobs, and training. Useful when an agent needs crisis information or country profiles.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1304 installs · ★ 3 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/reliefweb-mcp-server
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/reliefweb-mcp-server

## What it does

This server gives an agent access to ReliefWeb content. It can search reports, disasters, job listings, and training, then retrieve detailed records such as a report’s full text or a vacancy’s application instructions. Country profiles and contributing organizations are available too.

Search tools accept filters that vary by content type, including country and date. The `reliefweb_crisis_briefing` prompt creates a structured briefing for a country or disaster. The server supports STDIO and Streamable HTTP; the Claude Code command below connects over HTTP.

Large report bodies may exceed the response budget. In that case, the server returns a section outline, and the body can be fetched separately with `sections: ["body"]`. That matters when the agent needs the complete report text.

## Requirements
- Remote server: `https://reliefweb-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http reliefweb-mcp-server https://reliefweb-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add reliefweb-mcp-server --url https://reliefweb-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "reliefweb-mcp-server": {
            "url": "https://reliefweb-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "reliefweb-mcp-server": {
            "type": "http",
            "url": "https://reliefweb-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http reliefweb-mcp-server https://reliefweb-mcp-server--cyanheads.run.tools
```

## When to use it
- find reports by country, topic, and publication date
- retrieve a disaster record and its related response material
- get a country profile with active response plans
- search humanitarian vacancies by organization and experience level
- find training by format, country, or cost

## Example prompts
- Find ReliefWeb reports for country `ISO3` within the requested date range.
- Retrieve disaster `12345` and summarize its linked response material.
- Create a structured briefing for this country using `reliefweb_crisis_briefing`.

## Similar
- [firecrawl-deep-research](https://affpapa.org/en/nevibecode/skills/firecrawl-deep-research.md) — skill · 36200 installs
- [gws-admin-reports](https://affpapa.org/en/nevibecode/skills/gws-admin-reports.md) — skill · 31700 installs
- [deep-research](https://affpapa.org/en/nevibecode/skills/199-biotechnologies-deep-research.md) — skill · 10500 installs
- [active-research](https://affpapa.org/en/nevibecode/skills/active-research.md) — skill · 3200 installs
- [platform-report-generate](https://affpapa.org/en/nevibecode/skills/platform-report-generate.md) — skill · 3100 installs
- [qa-report-humanizer](https://affpapa.org/en/nevibecode/skills/qa-report-humanizer.md) — skill · 1600 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
