原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

Unhcr Refugees MCP Server

作者:cyanheads版本 0.3.0i★ 1i电脑或云端官方网站 ↗
注册名称io.github.cyanheads/unhcr-refugees-mcp-server

安装方法

What it does

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

  • Connects 电脑或云端
  • Account or key No key needed
  • Category 其他

为什么排在这里

列表按使用分(满分 100)排序,由以下部分组成

热度4/80GitHub 星标或每周下载量:较大的计 60,较小的计 20
新鲜度12/1230 天内有发布或代码更新得满分
仍在响应8/8上次检查时云端端点有响应
使用分24/100

质量: 基础检查通过 5/5 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)

安装

选择你使用的 AI 应用,然后复制设置。

用一句话让 AI 帮你安装

请帮我安装 Unhcr Refugees MCP Server。按照 https://mcp.popnx.com/i/cyanheads-unhcr-refugees-mcp-server.md 操作,先把命令给我看,等我同意后再运行。

粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文

通过 5/5 项检查 · 你的提问会经过开发者的服务器(unhcr-refugees.caseyjhand.com) · ✓ 命令已检查 2026年11月14日

第一步:你用哪个 AI?

选择你用的应用,步骤会显示在下方。

可连接 Claude · 约 2 分钟

不需要密钥,不用安装程序 · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加

  1. 打开 Claude 的 Connectors 页面

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 点击“Add” → “Custom” → “Web”,填写这 2 项

    把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue

    Name · 名称Unhcr Refugees MCP Server
    Remote MCP server URL · 地址https://unhcr-refugees.caseyjhand.com/mcp

    在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add

  3. 在聊天中开启

    +ConnectorsUnhcr Refugees MCP Server

  4. 试一试

    用 Unhcr Refugees MCP Server 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 Unhcr Refugees MCP Server,或回答中出现 Unhcr Refugees MCP Server 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

能否连接 ChatGPT 取决于方案

完整 MCP:网页版 ChatGPT Business、Enterprise 或 Edu · Pro:以读取/获取权限连接,修改数据的工具可能用不了 · Plus:官方文档尚未确认,如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页

  1. 在网页版 ChatGPT 打开添加 MCP 的页面

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 填写名称和地址

    输入名称,在 Connection 下粘贴地址,勾选风险提示,然后点击 Create as a plugin

    Name · 名称Unhcr Refugees MCP Server
    Connection · 地址https://unhcr-refugees.caseyjhand.com/mcp
  3. 在聊天中选择 Unhcr Refugees MCP Server

    开启新聊天,输入前先从插件列表中选择 Unhcr Refugees MCP Server

  4. 试一试

    用 Unhcr Refugees MCP Server 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 ChatGPT 说正在使用 Unhcr Refugees MCP Server,或回答中出现 Unhcr Refugees MCP Server 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Claude Code · 约 2 分钟

不需要密钥,不用安装程序

  1. 打开终端

    Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell

  2. 粘贴这条命令并按 Enter

    claude mcp add --transport http --scope user unhcr-refugees https://unhcr-refugees.caseyjhand.com/mcp
  3. 在 Claude Code 中输入 /mcp

    应能看到 Unhcr Refugees MCP Server 在列表中并显示已连接

  4. 试一试

    用 Unhcr Refugees MCP Server 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude Code 说正在使用 Unhcr Refugees MCP Server,或回答中出现 Unhcr Refugees MCP Server 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 Cursor

    在 Cursor 中打开

    Cursor 会请你确认安装,点击 Install

  2. 在 Cursor 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 Unhcr Refugees MCP Server 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Cursor 说正在使用 Unhcr Refugees MCP Server,或回答中出现 Unhcr Refugees MCP Server 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 VS Code

    在 VS Code 中打开

    VS Code 会请你确认安装,点击 Install

  2. 在 VS Code 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 Unhcr Refugees MCP Server 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 VS Code 说正在使用 Unhcr Refugees MCP Server,或回答中出现 Unhcr Refugees MCP Server 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

通过网页连接的应用使用的地址

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

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 Unhcr Refugees MCP Server 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

通过网页连接

Claude Code

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

安装在电脑上

Claude Code

claude mcp add --scope user unhcr-refugees -- npx -y @cyanheads/unhcr-refugees-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "unhcr-refugees": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/unhcr-refugees-mcp-server"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "unhcr-refugees": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/unhcr-refugees-mcp-server"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "unhcr-refugees": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/unhcr-refugees-mcp-server"
      ]
    }
  }
}

需要你填写的值

  • UNHCR_REQUESTS_PER_SECOND env
    整个进程每秒发起的上游请求数(1–10)。
    查看英文原文Upstream request starts per second for the whole process (1–10).
  • UNHCR_MAX_ROWS env
    单次工具调用最多获取的上游行数(10000–500000);超过上限的结果会在该上限处停止,并返回 complete: false。
    查看英文原文Most upstream rows one tool call fetches (10000–500000); a larger result stops at the cap with complete: false.
  • UNHCR_CACHE_MAX_MB env
    响应缓存预算,单位 MB;0 表示禁用缓存。
    查看英文原文Response-cache budget in MB; 0 disables the cache.
  • UNHCR_DATASET_TTL_SECONDS env
    每张表的暂存 dataframe 过期时间,单位为秒(最小 60)。
    查看英文原文Per-table TTL for staged dataframes, in seconds (minimum 60).
  • UNHCR_DATAFRAME_DROP_ENABLED env
    设置为 true 以注册 unhcr_dataframe_drop;默认关闭,每个表的 TTL 会回收已暂存的表。
    查看英文原文Set to true to register unhcr_dataframe_drop; off by default, the per-table TTL reclaims staged tables.
  • UNHCR_CLAMP_LIMITS env
    将超出上限的 limit、preview 和 row_limit 按上限提供并附带提示。设为 false 则将每个上限声明为 schema 最大值,并拒绝更大的值。
    查看英文原文Serves limit, preview, and row_limit above their cap at the cap, with a notice. Set to false to advertise each cap as a schema maximum and reject a larger value.
  • MCP_LOG_LEVEL env
    设置输出的最低日志级别(例如 'debug'、'info'、'warn')
    查看英文原文Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

说明为自动翻译,变量名保持原样;不确定时请查看原文。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

一览

每周下载量i
108/周
许可证i
Apache-2.0
连接方式
电脑或云端
传输方式
stdio, streamable-http
最新版本i
0.3.0
分类i
其他
发布到注册中心i
2026年11月4日
代码最后更新i
2026年11月13日
最近检查
2026年11月16日
作者
cyanheads
软件包
npm: @cyanheads/unhcr-refugees-mcp-server
npm: @cyanheads/unhcr-refugees-mcp-server
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。

通过互联网连接,适用于

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

在你的电脑上运行,适用于

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

全部应用及其优缺点 →

它能做什么

工具名称和描述与服务器在 2026年11月16日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。

  • unhcr_list_reference

    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. Fi

  • unhcr_get_population

    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 du

  • unhcr_get_demographics

    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,

  • unhcr_get_asylum_applications

    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

  • unhcr_get_asylum_decisions

    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 (other

  • unhcr_get_solutions

    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 refuge

  • unhcr_dataframe_describe

    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

  • unhcr_dataframe_query

    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, an

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月20日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 cyanheads 验证,该账户拥有此仓库

  • ✓ 通过

    仍在维护

    代码最后更新于7天前

  • ✓ 通过

    有许可证

    使用 Apache-2.0

  • ✓ 通过

    端点有响应

    在 493 毫秒内响应(HTTP 200)

  • – 不适用

    使用 OAuth 登录

    无需登录

  • ✓ 通过

    工具描述中没有隐藏指令

    已读取 8 个工具描述,未发现针对 AI 的隐藏指令

已公开的漏洞(OSV.dev)

OSV.dev 中没有 @cyanheads/unhcr-refugees-mcp-server@0.3.0 的记录

只检查这个版本的包本身,不包括所有依赖 · 检查于 2026年11月15日

我们检查什么 → · JSON

作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cyanheads-unhcr-refugees-mcp-server.svg)](https://mcp.popnx.com/en/servers/cyanheads-unhcr-refugees-mcp-server)

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

用户评价

还没有评价

登录后写评价

与“其他”中的其他服务器比较i

  • 星标数多于此分类中其他 20815 个服务器的 86%
  • 发布到注册中心的时间比此分类中其他 20815 个服务器的 76% 更新
  • 基础检查结果等于或优于此分类中其他 20815 个服务器的 99%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

Unhcr Refugees MCP Server 安全吗?

它在 5 项适用的基础检查中通过了 5 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端?

两种方式都可以:安装在你的电脑上,或者连接云端版本。

它还在维护吗?

GitHub 仓库最后更新于7天前,最新版本(0.3.0)于16天前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。

有什么可以替代它?

同一分类中有:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73广泛使用★ 9.1万4天前更新

在云端运行✓ 服务方 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ广泛使用★ 92762个月前更新

在云端运行✓ 服务方 · openstatus.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI正在增长★ 582414个月前更新

在云端运行仓库已归档✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom广泛使用★ 51364个月前更新

在云端运行✓ 服务方 · jitsu.com
与相似项目对比
本项
Unhcr Refugees MCP Server
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
运行位置云端或安装在电脑上都可以在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装
需要密钥否否否否否否
可在 Claude 中按 + 添加否否否否否否
基础检查5/54/44/44/41/44/4
许可证Apache-2.0AGPL-3.0AGPL-3.0MITApache-2.0MIT
价格登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

@cyanheads/unhcr-refugees-mcp-server Query UNHCR refugee, IDP, and stateless populations, asylum decisions, returns, and resettlement via MCP. STDIO or Streamable HTTP. 8 Tools (+1 opt-in)

Public Hosted Server: https://unhcr-refugees.caseyjhand.com/mcp


Overview

Refugee and displacement statistics from the UNHCR Refugee Data Finder: refugee, asylum-seeker, IDP, and stateless populations since 1951, asylum applications and decisions since 2000, and returns and resettlement since 1959. Pull annual figures by country of origin and asylum, and run SQL over large results. No API key required.

Tools
ToolDescription
unhcr_list_referenceDecode countries (ISO3, ISO2, and UNHCR codes, names, regions), regional bureaus, dataset coverage years, population types, and asylum codes
unhcr_get_populationYear-end displacement stocks by origin and/or asylum country from 1951, with UNRWA and IDMC series alongside and an optional current-year nowcast
unhcr_get_demographicsYear-end stocks by population type, sex, and age band from 2001, with the share UNHCR could disaggregate
unhcr_get_asylum_applicationsAsylum applications lodged per year from 2000, split by application stage by default
unhcr_get_asylum_decisionsAsylum decisions per year from 2000 by outcome, with the Refugee Recognition Rate and Total Protection Rate
unhcr_get_solutionsRefugee returns, resettlement, naturalisation, and IDP returns per year from 1959
unhcr_dataframe_describeDescribe a staged dataframe by name, or list them all where listing is on, with provenance, expiry, completeness, and column schema
unhcr_dataframe_queryRun one read-only SQL SELECT across staged dataframes, optionally saving the result as a new one
unhcr_dataframe_dropDrop a staged dataframe before its TTL — opt-in, absent from tools/list by default

unhcr_dataframe_drop is registered only when UNHCR_DATAFRAME_DROP_ENABLED=true; the other eight tools are always advertised.

Dataframe workflow
  1. A unhcr_get_* call whose full result exceeds limit, or that sets stage: true, stages every row as a df_XXXXX_XXXXX table and returns its handle in dataset (nowcast_dataset for unhcr_get_population's nowcast).
  2. unhcr_dataframe_describe lists the staged tables with their columns, source call, and expiry. Listing is off over HTTP with MCP_AUTH_MODE=none, so there describe each table by the name in dataset or nowcast_dataset.
  3. unhcr_dataframe_query runs one read-only DuckDB SELECT across them; register_as saves the result as a new table for the next query.
  4. Tables expire after UNHCR_DATASET_TTL_SECONDS (24 hours by default). With UNHCR_DATAFRAME_DROP_ENABLED=true, unhcr_dataframe_drop removes one sooner. Once a tenant's staged rows pass 1,000,000, the oldest tables are evicted first, and the call that pushed the total over names them in evicted.

Dataframes run on DuckDB's native binding, which the npm and Docker installs carry. The Claude Desktop .mcpb bundle ships without it, so there the data tools answer inline only. Set CANVAS_PROVIDER_TYPE=none to turn dataframes off anywhere.

Agent skill

skills/unhcr-refugees-guide is a published Agent Skill. It covers the checks to make before summing or comparing UNHCR figures: which columns a total adds, stateless people under origin XXA, the two Palestine refugee series, the nowcast's missing origin, bureau and EU totals in SQL, filters that drop whole countries, units that switch between years, demographic shares, and footnotes. Plugin installs and the .mcpb bundle pick it up from the skills/ folder, and MCP clients that support skills read it as skill://unhcr-refugees-guide/SKILL.md.

Capability reference

The five unhcr_get_* tools share one contract:

  • Scope: origin and asylum take ISO3 codes, case-insensitive, as a string or a list, up to 250 distinct codes each, enough to list every country. ISO2 codes are rewritten to ISO3; UNHCR's own codes and country names are rejected. Each listed code returns its own rows, and an omitted dimension is summed into one row unless expand (origin, asylum, or both) lists every country. year_from / year_to default to the dataset's span and are clamped to it.
  • Rows: the full result is sorted by sort_by, then cut to limit (default 25, cap 2,000). A larger limit is served at 2,000 with a notice naming the requested and effective values, even for an empty or small result; with UNHCR_CLAMP_LIMITS=false it is rejected instead. Where dataframes are on, the full set of a larger result is staged, and stage: true stages a result that fits too.
  • Output: total_rows, complete (false when UNHCR_MAX_ROWS stopped the fetch), measure (stock or flow), applied_scope, latest_year, dataset when staged, data_notes, and attribution.
  • Errors: unknown_country_code, invalid_year_window, year_out_of_coverage, conflicting_scope, too_many_country_codes, and the retryable upstream_busy, which carries retryAfter.

unhcr_list_reference tool
  • topic: countries, regions, coverage, population_types, or asylum_codes. With countries, name_contains keeps countries whose names contain every word given, or whose ISO3, ISO2, or UNHCR code equals one; there is no fuzzy matching
  • coverage gives each dataset's first_year, latest_year, and measure, plus the month of the current nowcast
  • Countries, regions, and coverage come from the live API and are cached for 24 hours; population types and asylum codes are static, and asylum codes UNHCR's methodology does not define carry documented: false

unhcr_get_population tool
  • Year-end stocks refugees, asylum_seekers, oip, idps, stateless, ooc, and hst, plus returned_refugees and returned_idps, which are flows during the year; sort_by takes any of them or year
  • unrwa_refugees (Palestine refugees registered with UNRWA) and idmc_conflict_idps (IDMC's conflict-IDP estimate) sit beside a row when that series has one and are never added into UNHCR's counts. Matching UNHCR footnotes come back too, up to 20, with footnotes_total; caveats on the inline rows come first
  • include_nowcast: true appends UNHCR's current-year monthly estimate of refugees and asylum-seekers by asylum country, sorted by refugees or asylum_seekers when sort_by names one, cut to limit with nowcast_total, and staged as its own dataframe (nowcast_dataset) when it overflows or stage is set; it is skipped when origin lists codes

unhcr_get_demographics tool
  • population_types filters to REF, ASY, OIP, IDP, STA, OOC, HST, RET, or RDP; sort_by takes year or total
  • Each row is one population type: total, fourteen sex × age bands (female_0_4 … female_60_plus, female_unknown_age, female_total, and the male_* twins), disaggregated, and sex_disaggregated_share (0–1). Bands are null where UNHCR has no breakdown
  • Totals come from a separate collection and need not match unhcr_get_population; matching footnotes come back as there

unhcr_get_asylum_applications tool
  • split_by names which of authority, stage, and decision_level stay separate rows (default ["stage"]; [] gives one total per year, scope, and unit). stages filters before summing, e.g. ["N"] for new applications; sort_by takes year or applied
  • Each row lists the authorities, stages, and decision_levels codes summed into it, its unit (persons or cases), and applied. Cases are never added to persons

unhcr_get_asylum_decisions tool
  • split_by names which of authority and decision_level stay separate rows (default [], all summed, as UNHCR does for its rates). decision_levels filters before summing, e.g. ["FI"] for first instance
  • Each row carries recognized, complementary_protection, rejected, otherwise_closed, total_decisions, substantive_decisions, and a unit, plus refugee_recognition_rate and total_protection_rate as percentages of substantive decisions. A rate is null when that denominator is 0 or null
  • sort_by takes year or a count (total_decisions, substantive_decisions, recognized, rejected); rates are not sortable

unhcr_get_solutions tool
  • Flows returned_refugees, resettlement, naturalisation, and returned_idps; sort_by takes any of them or year. Matching footnotes come back as with population
  • 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

unhcr_dataframe_describe tool
  • Optional name (df_XXXXX_XXXXX); omit it to list every staged table, newest first. Over HTTP with MCP_AUTH_MODE=none listing is off and name is required
  • Each entry gives source_tool, query_params, created_at, expires_at, row_count, complete, incomplete_sources, providers, and column_schema. Saved descendants retain original incomplete-source handles after their ancestors expire or are evicted. Staged tables add origin_unhcr_region, origin_unsd_region, asylum_unhcr_region, and asylum_unsd_region columns the inline rows omit

unhcr_dataframe_query tool
  • sql is one DuckDB SELECT of at most 20,000 characters; joins, aggregates, window functions, and CTEs work. Writes, DDL, `PRAGM

只显示了开头部分;其余内容请在仓库中阅读