Cenogram - Polish Real Estate Prices & Parcel Data

Cenogram MCP Server

AI 向けポーランド不動産取引・区画データ

ポーランドの不動産データにアクセスするための MCP サーバーです。国立価格・価値登録簿（Rejestr Cen Nieruchomosci、RCN）に登録された800万件以上の不動産取引に、Claude、Cursor、ChatGPT、Grok、または MCP 互換の AI アシスタントから直接アクセスできます。掲載価格ではなく、公証人作成の証書に基づく価格です。取引価格に加え、地籍区画を特定して区画ごとの情報を提供します。用途地域、洪水・地滑りリスク、文化財登録簿、建築許可と建設活動、公共交通機関へのアクセス、農地の分類、周辺の土地利用、自然環境（近隣の森林および重複する保護区域）、地下にあるもの（鉱区および主要な地下水貯留層）、土地利用と土壌品質の分類、道路へのアクセスが含まれます。

データソース：ポーランド国立 RCN 登録簿（Rejestr Cen Nieruchomosci） | プラットフォーム：cenogram.pl

API キーを取得する

1. cenogram.pl/api にアクセスします
2. メールアドレスを入力します
3. メールで cngrm_... API キーが届きます

キーは cenogram.pl/ustawienia で管理できます。

無料枠

新規アカウントには、1,000トークンと Standard プランの14日間トライアルが付与されます。その後もキーは週50トークンで利用できます。残高は蓄積されず、7日ごとに50に回復します。有効期限はなく、カードも不要です。

統計、参照データ、区画の識別、自治体の情報は1トークン、取引検索は3トークン（リストとその要約。summaryOnly を指定した場合は1トークン）、価格ヒストグラムまたは区域内の区画一覧は2トークン、区画または取引のコンテキストレイヤー1つは4トークン、空間検索、区画の輪郭、評価額、複数地区の比較は5トークンかかります。すべてのレイヤーを一度に返す get_parcel_report は45トークンです。位置情報のカタログは無料です。有料プランでは利用枠が増えます。詳しくは cenogram.pl/api をご覧ください。

インストール

クライアントを選択してください。以下のすべてのオプションはホスト型サーバーを使用するため、ローカルへのインストールは不要です（npx/stdio を除く）。

claude mcp add cenogram https://mcp.cenogram.pl/mcp \
  -t http -H "Authorization: Bearer YOUR_API_KEY"

[mcp_servers.cenogram]
url = "https://mcp.cenogram.pl/mcp"
bearer_token_env_var = "CENOGRAM_API_KEY"

export CENOGRAM_API_KEY=cngrm_...

[mcp_servers.cenogram]
url = "https://mcp.cenogram.pl/mcp"

codex mcp login cenogram

{
  "mcpServers": {
    "cenogram": {
      "type": "http",
      "url": "https://mcp.cenogram.pl/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "cenogram": {
      "command": "npx",
      "args": ["-y", "@cenogram/mcp-server@latest"],
      "env": {
        "CENOGRAM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "cenogram": {
      "type": "http",
      "url": "https://mcp.cenogram.pl/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "cenogram": {
      "type": "http",
      "url": "https://mcp.cenogram.pl/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "cenogram": {
    "type": "http",
    "url": "https://mcp.cenogram.pl/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

{
  "mcpServers": {
    "cenogram": {
      "command": "npx",
      "args": ["-y", "@cenogram/mcp-server@latest"],
      "env": {
        "CENOGRAM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

設定

MCP_TRANSPORT=http の代わりに、--http CLI フラグを使用することもできます。

ヒント

• モデルの選択：最良の結果を得るには、Claude の Opus を使用してください。連続してより多くのツール呼び出しを行い、より豊かな分析を生成します。チャットウィンドウ下部のドロップダウンからモデルを切り替えられます。

プロンプトの例

ポーランド語：

• "Jaka jest mediana cen mieszkan w Krakowie w 2025?"
• "Pokaz transakcje z ulicy Pulawskiej 15 na Mokotowie"
• "Znajdz transakcje na dzialce 126104_9.0015.201"
• "Sprawdz plan miejscowy i ryzyko powodziowe dla dzialki 126104_9.0015.201"
• "Znajdz transakcje gruntow w promieniu 5km od centrum Wroclawia powyzej 500 000 PLN"
• "Porownaj ceny mieszkan na Mokotowie i Woli"
• "Pokaz rozklad cen nieruchomosci w Polsce"

英語：

• "What's the median apartment price in Krakow in 2025?"
• "Show transactions at Pulawska 15 in Mokotow"
• "Find all transactions on parcel 126104_9.0015.201 and then search nearby"
• "Check the zoning and flood risk for parcel 126104_9.0015.201"
• "Find land transactions within 5km of Wroclaw center above 500,000 PLN"
• "Compare apartment prices in Mokotow and Wola districts"
• "Show the price distribution of real estate in Poland"

ツール

場所の命名

• ほとんどの都市：都市名をそのまま使用します（例：「Gdansk」、「Lublin」）。
• ワルシャワ：「Warszawa」は18のすべての地区を一括で対象にします。範囲を絞るには、1つの地区名（「Mokotow」、「Srodmiescie」、「Wola」）を指定します。
• クラクフとウッチも同様です。都市名を指定するとすべての地区が対象になり、地区名（「Krakow-Podgorze」）を指定することもできます。
• 近隣地域名は行政区画ではありません。代わりに、半径またはポリゴンで検索してください。
• 有効な名前を調べるには、list_locationsを使用します。

物件タイプ

ワークフロー

検索結果には区画IDとGPS座標が含まれるため、複数の手順にわたる調査が可能です。

1. Search by address    -> search_transactions(location="Mokotow", street="Pulawska", buildingNumber="15")
2. Note parcel_id and coordinates from results
3. Search nearby        -> search_by_area(lat=52.19, lng=21.01, radiusKm=2, propertyType="unit")
4. Compare prices       -> get_price_statistics(location="Mokotow")

これは、不動産鑑定士が評価レポート用の類似取引を探す方法を再現しています。

権利証書ではなく土地から始める場合は、別の手順になります。

1. List the parcels     -> list_parcels_in_area(location="Wawer", minArea=800)
2. Draw the ones you want -> list_parcels_in_area(bbox="21.10,52.20,21.14,52.23", includeGeometry=true)
3. Open one in full     -> get_parcel_report(parcelId="146518_8.0108.27")

ステップ1ではカーソルを使ってページを取得します。ステップ2には上限があり、通常は結果が途中で切り詰められるため、切り詰められた回答をそのエリアの区画一覧として読み取るのではなく、ボックスの範囲を狭めてください。

データ

• 800万件以上の取引：ポーランド全土（380郡）
• 期間： 2003年〜現在
• 出典： ポーランド国立RCN登録簿（Rejestr Cen Nieruchomosci）
• 更新： RCNから定期的に更新
• 区画ごとのコンテキスト： ゾーニング、洪水および地滑りリスク、文化財登録簿、建築許可および建設活動、公共交通機関へのアクセス、農地利用、周辺環境、自然環境（近隣の森林や保護地域）、地下環境（鉱山地域および主要な地下水貯留層）、土地利用および土壌品質の分類、道路へのアクセス。これらは地籍IDで参照できます。

トラブルシューティング

「Error: CENOGRAM_API_KEY is required」 - これはstdioモードの場合にのみ該当します。MCP設定のenvブロックでCENOGRAM_API_KEYが設定されていることを確認してください。HTTPリモートの場合は、代わりにAuthorizationヘッダーにキーを指定します。

npxがハングする、または失敗する - node -vでNode.jsのバージョンを確認してください。stdioモードにはNode.js >= 18が必要です。古いバージョンを使用している場合は、代わりにHTTPリモートオプションを使用してください（Node.jsは不要です）。

場所を指定しても結果が0件になる - その名前は行政区画ではない可能性があります。地区と近隣地域は別のものです。「Mokotow」は地区なので使用できますが、その中の近隣地域である「Sluzew」は使用できません。有効な名前を調べるにはlist_locations(search="...")を使用するか、地区より小さい範囲を調べる場合は半径で検索（search_by_area）してください。

401 Unauthorized（HTTPモード） - サーバーは、APIキー（Authorization: Bearer cngrm_...。Bearerプレフィックスとキー全体が必要で、プレフィックスだけではありません）または、OAuthサインインを完了したクライアントからのOAuthアクセストークンを受け付けます。トークンがない場合、または認識されない形式の場合は、cenogram.pl/apiへのリンクを含む本文とともに401が返されます。このページでキーを取得できます。キーもOAuthログインもないクライアント（たとえばCodex CLI）は、すべてのリクエストで401になります。上記のセットアップを参照してください。

402 Payment Required - アカウントのトークンを使い切っています。無料アカウントの場合、残高が週50に戻る日付がレスポンスに表示されます。それまではキーと接続は有効です。有料プランでは上限が解除されます。cenogram.pl/apiを参照してください。

開発

git clone https://github.com/cenogram/mcp-server.git
cd mcp-server
npm install
npm test
npm run build

ライセンス

MIT