Yatmo neighbourhood data for real estate

Yatmo MCP サーバー：AI アシスタントとエージェントのための近隣データ

Yatmo は、リモートの MCP サーバーを通じて、近隣情報を AI クライアントに提供します。Claude、Cursor、VS Code、または独自のエージェントを接続すると、「この物件の周辺には何がありますか？」という質問に、最寄りの学校、保育園、スーパーマーケット、公共交通機関、鉄道駅、高速道路へのアクセス、所要時間付きの距離、引用可能な要約段落などの実データを使って、25 か国で回答できます。

利用方法は 2 つあります。Yatmo が運用する https://mcp.yatmo.com/mcp/v1 のホステッドサーバー（Streamable HTTP、インストール不要）と、このリポジトリのローカル版（npx -y @yatmo/mcp、stdio）です。ローカル版は同じ 4 つのツールを提供し、お持ちのキーを使って Yatmo API を呼び出します。このリポジトリには、すぐにコピーできるクライアント設定とクイックスタートも含まれています。詳細なドキュメントはこちらです：documentation.yatmo.com/mcp。

4 つのツール

ツール	戻り値
yatmo_get_location_summary	人が読みやすい近隣の説明文と、最寄りの学校、保育園、スーパーマーケット、交通機関、および逆ジオコーディングされた場所
yatmo_get_nearby_pois	物件周辺の POI の一覧。カテゴリで絞り込み可能で、半径を指定できます
yatmo_get_nearest_by_category	指定カテゴリで最も近い場所 1 件。距離と所要時間を含みます
yatmo_get_accessibility_profile	公共交通機関の有無、最寄りの停留所、最寄りの鉄道駅、最寄りの高速道路へのアクセス

すべてのツールは latitude、longitude、country（BE、FR、UK など）、language を受け取り、同じ形式のデータを返します。 text（アシスタントが引用できる要約）、facts（構造化データ）、warnings、metadata が含まれます。カテゴリはどこでも共通の語彙を使います：school、nursery、supermarket、public_transport、train_station、motorway。詳細：ツールのリファレンス。

認証

各リクエストには、Yatmo のバックエンドキーを LicenceKey ヘッダーに含めます（LicenseKey も使用できます）。キーはクライアントのシークレットストアに保管し、公開ウェブページには絶対に置かないでください。このキーを使うと、Yatmo アカウントにアクセスできます。yatmo.com でキーを取得してください。キーの説明。

クライアントを接続する

ほとんどのクライアントが受け付ける汎用リモート MCP 設定（configs/mcp.json。クライアントによって親キーの名前が多少異なる場合があります）：

{
  "mcpServers": {
    "yatmo": {
      "url": "https://mcp.yatmo.com/mcp/v1",
      "headers": { "LicenceKey": "YOUR_KEY" }
    }
  }
}

Claude.ai と Claude Desktop：設定 > コネクタ > カスタムコネクタを追加を開き、URL https://mcp.yatmo.com/mcp/v1 とカスタムヘッダー LicenceKey: YOUR_KEY を設定します。コネクタを有効にすると、4 つのツールが表示されます。

Claude Code：

claude mcp add --transport http yatmo https://mcp.yatmo.com/mcp/v1 --header "LicenceKey: YOUR_KEY"

Cursor：configs/cursor/mcp.json をプロジェクト内の .cursor/mcp.json（または、すべてのプロジェクトで使う場合は ~/.cursor/mcp.json）にコピーします。

VS Code（Copilot エージェントモード）：configs/vscode/mcp.json を .vscode/mcp.json にコピーします。

独自のエージェント（Anthropic、OpenAI、または任意の LLM SDK）：Streamable HTTP トランスポートを使う MCP クライアントライブラリ（TypeScript、Python、.NET、Go）を使用し、トランスポートに LicenceKey ヘッダーを追加して、4 つのツール定義をモデルに渡します。quickstart.py では、ライブラリを使わずに生のプロトコルを確認できます。

ローカルで実行する（stdio）

ローカルプロセスを使いたい場合、またはコードを確認したい場合は、npm の @yatmo/mcp を使用します。Node.js 18 以降と、2 つの依存関係（公式 MCP SDK と zod）が必要です。ホステッドサーバーと同じツールを提供し、同じ JSON の回答を返します。キーは LicenceKey 環境変数から読み込まれ、Yatmo API にのみ送信されます。

{
  "mcpServers": {
    "yatmo": {
      "command": "npx",
      "args": ["-y", "@yatmo/mcp"],
      "env": { "LicenceKey": "YOUR_YATMO_KEY" }
    }
  }
}

リポジトリをクローンした場合は、npm install を実行してから、LicenceKey=YOUR_YATMO_KEY node src/index.js を実行します。テストは npm test です（実際の API 応答でマッピングを確認します）。ツール一覧の取得にキーは不要です。キーなしでツールを呼び出すと、401 の応答データが返されます。

コマンドラインから試す

export YATMO_KEY=your_backend_key
python3 quickstart.py          # initialize, list the tools, call yatmo_get_location_summary on a Brussels address
sh quickstart.sh               # the same three calls with curl

効果的なプロンプト

• "ベルギーの 50.8467, 4.3525 周辺はどのような地域ですか？フランス語で回答してください。"
• "この物件の最寄りの小学校とスーパーマーケットを、徒歩での所要時間とともに教えてください。"
• "この住所は公共交通機関の便が良いですか？最寄りの鉄道駅と高速道路へのアクセスを教えてください。"
• "物件から 800 m 以内にあるスポットを、学校とスーパーマーケットに限って一覧表示してください。"

アシスタントはツールの text と facts に基づいて回答します。距離には、測定時の移動手段が併記されます。

詳細

• クイックスタート、認証とエラーコード、よくある質問
• ウェブサイト向けの同じデータ：プラグイン、WordPress、Odoo、モバイル SDK、サンプル

このリポジトリのファイルには MIT ライセンスが適用されます。Yatmo は、不動産ポータル、代理店ネットワーク、開発者向けの有料サービスです。

ディレクトリ

このサーバーは、公式 MCP レジストリ（https://registry.modelcontextprotocol.io）に com.yatmo/yatmo（このリポジトリ内の server.json）として公開されており、Docker MCP Catalog、Smithery、mcp.so にも申請済みです。レジストリを参照するクライアントでは、「yatmo」または「real estate」で検索してください。