unhcr-refugees-mcp-server
Server Details
Query UNHCR refugee, IDP, and stateless populations, asylum decisions, returns, and resettlement.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- cyanheads/unhcr-refugees-mcp-server
- GitHub Stars
- 1
- Server Listing
- @cyanheads/unhcr-refugees-mcp-server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 8 tools
Each get_* tool targets a distinct dataset (applications, decisions, population stocks, demographics, solutions), and the descriptions explicitly cross-reference the risky pairs (population vs. demographics, applications vs. decisions) to steer selection. The dataframe_describe/query and list_reference tools are also clearly separated, leaving only mild residual overlap between population stocks and demographic stocks.
All names share a consistent unhcr_ prefix and a predictable structure, with six tools using the verb_noun form (get_*, list_reference). The two dataframe tools invert to noun_verb (dataframe_describe, dataframe_query), a minor deviation that is still readable and grouped sensibly.
Eight tools is well-scoped for a data-access server: five dataset retrievers, one reference decoder, and two dataframe inspection/query tools. Every tool has a clear role and none appears redundant.
The surface covers the core UNHCR data lifecycle: discovery (list_reference), retrieval across all major series, and post-processing via staged-dataframe describe/query with result registration. Minor gaps exist around export/visualization or explicit metadata/status endpoints, but agents can work around them through SQL on staged frames.
Available Tools
8 toolsunhcr_dataframe_describeDescribe staged dataframesARead-onlyIdempotentInspect
Describe a dataframe (df_XXXXX_XXXXX) staged by the unhcr_get_* tools — any response carrying a dataset or nowcast_dataset handle staged its full result here — or list them all where this deployment allows listing. Each entry gives the source tool, query parameters, creation and expiry time, row count, whether the upstream fetch was complete, and the column schema. Read the columns here before writing SQL for unhcr_dataframe_query.
Inputs: name. Returns: error, notice, dataframes
unhcr_dataframe_queryQuery staged dataframesARead-onlyIdempotentInspect
Run a single-statement SELECT against the dataframes staged by the unhcr_get_* tools. Check a dataframe’s columns with unhcr_dataframe_describe first. Writes, DDL, DROP, COPY, PRAGMA, ATTACH, file references, external-data functions, engine introspection, dynamic table lookup, and system catalogs are rejected; query() accepts only a single SQL string literal, checked by the same gate. Optional register_as saves the result as a new dataframe with a fresh TTL. Recompute rates from summed counts rather than averaging rate columns.
Inputs: sql (required), preview, row_limit, register_as. Returns: cap, rows, error, shown, +11 more
unhcr_get_asylum_applicationsUNHCR asylum applicationsARead-onlyIdempotentInspect
Get asylum applications lodged per year (2000 to the latest year) by country of origin and/or asylum, split by default into application stage — new, repeat, appeal, and the combined stages some countries report — so new claims are not added to appeals of old ones. Counts given as cases are never added to counts of persons; each row states its unit. Decode stage, authority, and decision-level codes with unhcr_list_reference (topic asylum_codes).
Inputs: limit, stage, asylum, expand, +6 more. Returns: cap, rows, error, shown, +10 more
unhcr_get_asylum_decisionsUNHCR asylum decisionsARead-onlyIdempotentInspect
Get asylum decisions per year (2000 to the latest year) by country of origin and/or asylum: recognized as refugees, complementary protection, rejected, and otherwise closed, with UNHCR's Refugee Recognition Rate and Total Protection Rate computed over substantive decisions (otherwise-closed cases excluded). By default all decision levels are summed and each row lists the levels it includes; appeal-stage decisions can concern people already decided at first instance, so split_by decision_level or filter decision_levels to FI for first-instance rates. Cases and persons are never added together.
Inputs: limit, stage, asylum, expand, +6 more. Returns: cap, rows, error, shown, +10 more
unhcr_get_demographicsUNHCR demographicsARead-onlyIdempotentInspect
Get UNHCR year-end stocks (2001 to the latest year) broken down by population type, sex, and age band (0–4, 5–11, 12–17, 18–59, 60+, unknown age), by country of origin and/or asylum. Coverage is partial: each row gives the share of its total that UNHCR could disaggregate by sex, and age bands are null where no breakdown exists. These totals come from a separate collection and need not match unhcr_get_population.
Inputs: limit, stage, asylum, expand, +5 more. Returns: cap, rows, error, shown, +12 more
unhcr_get_populationUNHCR displacement stocksARead-onlyIdempotentInspect
Get UNHCR year-end displacement stocks (1951 to the latest year) by country of origin and/or asylum: refugees, asylum-seekers, other people in need of international protection, IDPs, stateless people, others of concern, and host communities, plus refugees and IDPs who returned during the year. Stocks count people in a situation on 31 December, not arrivals. Palestine refugees under UNRWA's mandate and IDMC's conflict-IDP estimate are separate series shown beside each row. Set include_nowcast for UNHCR's current-year estimate by asylum country; for sex and age breakdowns, use unhcr_get_demographics.
Inputs: limit, stage, asylum, expand, +5 more. Returns: cap, rows, error, shown, +15 more
unhcr_get_solutionsUNHCR durable solutionsARead-onlyIdempotentInspect
Get durable solutions per year (1959 to the latest year) by country of origin and/or asylum: refugees who returned home, refugees resettled to a third country, refugees naturalised, and IDPs who returned. The asylum country means something different per column: the country refugees returned from, the country they were resettled to, the country that naturalised them; IDP returns sit on the origin country itself. Null means the figure was not collected for that country and year, not zero.
Inputs: limit, stage, asylum, expand, +4 more. Returns: cap, rows, error, shown, +12 more
unhcr_list_referenceUNHCR reference vocabularyARead-onlyIdempotentInspect
Decode the vocabulary the unhcr_* tools take as input: countries (ISO3, ISO2, UNHCR code, names, UNHCR and UN regions), UNHCR’s regional bureaus, each dataset’s first and latest year, population-type definitions, and the asylum authority, stage, decision-level, and unit codes. Filter countries with name_contains to turn a country name into the ISO3 code that origin and asylum take.
Inputs: topic (required), name_contains. Returns: error, topic, notice, nowcast, +6 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Query UN population data: fertility, mortality, migration, life expectancy for 298 countries.
Query US Census Bureau data: demographics, economics, and housing statistics.
Query IMF SDMX 3.0 macroeconomic dataflows — WEO, BOP, CPI, exchange rates, 190 countries.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides access to UNHCR refugee statistics through a standardized interface, allowing AI agents to query data by country of origin, country of asylum, and year.5MIT
- AlicenseNot gradedqualityDmaintenanceProvides a unified interface to access UNHCR's open data across statistics, RDF, and IATI MCP servers, enabling aggregated queries, cross-domain analytics, and dataset discovery.MIT
- AlicenseAqualityBmaintenanceEnables querying and analyzing humanitarian data, such as refugee statistics, through semantic tools like country comparisons, trend analysis, and report generation, using the UNHCR API.2125 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to query keyless UNHCR statistics on forcibly displaced and stateless persons, including refugees, asylum seekers, IDPs, and returnees, plus asylum applications and decisions, filtered by year, country of origin, or country of asylum, with a country-code lookup for resolving UNHCR codes. It can be reached through the hosted Pipeworx gateway or run locally over stdio.301 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.