MCP server

Unhcr Refugees

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

Checked 28 Oct 2026, 09:03 UTC · Connected to it and listed its tools

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

Working at last checkAbout 7,812 tokens per request once connected8 tools

Source

https://unhcr-refugees.caseyjhand.com/mcp

At a glance

Type: MCP server
Publisher: Not verified
Status: Working at last check
Tools: 8
Token cost: About 7,812 tokens per request
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok
Last checked: 28 Oct 2026, 09:03 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http unhcr-refugees-mcp-server https://unhcr-refugees.caseyjhand.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.unhcr-refugees-mcp-server]
url = "https://unhcr-refugees.caseyjhand.com/mcp"

Gemini CLI

{"mcpServers":{"unhcr-refugees-mcp-server":{"httpUrl":"https://unhcr-refugees.caseyjhand.com/mcp"}}}

Cursor

{"mcpServers":{"unhcr-refugees-mcp-server":{"url":"https://unhcr-refugees.caseyjhand.com/mcp"}}}

VS Code

{"servers":{"unhcr-refugees-mcp-server":{"type":"http","url":"https://unhcr-refugees.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add unhcr-refugees-mcp-server https://unhcr-refugees.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"unhcr-refugees-mcp-server","server_url":"https://unhcr-refugees.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"unhcr-refugees-mcp-server","server_url":"https://unhcr-refugees.caseyjhand.com/mcp"}

Tools

unhcr_dataframe_describe ~284 tokens
Describe 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_query ~613 tokens
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 ar
unhcr_get_asylum_applications ~1377 tokens
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 add
unhcr_get_asylum_decisions ~1504 tokens
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 ex
unhcr_get_demographics ~1229 tokens
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 nu
unhcr_get_population ~1269 tokens
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. Stock
unhcr_get_solutions ~1107 tokens
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, th
unhcr_list_reference ~429 tokens
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

Browse

Related MCP servers

Unhcr
UNHCR Refugee Data Finder MCP (keyless).
Geotone — Global News Signals
Live global news signals: ranked wire, story timelines, coverage volume/tone/surges. Free, no auth.
Swiss Living Index
Official Swiss data for all 26 cantons and 2,100 communes: tax, rent, health premiums, fuel, jobs.
Hdx
Humanitarian Data Exchange (HDX) MCP — data.humdata.org, the open humanitarian-data platform run…
KnowJudges
Source-linked research on U.S. judges, courts, cases, and judicial analytics.
lahend.ee — Estonian court decisions
Estonian court decisions: full-text case-law search, each ruling linked to its companies. Free.
RateAPI — live US mortgage, auto, HELOC, personal & deposit rates
Live US mortgage, auto, HELOC, personal & deposit rates with evidence, plus who can join each lender
VITNA – Containment for rogue AI agents
Guard wraps stdio MCP servers: risky calls wait for a person; no answer, no run. Remote: cooperative

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/unhcr-refugees-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/unhcr-refugees-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents