UNHCR Population Data MCP Server

# UNHCR Population Data MCP Server This MCP (Model Context Protocol) server in smithery.ai provides access to UNHCR data through a standardized interface. It allows AI agents to query data related to forcibly displaced persons, including population statistics, demographics, Refugee Status Determination (RSD) applications & decisions and durable solutions, including resettlement, returnees, naturalisation etc. The data can be filtered by country of origin, country of asylum, and year(s). This server interacts with the [UNHCR Population Statistics APIs](https://api.unhcr.org/). ## Features - Query forcibly displaced population data. - Query forcibly displaced demographics data. - Query Refugee Status Determination (RSD) application data. - Query Refugee Status Determination (RSD) decision data. - Query Durable Solutions including, resettlements, returned refugee, returned IDPs etc. - Filter data by country of origin (ISO3 code), country of asylum (ISO3 code), and year(s). - Option to break down results by all countries of origin and countries of asylum ## Connect to MCP Server To access the server, open your web browser and visit the following URL: [https://smithery.ai/server/@rvibek/mcp_unhcr](https://smithery.ai/server/@rvibek/mcp_unhcr) Configure the MCP host/client as needed. [](https://smithery.ai/server/@rvibek/mcp_unhcr) ## API Endpoints and Query Parameters The server fetches data from the following base URL: `https://api.unhcr.org/population/v1/` using these specific endpoints: - `population/` - `demographics/` - `asylum-applications/` - `asylum-decisions/` - `solutions/` Key query parameters used by the server when calling the UNHCR API: - `cf_type`: Always set to "ISO". - `coo`: Country of origin filter (ISO3 code, comma-separated for multiple). - `coa`: Country of asylum filter (ISO3 code, comma-separated for multiple). - `year[]`: Year(s) to filter by (e.g., "2023" or ["2022", "2023"]). Defaults to "2024" if not provided. - `coo_all`: Set to "true" if results should be broken down by all countries of origin. - `coa_all`: Set to "true" if results should be broken down by all countries of asylum. - `pop_type`: Set to "true" if demographics should be broken down by all population types ## MCP Tools The server exposes the following tools: ### `get_population_data` Get forcibly displaced populations from UNHCR. **Parameters:** - `coo` (optional): Country of origin filter (ISO3 code, comma-separated for multiple). - `coa` (optional): Country of asylum filter (ISO3 code, comma-separated for multiple). - `year` (optional): Year filter (comma-separated for multiple years, or a single year). - `coo_all` (optional, boolean): If `True`, break down results by all countries of origin. Defaults to `False`. - `coa_all` (optional, boolean): If `True`, break down results by all countries of asylum. Defaults to `False`. ### `get_demographics_data` Get forcibly displaced demographics disaggregated by age and sex from UNHCR. **Parameters:** - `coo` (optional): Country of origin filter (ISO3 code, comma-separated for multiple). - `coa` (optional): Country of asylum filter (ISO3 code, comma-separated for multiple). - `year` (optional): Year filter (comma-separated for multiple years, or a single year). - `coo_all` (optional, boolean): If `True`, break down results by all countries of origin. Defaults to `False`. - `coa_all` (optional, boolean): If `True`, break down results by all countries of asylum. Defaults to `False`. - `pop_type` (optional, boolean): If `True`, break down results by population types e.g., refugees, asylum seekers, stateless Defaults to `False`. ### `get_rsd_applications` Get RSD application data from UNHCR. **Parameters:** - `coo` (optional): Country of origin filter (ISO3 code, comma-separated for multiple). - `coa` (optional): Country of asylum filter (ISO3 code, comma-separated for multiple). - `year` (optional): Year filter (comma-separated for multiple years, or a single year). - `coo_all` (optional, boolean): If `True`, break down results by all countries of origin. Defaults to `False`. - `coa_all` (optional, boolean): If `True`, break down results by all countries of asylum. Defaults to `False`. ### `get_rsd_decisions` Get RSD decision data from UNHCR. **Parameters:** - `coo` (optional): Country of origin filter (ISO3 code, comma-separated for multiple). - `coa` (optional): Country of asylum filter (ISO3 code, comma-separated for multiple). - `year` (optional): Year filter (comma-separated for multiple years, or a single year). - `coo_all` (optional, boolean): If `True`, break down results by all countries of origin. Defaults to `False`. - `coa_all` (optional, boolean): If `True`, break down results by all countries of asylum. Defaults to `False`. ### `get_solutions` Get durable solutions decision data from UNHCR which includes refugee returnees (returned_refugees), resettlement, naturalisation, retuned IDPs (returned_idps) **Parameters:** - `coo` (optional): Country of origin filter (ISO3 code, comma-separated for multiple). - `coa` (optional): Country of asylum filter (ISO3 code, comma-separated for multiple). - `year` (optional): Year filter (comma-separated for multiple years, or a single year). - `coo_all` (optional, boolean): If `True`, break down results by all countries of origin. Defaults to `False`. - `coa_all` (optional, boolean): If `True`, break down results by all countries of asylum. Defaults to `False`. ## To-do - Add `year_from` and `year_to` parameter - Include `nowcasting` endpoint ## License MIT ## Acknowledgments This project uses data from the [UNHCR Refugee Population Statistics Database](https://www.unhcr.org/refugee-statistics/).