# ImmigrationDB

> ImmigrationDB is a free MCP server for maps and travel. Source-backed migration data on cities, visa routes and entry rules, read-only. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://immigrationdb.com
- **Repository:** https://github.com/streltcoff/immigrationdb-mcp
- **MCP Registry name:** io.github.streltcoff/immigrationdb
- **Categories:** maps and travel, legal and government
- **Listing updated:** 2026-11-15

## About

ImmigrationDB's server reads the same data release as its website: 39 countries, more than 27,000 cities, visa and residence routes, passport entry answers, cost of living, salaries, crime, air quality and climate. The README says every value carries its source, observation date and geographic grain, and unknown entry answers stay explicit instead of being guessed.

City arguments are canonical slugs and countries are ISO alpha-2 codes. resolve_city never silently picks an ambiguous country, and compare_cities only compares compatible metrics, with provenance for every cell. search_facts applies numeric filters across city facts and returns explicit counts.

The hosted endpoint is Streamable HTTP with no key or account. The repository holds the contract only: client config, tool schemas and a smoke test. Besides tools it exposes resources for countries, cities, routes, entry rules and reports. The site advises checking current rules with the responsible authority.

## Features

- **City facts with sources:** get_city and get_city_fact return values with unit, grain, dates and source.
- **City comparison:** compare_cities compares compatible metrics and shows provenance per cell.
- **Numeric fact search:** search_facts filters and sorts cities by metric with explicit counts.
- **Visa route lookup:** search_visa_routes and get_legal_route return routes with official sources.
- **Passport entry rules:** search_entry_rules and get_entry_rule answer by passport and destination.
- **Published reports:** list_reports and get_report return ranked reports such as cheapest rent or cleanest air.

## Good for

- Compare rent and salaries between two candidate cities
- Find which visa routes exist for a destination and purpose
- Check passport entry rules before booking a move
- Rank cities by air quality or safety
- Cite the source and date behind a migration statistic

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http immigrationdb https://immigrationdb.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://immigrationdb.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "immigrationdb": {
      "url": "https://immigrationdb.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "immigrationdb": {
      "type": "http",
      "url": "https://immigrationdb.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "immigrationdb": {
      "serverUrl": "https://immigrationdb.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "immigrationdb": {
      "type": "http",
      "url": "https://immigrationdb.com/mcp"
    }
  }
}
```

## Tools

- `search_destinations`: Search countries and cities.
- `resolve_city`: Resolve a city name to ranked candidates without silently picking an ambiguous country.
- `get_city`: One city with claim-level facts and source metadata.
- `get_city_fact`: Exactly one fact with value, unit, grain, dates and source.
- `compare_cities`: Compare cities on compatible metrics with provenance for every cell.
- `search_facts`: Numeric filters over city facts with explicit counts.
- `list_metrics`: Metric definitions and their coverage.
- `list_blocks`: Metric blocks with coverage.
- `get_country`: One country record with official visa-route links.
- `search_visa_routes`: Visa and residence routes of a destination.
- `get_legal_route`: One route with its official source.
- `search_entry_rules`: Passport entry rules; unknown answers stay explicit.
- `get_entry_rule`: One passport entry rule.
- `list_reports`: Published reports such as largest cities, cheapest rent and cleanest air.
- `get_report`: One report with its rows, method and sources.

## FAQ

### Is an account needed?

No. The endpoint needs no key or account.

### How are cities and countries identified?

Cities by canonical slug such as berlin, countries by ISO 3166-1 alpha-2 codes.

### Can it change data?

No. All tools are annotated read-only and idempotent.

### What happens when an answer is unknown?

Unknown entry answers stay explicit rather than being filled in.

### Is ImmigrationDB free?

Yes. ImmigrationDB is free to use.

### How do I add ImmigrationDB to Claude Code?

Run this command in your terminal: claude mcp add --transport http immigrationdb https://immigrationdb.com/mcp

### What are the best alternatives to ImmigrationDB?

The closest alternatives to ImmigrationDB are Tutu eSIM, NY LLC Publication (FileMyPublication), TribuJus, SupplyClub Catalog and SynomosAI Governance MCP.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/immigrationdb
