● Model Context Protocol · streamable-http · 18 ツール
bim.house MCP の使い方
AI エージェント (Claude 等) が建材カタログ検索・物件 (bim.json) 作成・建築基準法チェック・概算見積を直接実行できる MCP サーバーです。認証なしで読み取り・物件作成まで使えます。
エンドポイント
POST https://bim.house/mcp JSON-RPC 2.0 (initialize / tools/list / tools/call)
GET https://bim.house/mcp サーバー情報 (ツール名・プロトコル)
GET https://bim.house/.well-known/mcp ディスカバリ
CORS 開放。読み取り・
create_house は
認証不要（create_house は
既定で非掲載 private・レート制限あり。公開は
private:false を明示）。書き込み後の編集 (
set_visibility 等) は
create_house が返す
edit_token が必要です。
whoami に
Authorization: Bearer <APIキー> (
/console 発行) を付けるとアカウント紐付けも可能。
Claude Code に登録
claude mcp add --transport http bim-house https://bim.house/mcp
登録後はチャットで「弟子屈に平屋の物件を作って」のように頼むと
create_house が実行され、
viewer リンクが返ります。
ツール (18 個)
whoami 🔑chatsearch_catalogget_productlist_housesget_house_bimhouki_checkmaterial_quotecreate_house ✏️create_product ✏️update_product ✏️list_mine 🔑retire_product ✏️set_visibility ✏️list_land_listingsget_land_listingprobe_landbuild_on_land
✏️=書き込み (edit_token を返す/要する) ・ 🔑=API キー認証に対応
| ツール | 説明 |
|---|
whoami 🔑認証 | API キー認証の確認。Authorization: Bearer <APIキー> (/console で発行) を付けると認証済みアカウントの email を返す。Web/CLI どちらからでも使える。 |
chat | bim.house / MU の AI チャット。メール認証して /console で発行した API キーで認証必須 (Authorization: Bearer <APIキー>)。未チャージでも初回 ¥300 分 (5 回) は無料、使い切ったら /credits でチャージ。建築・BIM・法規・SIPs・MU について日本語で答える。引数 message (必須) と history (任意, [{role, content}])。 |
search_catalog | bim.house の建材・設備カタログ (3,900+ SKU) を検索。窓/断熱/設備/家具などを brand・category・キーワードで絞り込む。 |
get_product | SKU を指定して 1 製品の詳細 (価格・性能値 U値/η値・在庫・JAN・後継品) を取得。 |
list_houses | 運営 curated 公開物件 (有名建築・巨大ランドマーク・SOLUNA 等) の一覧。slug / 規模 / 要素数 / bim.json 充足率(%) を返す。ユーザー作成物件 (u-*) は既定では含まない (直リンクで個別取得は可)。include_user=true で公開ユーザー物件も含める。 |
get_house_bim | slug を指定して物件の完全な bim.json v1 (project メタ + elements 配列) を取得。include_elements=false でメタのみ。 |
houki_check | 建築基準法チェック (建ぺい率・容積率・北側/道路斜線・採光・換気) を houki-engine で実行し合否を返す。 |
material_quote | カタログ連携の概算見積もり。BIM 要素 takeoff × 建材カタログ実価格 (窓/ドア/設備) + 原単位 (躯体/仕上げ) で BOM・総額・㎡単価を算出し、各資材の納期 (lead_time_days) と在庫、クリティカルパス納期も返す。 |
create_house ✏️書込 | 新しい物件 (bim.json) を作成する。name か address のどちらか必須 — 住所だけ渡せば geocode で座標を引き「<地名>の家」と自動命名して家が建つ (REINFOLIB_KEY 設定時は用途地域も実値注入)。elements (bim.json v1 要素配列) を渡すとそのまま保存、省略すると敷地寸法から住宅 BIM を自動生成。name/rooms に「薪ストーブ・土間・ロフト・カーポート・書斎・ピアノ・サウナ」等の言葉が入ると対応する要素 (煙突・炉台・はしご込み) を自動配置し、寒冷地住所ならトリプルガラス+付加断熱+雪止めに外皮を格上げ。「平屋」「2階建て」も階数に反映。slug と edit_token、viewer/json/permit URL と適用 features・site (座標/用途地域ソース) を返す。 |
create_product ✏️書込 | 建材カタログ (products) に新しい製品 SKU を登録する。サッシ/窓/断熱材/照明/設備/家具/ドア等。Authorization: Bearer <APIキー> (/console で発行) が必須。登録後は /catalog と search_catalog に即反映。既存 SKU の上書きは不可 (insert-only)。 |
update_product ✏️書込 | 自分が create_product で登録した製品のフィールドを更新する。Authorization: Bearer <APIキー> 必須。他者/公式 SKU は更新不可。指定したフィールドのみ上書き。 |
list_mine 🔑認証 | 自分 (API キーのアカウント) が登録した製品の一覧を返す。Authorization: Bearer <APIキー> 必須。 |
retire_product ✏️書込 | 自分が登録した製品を取り下げる (生産終了化。ハード削除はしない)。Authorization: Bearer <APIキー> 必須。他者/公式 SKU は不可。 |
set_visibility ✏️書込 | 物件の掲載/非掲載を切り替える。edit_token (create_house の返り値) が必要。private=true で物件一覧から非掲載 (直リンクは残る)。進化ループの低スコア物件の淘汰などに使う。 |
list_land_listings | 現在販売中の土地 (SUUMO 実値ベース) の一覧を返す。価格・面積・用途地域・SUUMO リンク・座標 (geocode 済みのもの) を含む。max_price_jpy / min_area_m2 / q (住所・タイトル部分一致) で絞り込める。/earth 地図のオレンジピンと同じデータ。 |
get_land_listing | slug を指定して 1 件の売地の詳細 (価格・面積・用途地域・AI 設計提案・座標) を取得。座標が未解決の場合は lat/lng が null。 |
probe_land | 緯度経度を指定して、その土地の Site IQ (地形・日射・災害リスク・法規ヘッドルーム・気候の 5 軸スコア) を採点する。zoning (用途地域コード) を渡すと法規スコアが再計算される。/earth 地図クリックと同じ API。 |
build_on_land | 緯度経度 (と任意で用途地域・敷地面積・名前) を指定して、その土地に家を建てる (create_house に座標+法規を注入)。スカウト地・紹介・設計ロイヤリティの台帳にも記録される。/earth の「この土地に建てる」と同じ API。 |
例 1 — ツール一覧
curl -s https://bim.house/mcp -H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
例 2 — カタログ検索 (search_catalog)
curl -s https://bim.house/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"search_catalog","arguments":{"q":"断熱","limit":5}}
}'
例 3 — 法規チェック (houki_check)
curl -s https://bim.house/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"houki_check","arguments":{"slug":"tsugi-jitei"}}
}'
例 4 — 物件を作る (create_house)
curl -s https://bim.house/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"create_house","arguments":{
"name":"静寂の家",
"address":"北海道川上郡弟子屈町",
"structure":"杉CLT + 籾殻断熱",
"floors":1, "gross_m2":66, "construction_jpy":62000000,
"rooms":"瞑想土間 + 薪サウナ + 外気浴デッキ",
"private": false
}}
}'
| 引数 | 説明 |
|---|
name (必須) | 物件名 |
address / zoning / structure | 所在地 / 用途地域 / 構造 |
floors / gross_m2 / land_area_m2 | 階数 / 延床㎡ / 敷地㎡ |
construction_jpy / rooms | 概算工事費 円 / 室構成サマリー |
private | true で 物件一覧 に非掲載 (直リンクのみ)。既定 false=掲載。 |
elements | bim.json v1 要素配列 (省略時は敷地寸法から自動生成) |
返り値:
slug /
edit_token /
viewer_url /
json_url /
permit_url。public で作れば即
/property 一覧に並びます。作成後の掲載切替は
set_visibility (slug + edit_token + private) で。
関連
→ 物件一覧 ・ → REST API ドキュメント ・ → 建材カタログ ・ → bim.house トップ