@cyanheads/reliefweb-mcp-server

v0.1.5 pre-1.0

Search ReliefWeb humanitarian reports, disasters, jobs, training, and country profiles via MCP. STDIO or Streamable HTTP.

@cyanheads/reliefweb-mcp-server
claude mcp add --transport http reliefweb-mcp-server https://reliefweb.caseyjhand.com/mcp
codex mcp add reliefweb-mcp-server --url https://reliefweb.caseyjhand.com/mcp
{
  "mcpServers": {
    "reliefweb-mcp-server": {
      "url": "https://reliefweb.caseyjhand.com/mcp"
    }
  }
}
gemini mcp add --transport http reliefweb-mcp-server https://reliefweb.caseyjhand.com/mcp
{
  "mcpServers": {
    "reliefweb-mcp-server": {
      "command": "bunx",
      "args": [
        "@cyanheads/reliefweb-mcp-server@latest"
      ]
    }
  }
}
{
  "mcpServers": {
    "reliefweb-mcp-server": {
      "type": "http",
      "url": "https://reliefweb.caseyjhand.com/mcp"
    }
  }
}
curl -X POST https://reliefweb.caseyjhand.com/mcp \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'

Tools

9

reliefweb_search_reports

open-world

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 document content is needed. Use preset include_archived=true to include expired or archived reports in historical research. Note: each call counts against the 1,000 calls/day quota.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reliefweb_search_reports",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "text": {
      "description": "Full-text search query. Matches against title, body, and key metadata fields. Use plain natural language or keywords.",
      "type": "string"
    },
    "country": {
      "description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to content tagged with this country.",
      "type": "string"
    },
    "disaster_id": {
      "description": "ReliefWeb numeric disaster ID. Filters to reports linked to a specific disaster. Get the ID from reliefweb_search_disasters.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "format": {
      "description": "Content format filter. Valid values: Situation Report, Assessment, Analysis, Map, Infographic, Manual and Guideline, News and Press Release, Policy Document, Appeal, Financial Report, Evaluation and Lessons Learned, Other.",
      "type": "string"
    },
    "theme": {
      "description": "Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Shelter and NFI, Protection). Matches theme.name.",
      "type": "string"
    },
    "language": {
      "description": "ISO 639-1 language code (e.g., en, fr, es, ar). Filters on language.code.",
      "type": "string"
    },
    "source": {
      "description": "Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname.",
      "type": "string"
    },
    "date_from": {
      "description": "Earliest publication date (ISO 8601, e.g., 2024-01-15T00:00:00+00:00). Filters on date.original (source publication date).",
      "type": "string"
    },
    "date_to": {
      "description": "Latest publication date (ISO 8601). Pair with date_from for a date range.",
      "type": "string"
    },
    "sort": {
      "description": "Sort order. Use date.original:desc for newest first (default), date.original:asc for oldest first, score:desc for relevance.",
      "type": "string"
    },
    "include_archived": {
      "description": "Include archived and to-review content in addition to published. Uses preset=analysis. Off by default.",
      "type": "boolean"
    },
    "filter": {
      "description": "Raw ReliefWeb filter object for compound conditions not covered by named params. Example: {\"operator\": \"AND\", \"conditions\": [{\"field\": \"format.name\", \"value\": \"Map\"}, {\"field\": \"language.code\", \"value\": \"fr\"}]}.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "limit": {
      "default": 10,
      "description": "Number of results to return (1–1000, default 10). Use a smaller value for targeted lookups; larger for bulk research. Each call counts against the 1,000-calls/day quota.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset for pagination. Use with limit and totalCount from the response to page through large result sets.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

reliefweb_get_report

open-world

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; call this only when you need the full document text.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reliefweb_get_report",
    "arguments": {
      "id": "<id>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "ReliefWeb numeric report ID. Obtained from reliefweb_search_reports results."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}
view source ↗

reliefweb_search_disasters

open-world

Search active and historical disasters on ReliefWeb by type, country, status, date range, and GLIDE number. Default preset covers alert, current, and past disasters. Use include_archived=true to include alert-archive and archive entries for historical research. Returns IDs suitable for use with reliefweb_get_disaster and as disaster_id filter in reliefweb_search_reports.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reliefweb_search_disasters",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "text": {
      "description": "Full-text search query. Matches against disaster name and description.",
      "type": "string"
    },
    "country": {
      "description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to disasters tagged with this primary country.",
      "type": "string"
    },
    "disaster_type": {
      "description": "Disaster type name (e.g., Earthquake, Flood, Drought, Cyclone). Filters on type.name.",
      "type": "string"
    },
    "status": {
      "description": "Disaster status filter. Values: alert (newly declared), current (ongoing), past (resolved), alert-archive, archive. Separate multiple values with commas. Default preset includes alert, current, past.",
      "type": "string"
    },
    "glide": {
      "description": "GLIDE number (global disaster identifier, e.g., EQ-2023-000053-TUR). Use for cross-system disaster correlation.",
      "type": "string"
    },
    "date_from": {
      "description": "Earliest disaster creation date (ISO 8601). Filters on date.created.",
      "type": "string"
    },
    "date_to": {
      "description": "Latest disaster creation date (ISO 8601). Pair with date_from for a date range.",
      "type": "string"
    },
    "sort": {
      "description": "Sort order. Use date.created:desc for newest first (default), date.created:asc for oldest, score:desc for relevance.",
      "type": "string"
    },
    "include_archived": {
      "description": "Include alert-archive and archive disasters in results. Uses preset=analysis. Off by default.",
      "type": "boolean"
    },
    "limit": {
      "default": 10,
      "description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset for pagination. Use with limit and totalCount to page through results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

reliefweb_get_disaster

open-world

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reliefweb_get_disaster",
    "arguments": {
      "id": "<id>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "ReliefWeb numeric disaster ID. Obtained from reliefweb_search_disasters results."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}
view source ↗

reliefweb_get_country

open-world

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 for humanitarian responders.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reliefweb_get_country",
    "arguments": {
      "iso3": "<iso3>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "iso3": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3,
      "description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Used to look up the country's ReliefWeb profile."
    }
  },
  "required": [
    "iso3"
  ],
  "additionalProperties": false
}
view source ↗

reliefweb_list_countries

open-world

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 with active humanitarian situations.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reliefweb_list_countries",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "crisis_only": {
      "description": "When true, filters to countries with an active humanitarian situation (status alert or current). Default false returns all countries.",
      "type": "boolean"
    },
    "limit": {
      "default": 100,
      "description": "Number of results to return (1–1000, default 100). Each call counts against the 1,000-calls/day quota.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset for pagination. Use with limit and totalCount to page through results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

reliefweb_search_jobs

open-world

Search humanitarian job listings on ReliefWeb by country, organization, career category, theme, and experience level. Returns current open positions — archived or expired jobs are excluded by default. Use text search for role titles and job descriptions.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reliefweb_search_jobs",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "text": {
      "description": "Full-text search query. Matches against job title, body, and key metadata fields.",
      "type": "string"
    },
    "country": {
      "description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to jobs tagged with this country.",
      "type": "string"
    },
    "source": {
      "description": "Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname.",
      "type": "string"
    },
    "career_category": {
      "description": "Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology, Logistics and Telecommunications). Filters on career_categories.name.",
      "type": "string"
    },
    "theme": {
      "description": "Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Protection). Filters on theme.name.",
      "type": "string"
    },
    "experience": {
      "description": "Experience level (e.g., 0-2 years, 3-4 years, 5-9 years). Filters on experience.name.",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset for pagination. Use with limit and totalCount to page through results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

reliefweb_search_training

open-world

Search humanitarian training and learning opportunities on ReliefWeb by country, format, date, source, career category, and language. Covers workshops, e-learning, conferences, and other capacity-building events. Training date fields use date.start / date.end — different from report date fields. Use date_start_from and date_start_to to find upcoming training within a window.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reliefweb_search_training",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "text": {
      "description": "Full-text search query. Matches against training title and description.",
      "type": "string"
    },
    "country": {
      "description": "ISO 3166-1 alpha-3 country code (e.g., KEN, ETH, COD). Filters to training tagged with this country.",
      "type": "string"
    },
    "source": {
      "description": "Organization short name. Filters on source.shortname.",
      "type": "string"
    },
    "format": {
      "description": "Training format (e.g., Workshop, E-learning, Conference, Seminar). Filters on format.name.",
      "type": "string"
    },
    "career_category": {
      "description": "Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology). Filters on career_categories.name.",
      "type": "string"
    },
    "language": {
      "description": "ISO 639-1 language code (e.g., en, fr, es). Filters on language.code.",
      "type": "string"
    },
    "date_start_from": {
      "description": "Training start date lower bound (ISO 8601). Filters on date.start — use to find training starting after a given date.",
      "type": "string"
    },
    "date_start_to": {
      "description": "Training start date upper bound (ISO 8601). Filters on date.start — pair with date_start_from for a window.",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset for pagination. Use with limit and totalCount to page through results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

reliefweb_list_sources

open-world

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_training.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reliefweb_list_sources",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "text": {
      "description": "Full-text search query. Matches against organization name and short name.",
      "type": "string"
    },
    "type": {
      "description": "Organization type (e.g., Government, International Organization, NGO, Academia). Filters on type.name.",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset for pagination. Use with limit and totalCount to page through results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

Resources

3

Full report record by ReliefWeb numeric ID — metadata, body text, and file URLs. Equivalent to calling reliefweb_get_report.

uri reliefweb://reports/{id} mime application/json

Disaster record by ReliefWeb numeric ID — type, status, affected countries, GLIDE number, description, and curated content links. Equivalent to calling reliefweb_get_disaster.

uri reliefweb://disasters/{id} mime application/json

Country profile by ISO3 code — overview, humanitarian situation summary, key content links, and active response plans. Equivalent to calling reliefweb_get_country.

uri reliefweb://countries/{iso3} mime application/json

Prompts

1

Generate a structured humanitarian briefing for a country or disaster. Instructs the agent to use available ReliefWeb tools to gather recent reports, active disasters, open positions, and training opportunities, then synthesize a concise situation overview. Specify focus=situation for a situation-only brief, focus=jobs for open positions, or focus=full for the complete briefing.

  • country_or_disasterrequired — Country name or ISO3 code (e.g., "Afghanistan" or "AFG"), or a disaster name/GLIDE number (e.g., "Syria earthquake" or "EQ-2023-000053-TUR").
  • focus — Briefing scope. situation = situation overview and recent reports only. jobs = open positions and training only. full = complete briefing including situation, reports, disasters, jobs, and training (default).