ImmigrationDB

ImmigrationDB MCP

ImmigrationDB 用の読み取り専用 Model Context Protocol サーバーです。ImmigrationDB は、出典付きの移住リファレンスです。39 か国と 27,000 以上の都市、ビザと居住のルート、パスポートでの入国可否、生活費、給与、犯罪、大気質、気候の情報を提供します。すべての値に出典、観測日、地理的粒度が付記されています。このサーバーは、ウェブサイトと同じリリースを読み込みます。

• ライブエンドポイント（Streamable HTTP、キー不要、アカウント不要）： https://immigrationdb.com/mcp
• プロトコルバージョン： 2026-07-28、2025-11-25
• ドキュメント： https://immigrationdb.com/data/mcp/
• 入力スキーマ付きツールカタログ： https://immigrationdb.com/data/mcp/catalog.json
• 方法論： https://immigrationdb.com/methodology/
• エージェントインデックス： https://immigrationdb.com/llms.txt

このリポジトリには、ホスト型サーバーの公開仕様が含まれています。クライアント設定、入力スキーマ付きのツール一覧（tools.json）、レジストリのメタデータ（server.json）、依存関係のないスモークテストです。このサービスは上記のホスト型エンドポイントでのみ実行されます。データリリースは数ギガバイトあり、https://immigrationdb.com/data/mcp/ にファイルとして公開されています。

ツール

ツール	引数	機能
search_destinations	query、limit、cursor	国と都市を検索します。
resolve_city	query、limit	都市名に一致する候補を順位付けして返します。国が曖昧な場合、確認なしに選択することはありません。
get_city	country、slug、detail、metric_ids	主張レベルの事実と出典メタデータを含む、1 つの都市の情報を返します。
get_city_fact	country、slug、metric_id	値、単位、粒度、日付、出典を含む、1 つの事実のみを返します。
compare_cities	cities、metric_ids	互換性のある指標で都市を比較し、すべてのセルに出典情報を付けます。
search_facts	countries、filters、sort_metric、sort_order、limit、cursor、diagnostic	明示的な件数とともに、都市の事実に対する数値フィルターを実行します。
list_metrics	country、block、query、comparison_eligible、limit、cursor	指標の定義とカバー範囲を返します。
list_blocks	country、limit、cursor	カバー範囲付きの指標ブロックを返します。
get_country	cc	公式のビザルートへのリンクを含む、1 つの国のレコードを返します。
search_visa_routes	destination、purpose、limit、cursor	渡航先のビザと居住のルートを検索します。
get_legal_route	destination、route_id	公式の出典を含む、1 つのルートを返します。
search_entry_rules	passport、destination、purpose、limit、cursor	パスポートの入国規則を検索します。不明な回答は不明なまま明示します。
get_entry_rule	passport、destination	1 つのパスポートの入国規則を返します。
list_reports	category、limit、cursor	公開済みレポート（最大都市、最安の家賃、最もきれいな空気など）を返します。
get_report	report_id	行、手法、出典を含む、1 つのレポートを返します。

省略可能な引数は必須の引数とともに記載されています。完全な入力スキーマは tools.json をご覧ください。国の引数は ISO 3166-1 alpha-2 コード（de、lv、us）です。都市の引数には表示名ではなく、正規スラッグ（berlin）を使用します。すべてのツールには、読み取り専用かつ冪等であるという注釈が付いています。

リソース

• immigrationdb://country/{cc} — 国のレコードとルートへのリンク
• immigrationdb://city/{country}/{slug} — 出典メタデータ付きの都市情報
• immigrationdb://legal/routes/{country}/{route_id} — 1 つのビザまたは居住ルート
• immigrationdb://legal/entry/{passport}/{destination} — 1 つのパスポートの入国可否に関する回答
• immigrationdb://legal/entry/{passport} — パスポートに関するすべての入国可否の回答
• immigrationdb://report/{report_id} — レポートの行、手法、出典

クライアント設定

Streamable HTTP に対応する任意の MCP クライアント：

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

Claude Code：

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

stdio のみを使用するクライアントは、 mcp-remote 経由で接続できます： npx -y mcp-remote https://immigrationdb.com/mcp。

呼び出し例

{ "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" } }

レスポンスの契約

すべてのレスポンスには、スナップショット ID、生成日、正規のオリジンが含まれます。各事実の値、単位、地理的粒度、観測日、検証日、ソース ID、ソース URL、グレードは保持されます。不明または非公開の値はその旨を返し、推定することはありません。エラーには、要求された識別子とスナップショット ID が記載されます。レート制限とレスポンスサイズの上限は、クライアントごとに適用されます。

スモークテスト

Node 20 以降。インストール不要です。

node scripts/smoke.mjs                 # initialize, list tools, run six example calls
node scripts/smoke.mjs --write-tools   # also refresh tools.json from the live server

ライセンス

このリポジトリ内のファイルはMITライセンスです。ImmigrationDB のデータはCC BY 4.0の下で公開されています。ImmigrationDB をクレジット表記し、使用したページまたはリソースへのリンクを掲載してください。基となる公式ソースには、それぞれ独自の利用条件があります。各値には発行元とそのリンクが記載されています。

ImmigrationDB は独立した参考情報です。法的助言は提供せず、ビザや移民関連のサービスも販売していません。行動に移す前に、担当当局に最新の要件を確認してください。