io.github.cyanheads/unhcr-refugees-mcp-server

io.github.cyanheads/unhcr-refugees-mcp-server · v0.1.2 · finance-and-payments

io.github.cyanheads/unhcr-refugees-mcp-server is healthy: it completed an MCP handshake in 546 ms and exposes 8 tools.

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

Endpoint: https://unhcr-refugees.caseyjhand.com/mcp (streamable-http)

Repository · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count8
Latency546 ms
Last checked (UTC)2026-10-16T07:20:36.682Z

Health history

Checked (UTC)StatusLatencyError
2026-10-16T07:20:36.682ZHealthy546
2026-10-15T03:25:51.004ZHealthy2628

Tools (8)

unhcr_list_referenceDecode 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
unhcr_get_populationGet 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. Stock
unhcr_get_demographicsGet 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 nu
unhcr_get_asylum_applicationsGet 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 add
unhcr_get_asylum_decisionsGet 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 ex
unhcr_get_solutionsGet 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, th
unhcr_dataframe_describeDescribe a dataframe (df_XXXXX_XXXXX) staged by the unhcr_get_* tools — any response carrying a 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 ups
unhcr_dataframe_queryRun a single-statement SELECT against the dataframes staged by the unhcr_get_* tools. Check a dataframe’s columns with unhcr_dataframe_describe first. Read-only: writes, DDL, DROP, COPY, PRAGMA, ATTACH, external-file functions, and system catalogs (information_schema, pg_catalog, sqlite_master, duck