UNHCR Population Data MCP Server

This MCP (Model Context Protocol) server provides access to UNHCR data through a standardized interface. It allows AI agents to query data related to forcibly displaced persons, including population statistics, Refugee Status Determination (RSD) applications, and RSD decisions. The data can be filtered by country of origin, country of asylum, and year(s).

This server interacts with the UNHCR Population Statistics APIs.

Features

• Query forcibly displaced population data.
• Query Refugee Status Determination (RSD) application data.
• Query Refugee Status Determination (RSD) decision data.
• 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

Configure the MCP host/client as needed.

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/
• asylum-applications/
• asylum-decisions/

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.

MCP Tools

The server exposes the following tools:

get_population_data

Get population 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). Defaults to 2024 if not provided.
• 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_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). Defaults to 2024 if not provided.
• 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). Defaults to 2024 if not provided.
• 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
• Include resettlement endpoint

License

MIT

Acknowledgments

This project uses data from the UNHCR Refugee Population Statistics Database.

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!