# Reported issues for unhcr-refugees-mcp-server

Pod holds 6 of 6 GitHub reports that passed its relevance review. This can include external user reports, maintainer-confirmed bugs, and concrete feature gaps. Treat them as evidence to inspect, not a count of distinct defects.

Back to [unhcr-refugees-mcp-server](/mcp/unhcr-refugees-mcp-server).

## Most discussed

### bug(unhcr_list_reference): name_contains with no Latin letters or digits returns every country

### Server version

0.1.0

### mcp-ts-core version

0.13.8

### Runtime

Node.js

### Runtime version

Node 26.5.0

### Transport

HTTP (Streamable HTTP)

### OS

macOS

### Description

`name_contains` is reduced to `a–z`/`0–9` tokens before matching. A value with none of those characters (Cyrillic, Arabic, Greek, or CJK script, or punctuation only) yields zero tokens, and zero tokens match every country. The call returns the whole table with `totalCount` 229 and no notice, which reads as…

[Read the thread](https://github.com/cyanheads/unhcr-refugees-mcp-server/issues/6) · 2026-09-26 · closed · 2 comments

### bug(unhcr_get_population): UNRWA and IDMC rows without a matching UNHCR row are dropped

### Server version

0.1.0

### mcp-ts-core version

0.13.8

### Runtime

Node.js

### Runtime version

Node 26.5.0

### Transport

HTTP (Streamable HTTP)

### OS

macOS

### Description

`unhcr_get_population` joins the UNRWA and IDMC companion series onto UNHCR population rows only, so a (year, origin, asylum) key the companion reports but UNHCR does not is discarded. The server fetches those rows with the same scope and window, then returns an empty result whose notice suggests origin and…

[Read the thread](https://github.com/cyanheads/unhcr-refugees-mcp-server/issues/5) · 2026-09-26 · closed · 2 comments

### bug(footnotes): caveats attach to rows that carry none of their population types

### Server version

0.1.0

### mcp-ts-core version

0.13.8

### Runtime

Node.js

### Runtime version

Node 26.5.0

### Transport

HTTP (Streamable HTTP)

### OS

macOS

### Description

A footnote attaches to a row when its population types overlap the tool's type list, not the types the row actually carries. 573 of UNHCR's 658 footnotes name only an asylum country, so notes about that country's IDPs, stateless people, or returns attach to every foreign-origin row there, where those counts are…

[Read the thread](https://github.com/cyanheads/unhcr-refugees-mcp-server/issues/4) · 2026-09-26 · closed · 2 comments

### bug(unhcr_dataframe_query): truncation notice says to use register_as when register_as already saved the result

### Server version

0.1.0

### mcp-ts-core version

0.13.8

### Runtime

Node.js

### Runtime version

Node 26.5.0

### Transport

HTTP (Streamable HTTP)

### Description

With `register_as` set, `unhcr_dataframe_query` saves the whole result as the new dataframe and returns only `row_limit` or `preview` rows inline. The truncation notice still tells the caller to "Use register_as to keep the whole result", which is the step it just took. Following that advice with the same name fails…

[Read the thread](https://github.com/cyanheads/unhcr-refugees-mcp-server/issues/3) · 2026-09-26 · closed · 2 comments

### bug(country-input): JSON-stringified array in origin/asylum rejected as unknown country codes

### Server version

0.1.0

### mcp-ts-core version

0.13.8

### Runtime

Node.js

### Runtime version

Node 26.5.0

### Transport

HTTP (Streamable HTTP)

### Description

Some MCP clients send array arguments as JSON-encoded strings. The framework decodes those on array-typed fields (`stages: "[\"N\"]"` and `split_by: "[\"stage\"]"` both work), but `origin` and `asylum` accept `string | string[]`, so a stringified array takes the string branch. `parseCodeList` in…

[Read the thread](https://github.com/cyanheads/unhcr-refugees-mcp-server/issues/2) · 2026-09-26 · closed · 2 comments

### Empty-result notice contradicts data_notes when every upstream row lacks a year

### Server version

0.1.0

### mcp-ts-core version

0.13.8

### Runtime

Node.js

### Runtime version

Node 26.5.0

### Transport

stdio

### OS

macOS

### Description

When every row UNHCR returns for a query has no usable year, the result's notice and its `data_notes` contradict each other. The tool drops all the rows, so it falls back to the generic empty-result notice ("UNHCR reports no … rows"), while `data_notes` says the same rows were fetched and left out.

This affects all five data…

[Read the thread](https://github.com/cyanheads/unhcr-refugees-mcp-server/issues/1) · 2026-09-26 · closed · 2 comments

## Most recent

The remaining reports are on [the project's issue tracker](https://github.com/cyanheads/unhcr-refugees-mcp-server/issues).