Government

Data source: UNHCR Population Statistics API

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/migration/

nobloat — strip report_feedback tool URL-based auth (for clients without header support)

claude_desktop_config.json

{
  "mcpServers": {
    "gnist-migration": {
      "url": "https://context.gnist.ai/mcp/migration/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Shell

curl -X POST "https://context.gnist.ai/mcp/migration/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "report_feedback", "arguments": {"feedback": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/migration/

5 endpoints available:

GET /rest/migration/get_population
GET /rest/migration/get_demographics
GET /rest/migration/get_solutions
GET /rest/migration/list_countries
GET /rest/migration/report_feedback

Shell

curl "https://context.gnist.ai/rest/migration/report_feedback?feedback=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"

Python

import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/migration/report_feedback",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "feedback": "example"
},
)
print(resp.json())

OpenAPI Spec · Full API Docs

CLI Command Line

Command gc migration

CLI documentation will be available when the GnistAI SDK is published.

Install

pip install gnistai

Available Tools (5)

get_population

Get refugee, asylum seeker, IDP, and stateless population statistics from UNHCR.

Parameter	Type	Required	Description
`year`	`any`	optional	Filter by year (1951–2025). Example: 2023.
`country_of_origin`	`any`	optional	ISO country code of origin (2 or 3 letter). Example: 'SYR' for Syria, 'UA' for Ukraine.
`country_of_asylum`	`any`	optional	ISO country code of asylum (2 or 3 letter). Example: 'DEU' for Germany, 'US' for United States.
`limit`	`integer`	optional	Results per page (1-100). (default: 20)
`page`	`integer`	optional	Page number. (default: 1)

get_demographics

Get age and gender demographic breakdowns of displaced populations.

Parameter	Type	Required	Description
`year`	`any`	optional	Filter by year (1951–2025).
`country_of_origin`	`any`	optional	ISO country code of origin.
`country_of_asylum`	`any`	optional	ISO country code of asylum.
`limit`	`integer`	optional	Results per page (1-100). (default: 20)
`page`	`integer`	optional	Page number. (default: 1)

get_solutions

Get durable solutions data — refugee returns, resettlement, and naturalisation.

Parameter	Type	Required	Description
`year`	`any`	optional	Filter by year (1951–2025).
`country_of_origin`	`any`	optional	ISO country code of origin.
`country_of_asylum`	`any`	optional	ISO country code of asylum.
`limit`	`integer`	optional	Results per page (1-100). (default: 20)
`page`	`integer`	optional	Page number. (default: 1)