Skip to main content
Glama

UNHCR Population Data MCP Server

by rvibek

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.

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides access to UNHCR refugee statistics through a standardized interface, allowing AI agents to query data by country of origin, country of asylum, and year.

  1. Features
    1. Connect to MCP Server
      1. API Endpoints and Query Parameters
        1. MCP Tools
          1. get_population_data
          2. get_rsd_applications
          3. get_rsd_decisions
        2. To-do
          1. License
            1. Acknowledgments

              Related MCP Servers

              • A
                security
                F
                license
                A
                quality
                Provides access to the Australian Bureau of Statistics (ABS) Data API. This server allows AI assistants to query and analyze ABS statistical data.
                Last updated -
                1
                4
                TypeScript
              • A
                security
                A
                license
                A
                quality
                Enables AI assistants to access protein information directly from UniProt, allowing retrieval of protein names, functions, sequences, and organism data by accession number.
                Last updated -
                2
                8
                Python
                MIT License
                • Apple
                • Linux
              • A
                security
                F
                license
                A
                quality
                Enables AI assistants to interact with the World Bank open data API, allowing for listing and analysis of indicators across available countries.
                Last updated -
                1
                34
                Python
              • -
                security
                F
                license
                -
                quality
                Allows AI models to query and retrieve analytics data from Plausible Analytics through the Plausible API, enabling natural language interactions with website statistics.
                Last updated -
                TypeScript

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/rvibek/mcp_unhcr'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server