ImmigrationDB MCP
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
ImmigrationDB MCP
Read-only Model Context Protocol server for ImmigrationDB, a sourced migration reference: 39 countries and 27,000+ cities, visa and residence routes, passport entry answers, cost of living, salaries, crime, air quality and climate. Every value carries its source, observation date and geographic grain. The server reads the same release as the website.
Live endpoint (Streamable HTTP, no key, no account):
https://immigrationdb.com/mcpProtocol versions:
2026-07-28,2025-11-25Docs:
https://immigrationdb.com/data/mcp/Tool catalog with input schemas:
https://immigrationdb.com/data/mcp/catalog.jsonMethodology:
https://immigrationdb.com/methodology/Agent index:
https://immigrationdb.com/llms.txt
This repository holds the public contract of the hosted server: client
configuration, the tool list with input schemas (tools.json),
registry metadata (server.json) and a dependency-free smoke
test. The service runs only as the hosted endpoint above; its data release is
several gigabytes and is published as files at
https://immigrationdb.com/data/mcp/.
Tools
Tool | Arguments | What it does |
|
| Search countries and cities. |
|
| Resolve a city name to ranked candidates; never picks an ambiguous country silently. |
|
| One city with claim-level facts and source metadata. |
|
| Exactly one fact: value, unit, grain, dates, source. |
|
| Compare cities on compatible metrics, with provenance for every cell. |
|
| Numeric filters over city facts with explicit counts. |
|
| Metric definitions and their coverage. |
|
| Metric blocks with coverage. |
|
| One country record with official visa-route links. |
|
| Visa and residence routes of a destination. |
|
| One route with its official source. |
|
| Passport entry rules; unknown answers stay explicit. |
|
| One passport entry rule. |
|
| Published reports (largest cities, cheapest rent, cleanest air…). |
|
| One report with its rows, method and sources. |
Optional arguments are listed with the required ones; tools.json has the full
input schemas. Country arguments are ISO 3166-1 alpha-2 codes (de, lv, us); city
arguments are canonical slugs (berlin), not display names. All tools are
annotated read-only and idempotent.
Related MCP server: globalrules-mcp
Resources
immigrationdb://country/{cc}— country record and route linksimmigrationdb://city/{country}/{slug}— city facts with source metadataimmigrationdb://legal/routes/{country}/{route_id}— one visa or residence routeimmigrationdb://legal/entry/{passport}/{destination}— one passport entry answerimmigrationdb://legal/entry/{passport}— all entry answers for a passportimmigrationdb://report/{report_id}— report rows, method and sources
Client configuration
Any MCP client that supports Streamable HTTP:
{
"mcpServers": {
"immigrationdb": {
"url": "https://immigrationdb.com/mcp"
}
}
}Claude Code:
claude mcp add --transport http immigrationdb https://immigrationdb.com/mcpClients that only speak stdio can go through
mcp-remote:
npx -y mcp-remote https://immigrationdb.com/mcp.
Example calls
{ "tool": "resolve_city", "arguments": { "query": "Berlin, Germany", "limit": 5 } }
{ "tool": "get_city_fact", "arguments": { "country": "de", "slug": "berlin", "metric_id": "population_total" } }
{ "tool": "compare_cities", "arguments": { "cities": [{ "country": "de", "slug": "berlin" }, { "country": "de", "slug": "munich" }], "metric_ids": ["population_total"] } }
{ "tool": "search_facts", "arguments": { "countries": ["de"], "filters": [{ "metric_id": "population_total", "op": ">", "value": 100000 }], "sort_metric": "population_total", "sort_order": "desc", "limit": 20 } }
{ "tool": "get_entry_rule", "arguments": { "passport": "lv", "destination": "us" } }Response contract
Every response carries the snapshot ID, its generation date and the canonical origin. Facts keep their value, unit, geographic grain, observation date, verification date, source ID, source URL and grade. Unknown or withheld values are returned as such and never estimated. Errors name the requested identifier and the snapshot ID. Rate limits and response-size caps apply per client.
Smoke test
Node 20 or newer, no install step:
node scripts/smoke.mjs # initialize, list tools, run six example calls
node scripts/smoke.mjs --write-tools # also refresh tools.json from the live serverLicense
The files in this repository are MIT. The ImmigrationDB data is published under CC BY 4.0: credit ImmigrationDB and link to the page or resource you used. The underlying official sources keep their own terms; each value names its publisher and links to it.
ImmigrationDB is an independent reference. It gives no legal advice and sells no visa or immigration services; check current requirements with the responsible authority before acting.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Compare cities to live in on open, sourced data: take-home pay, rent, visas, climate, safety.
Relocation, residency, visa, company-formation and crypto-tax data for about 170 countries.
Read-only city climate normals, daylight and month-by-month data. Every answer cites its page.
Read-only city data: places, station exits, last trains. Each answer carries its source and date.
Related MCP Servers
- AlicenseAqualityCmaintenanceServes country facts, administrative boundary GeoJSON, and per-region population, area, and capital statistics as structured data, letting an AI assistant build interactive maps, comparisons, and multilingual geography content instead of reciting prose. It also normalises region names across sources so boundary shapes can be joined to their statistics.326 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to retrieve and compare verified country facts such as VAT/GST, public holidays, visas, tipping, and minimum wages across 70 countries, with automatic x402 micropayments in USDC on Base per call.98 npmMIT
- AlicenseBqualityBmaintenanceEnables anonymous read-only queries of dated, evidence-qualified citizenship-by-investment research across eleven programmes, exposing eight tools for listing, retrieving, comparing, costing, travel rules, sources, change history and coverage. Runs as a hosted Streamable HTTP endpoint or a local stdio adapter with no accounts, keys or storage.91MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to compare any number of cities using open data weighted by take-home pay after rent, right to live, climate, air, safety, health, and research, with sourced figures returned directly in chat.89 npmApache 2.0