Skip to main content
Glama

unhcr-refugees-mcp-server

Server Details

Query UNHCR refugee, IDP, and stateless populations, asylum decisions, returns, and resettlement.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
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

A4.2/5.0

Scored across 8 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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 tools
unhcr_dataframe_describeDescribe staged dataframesA
Read-onlyIdempotent
Inspect

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 dataframesA
Read-onlyIdempotent
Inspect

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 applicationsA
Read-onlyIdempotent
Inspect

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 decisionsA
Read-onlyIdempotent
Inspect

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 demographicsA
Read-onlyIdempotent
Inspect

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 stocksA
Read-onlyIdempotent
Inspect

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 solutionsA
Read-onlyIdempotent
Inspect

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 vocabularyA
Read-onlyIdempotent
Inspect

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

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables querying and analyzing humanitarian data, such as refugee statistics, through semantic tools like country comparisons, trend analysis, and report generation, using the UNHCR API.
      21
      25 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 npm
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.