# ReliefWeb MCP > ReliefWeb MCP Server connects your AI client to the world's largest humanitarian database. It lets you search disaster reports, job postings, and organizational data from global sources like the UN and NGOs. You can filter reports by country, theme (Health, Food, Shelter), or specific format—all using natural conversation. No API key is needed. ## Overview - **Category:** knowledge-management - **Price:** Free - **Tags:** humanitarian-aid, disaster-relief, crisis-data, global-reports, public-data ## Description The `get_reports` tool lets your AI client search and pull summaries of humanitarian reports using filters for date, country, theme, or source. You can use `get_themes` to narrow down searches by topic category like Health or Shelter. You'll also find the `get_formats` tool, letting you restrict results to specific document types such as Situation Reports or Maps. To pinpoint exactly where a crisis is hitting, your agent runs `get_countries`, which returns country names, ISO codes, and how many disaster counts are tied to that location. If you need to understand the full scope of a situation, the `get_sources` tool lists every source name and type, showing you exactly where a specific report originated. When you're looking for reports on a particular event, running `get_disasters` retrieves a list of tracked disasters—like earthquakes or floods—and shows which countries were affected. To deep-dive into one specific piece of information, the `get_report` tool grabs all the metadata for that single report if you know its unique ID. You can also use `get_organizations` to pull a list of publishing bodies—NGOs, UN agencies, or government groups—and see how many reports each organization has put out. Finding job openings in aid work is simple; the `get_jobs` tool searches for active humanitarian postings, providing details on both the hiring organization and the location. You can also get a clear picture of who's publishing data overall by using `get_organizations` to list all the major players involved. It’s really straightforward: your AI client just talks to ReliefWeb. It pulls global information that covers everything from assessing damage after a flood or an earthquake, to finding job openings with international groups. The system tracks crises and locations through structured data retrieval for you. You'll find summaries of reports by querying filters for country, disaster type, theme, and source name. Your agent can also get the full list of available topics using `get_themes`, making it easy to restrict searches to specific subject matter like Food or Water Security. It’s a massive database, so knowing how to filter is everything. ## Tools ### get_countries Returns country names, ISO codes, and associated disaster counts for location filtering. ### get_disasters Retrieves a list of tracked disasters, including types (earthquake, flood) and affected countries. ### get_formats Lists report formats like Situation Report or Map to filter reports by document type. ### get_jobs Searches for humanitarian job postings, providing details on organization and location. ### get_organizations Retrieves names of publishing organizations (NGOs, UN) and how many reports they have published. ### get_report Gets the full metadata for one specific report if you know its unique ID. ### get_reports Searches and retrieves summaries of humanitarian reports using filters like date, theme, or country. ### get_sources Lists the source names and types to understand where a specific report originated. ### get_themes Returns topic categories (Health, Shelter) that can be used to filter reports by subject matter. ## Prompt Examples **Prompt:** ``` Find situation reports about earthquakes in Turkey. ``` **Response:** ``` Found 45+ reports about earthquakes in Turkey. Recent situation reports from UN OCHA, IFRC and local organizations include damage assessments, casualty figures and humanitarian response updates. ``` **Prompt:** ``` What disasters are currently active? ``` **Response:** ``` Currently tracked disasters: Cyclone Freddy (Mozambique/Malawi, orange alert), Earthquake M6.8 (Japan), Floods (Kenya), Drought (Horn of Africa). Each with affected population estimates and response status. ``` **Prompt:** ``` Show me humanitarian job postings in South Sudan. ``` **Response:** ``` Found 12 humanitarian jobs in South Sudan: WASH Coordinator (Save the Children), Health Manager (MSF), Protection Officer (UNHCR), Logistics Coordinator (WFP). All with application deadlines and organization details. ``` ## Capabilities ### Search all humanitarian reports Find specific situation updates or assessments by querying filters for country, disaster type, theme, and source. ### Identify active crises and locations Retrieve a list of tracked disasters (earthquakes, floods, etc.), including the affected countries and general dates. ### Find job openings in aid work Search for available humanitarian job postings across various organizations and locations. ### Filter data by subject or format Restrict searches to specific report topics (like Health or Food) or document types (like Situation Report or Map). ### Map out organizational presence Get a list of UN agencies, NGOs, and government bodies that publish data in the system. ## Use Cases ### Assessing a recent earthquake's impact. The field worker needs to know the damage scope. They ask their agent: 'Find all reports on earthquakes in Nepal from 2015 and 2023.' The agent uses `get_disasters` first, then runs `get_reports`, filtering by date and disaster type. This gives them a quick overview of historical responses. ### Staffing an emergency deployment. A coordinator needs to fill several roles quickly. They ask the agent to 'Show me protection officer jobs in Kenya.' The agent uses `get_jobs`, filtering by role and location, providing immediate links and deadlines. ### Writing a cross-sectoral article. A journalist needs context on multiple issues. They ask the agent to 'Gather reports covering both food security and shelter in Ethiopia.' The agent uses `get_themes` to confirm the IDs, then runs `get_reports` twice (once for each theme) to compile a comprehensive draft. ### Building an organizational map. A researcher wants to see who is active in a region. They ask: 'Which UN agencies and NGOs have published reports on clean water?' The agent uses `get_organizations` first, then runs `get_reports`, filtering by topic (Health/Water) to build the list. ## Benefits - Find the right report fast. Instead of browsing through hundreds of PDFs, you ask your agent to use `get_reports` with filters for 'country: Sudan' and 'theme: Health'. You get a curated list immediately. - Track crises across time. Use `get_disasters` first to see what disasters are active or recently occurred in a region. Then, you run `get_reports` to find the official assessments on those events. - Keep your team staffed. The `get_jobs` tool lets you search for specific roles (e.g., 'WASH Coordinator') across multiple NGOs worldwide without leaving your chat window. - Understand data depth. If a report is vague, use `get_sources` to confirm who published it and check how many total reports that organization has filed via `get_organizations`. - Filter complex data sets. You don't just search by keyword; you narrow the results using `get_themes` (e.g., 'Protection') or `get_formats` (e.g., 'Assessment'). ## How It Works The bottom line is you get direct access to global, filtered humanitarian data without manually navigating multiple websites or building complex API calls. 1. Subscribe to this server and connect your AI client. No API keys are needed for setup. 2. Ask your agent a natural language question (e.g., 'Show me health reports from Yemen'). 3. The system runs the necessary tools, compiles the data, and returns structured results. ## Frequently Asked Questions **How do I use get_reports to filter for a specific disaster?** You include 'disaster' in your prompt, or you can first run `get_disasters` to confirm the exact name (e.g., 'Cyclones'). Then, ask the agent to search reports using that specific event name. **Do I need an API key for get_jobs?** No. You don't need any keys. Just connect your AI client and ask the agent to find jobs; it handles the connection through the MCP standard. **What is the best way to use get_themes?** Use `get_themes` first to see all available topics (like Food, Protection, Health). Then, include that theme name in your search query for `get_reports`. **Can I find reports about a specific organization using get_organizations?** Yes. You can use `get_organizations` to check the full list of publishing bodies and see how many reports each one has submitted, giving you an idea of their activity level. **How do I use get_countries to get an ID for filtering with get_reports?** You must run get_countries first. This tool returns a list of all country names and their corresponding ISO codes, which you need to pass into get_reports to filter results accurately. **What specific data points can I retrieve using the get_report command?** get_report pulls full metadata for one document. You get the title, body content, source, associated themes, countries, disasters, and any attached files all in one call. **If I need to filter reports by type, how do I check valid formats using get_formats?** Run get_formats. It lists every available report format—like Situation Report or Assessment—along with their unique IDs. Use these IDs in subsequent searches for precise filtering. **Does get_disasters list all possible disaster types, or just currently tracked ones?** get_disasters returns the names and categories of disasters (e.g., earthquake, flood, cyclone). This gives you the full vocabulary needed to search for reports across any type. **Do I need an API key?** No! ReliefWeb's API is completely free and open. No authentication required. Just subscribe and start searching. Data is updated continuously. **What kind of reports are available?** ReliefWeb hosts 300,000+ reports including situation reports, assessments, press releases, maps, infographics and evaluations from UN agencies, NGOs, governments and research organizations. **Can I search reports by country?** Yes! Use get_reports with the country parameter to filter reports by country name. You can also filter by disaster type, theme, format, date range and organization simultaneously.