`reliefweb_reports`

Pack: reliefweb · Endpoint: https://gateway.pipeworx.io/reliefweb/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/reliefweb_reports for the schema, then POST the same URL with its arguments for the data.

Humanitarian situation reports, needs assessments, appeals, analyses and press releases published on ReliefWeb by ~4,000 UN agencies, NGOs, governments and research bodies. AUTHORITATIVE for “what do humanitarian responders say is happening in ” — this is UN OCHA’s own corpus, not news coverage of it. Filter by country, disaster, disaster type, publishing organisation, theme, document format and publication date, or free-text search the title and body. Returns title, publishing source, primary country, disaster, format, publication date and the ReliefWeb URL. Requires a caller-supplied ReliefWeb appname in _apiKey.

Parameters

Name	Type	Required	Description
`query`	string	no	Free-text search over title and body, e.g. “cholera outbreak”, “cash assistance”.
`country`	string	no	Country name or ISO3 code, e.g. “Sudan” or “SDN”.
`disaster_type`	string	no	Disaster type name, e.g. “Flood”, “Earthquake”, “Drought”, “Epidemic”, “Tropical Cyclone”.
`source`	string	no	Publishing organisation name or shortname, e.g. “OCHA”, “WFP”, “UNHCR”.
`theme`	string	no	Humanitarian theme, e.g. “Food and Nutrition”, “Health”, “Protection and Human Rights”, “Shelter and Non-Food Items”.
`format`	string	no	Document format, e.g. “Situation Report”, “Assessment”, “Appeal”, “Analysis”, “News and Press Release”, “Map”.
`from_date`	string	no	Only reports published on or after this date, YYYY-MM-DD, e.g. “2026-08-01”.
`to_date`	string	no	Only reports published on or before this date, YYYY-MM-DD.
`include_body`	boolean	no	Include a text excerpt of each report body (default false — bodies are long and most callers want the list first).
`limit`	number	no	Max reports to return (default 10, max 100).
`offset`	number	no	Skip this many results, for paging (default 0).

Example call

Arguments

{
  "_apiKey": "your-reliefweb-appname",
  "country": "Sudan",
  "format": "Situation Report",
  "limit": 10
}

curl

curl -X POST https://gateway.pipeworx.io/reliefweb/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reliefweb_reports","arguments":{"_apiKey":"your-reliefweb-appname","country":"Sudan","format":"Situation Report","limit":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('reliefweb_reports', {
  "_apiKey": "your-reliefweb-appname",
  "country": "Sudan",
  "format": "Situation Report",
  "limit": 10
});

More examples

{
  "_apiKey": "your-reliefweb-appname",
  "query": "cholera outbreak",
  "from_date": "2026-06-01",
  "limit": 10
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "reliefweb": {
      "url": "https://gateway.pipeworx.io/reliefweb/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

reliefweb_reports