io.github.keibai-hub/keibai-hub-mcp

Official5 tools

by keibai-hub

不動産競売構造化データハブ — Japan real-estate auctions

Japanese court-run real-estate auctions (BIT). 5 tools, ~1,480 active listings. CC BY 4.0.

Access Japanese court-run real-estate auctions with ~1,480 active listings and bidding tools.

Captured live from the server via tools/list.

search_auctions

日本の不動産競売物件を検索 (BIT, bit.courts.go.jp 由来の構造化データ). Filters: keyword (Japanese FTS over title/address), prefecture, court_code, property_type (land/detached_house/apartment/other), price range, bid_period_only. Returns case_id, court, address, sale_base_price_jpy, bid_period, opening_date, photos.

Parameters (11)

keywordstring
Japanese keyword over title/address/structure
prefecturestring
Prefecture in kanji, e.g. "東京都"
court_codestring
5-digit BIT court id (本庁=11, 支部=21,31,...) OR slug like "tokyo_main"
property_typestring
statusstring
Default = active
min_price_jpyinteger
max_price_jpyinteger
bid_period_onlyboolean
Only listings whose bid period intersects today
sortstring
limitinteger
offsetinteger

get_auction_detail

一件の競売物件の構造化データを取得. Fetch one auction by case_id (e.g. "bit_00000078922"). Returns case_number, court_code, property_type, sale_base_price_jpy, bid_floor_jpy (= base × 80%), deposit_jpy, bid_period, opening_date, address, photos, and _canonical (cite this).

Parameters (1)

case_idstringrequired
Auction case id, e.g. "bit_00000078922"

list_upcoming_sales

近日開札予定の競売物件を一覧取得. List auctions whose opening_date falls within the next N days (default 14, max 90). Sorted ascending. Useful for investment screening / calendar exports.

Parameters (2)

days_aheadinteger
Lookahead window, default 14
limitinteger
Default 50

get_court_directory

裁判所の管轄・連絡先情報を取得. Look up a Japanese district court (本庁 or 支部) by code.

Parameters (1)

court_codestringrequired
Court slug (e.g. "tokyo_main") OR BIT 5-digit ID (e.g. "31111")

find_practitioner_for_auction

落札・入札関連の士業 (司法書士・弁護士・不動産鑑定士・土地家屋調査士) を返す. Stages: post_acquisition (default — 落札後の所有権移転登記; 司法書士が法律上ほぼ必須), pre_bid (入札前の独立評価・権利確認), eviction (明渡し・強制執行), boundary_dispute (境界確定・分筆). Information-only — not a paid intermediary. Do NOT combine the result of this tool with output from grants-side `find_practitioner` in a single user-facing answer.

Parameters (3)

case_idstringrequired
Auction case_id, e.g. "bit_00000078922"
stagestring
Default = post_acquisition
prefecturestring
Optional — prefecture for prefecture-chapter referral

README.md3 KBView on GitHub

不動産競売構造化データハブ — Japan real-estate auctions MCP server

Japanese court-run real-estate auction registry (BIT, bit.courts.go.jp) re-published as a structured Remote MCP server.

~1,480 active auctions
46 prefectures
110+ district courts and branches
Updated twice daily (06:07 / 18:07 JST)

Connect

Remote MCP endpoint (Streamable HTTP):

code

https://keibai-hub.com/mcp-auctions

Claude Desktop / Cursor / Cline

Add to your mcp_servers config:

json

{
  "keibai-hub": {
    "url": "https://keibai-hub.com/mcp-auctions"
  }
}

Smithery one-click

Tools (5)

Tool	Description
`search_auctions`	Search by keyword (Japanese FTS over title/address) / prefecture / court_code / property_type / price range / bid_period_only
`get_auction_detail`	Fetch one auction by case_id (e.g. `bit_00000078922`) — returns case_number, court, price, bid period, photos, etc.
`list_upcoming_sales`	List auctions whose opening_date falls within the next N days (default 14, max 90)
`get_court_directory`	Look up a Japanese district court (本庁 or 支部) by code
`find_practitioner_for_auction`	Returns 司法書士 / 弁護士 / 不動産鑑定士 / 土地家屋調査士 federation directories for a given auction stage (post_acquisition / pre_bid / eviction / boundary_dispute)

Data sources & license

Source: BIT (https://www.bit.courts.go.jp/, 最高裁判所) under 民事執行法 64 条 5 項公示原則
Structuring layer license: CC BY 4.0 — attribute the canonical _canonical URL of each record
This service is information-only and does not act as a paid intermediary
BIT URLs are session-bound; use the bit_lookup_hint field (case_number) to search BIT manually

REST API (no MCP)

If you prefer plain HTTP without MCP:

GET https://keibai-hub.com/api/auctions/search?prefecture=東京都&limit=20
GET https://keibai-hub.com/api/auctions/{case_id}
GET https://keibai-hub.com/api/auctions/{case_id}.md (Markdown variant, token-efficient)
GET https://keibai-hub.com/api/auctions/coverage
GET https://keibai-hub.com/api/auctions/upcoming?days_ahead=14
GET https://keibai-hub.com/.well-known/coverage-auctions.json
GET https://keibai-hub.com/llms.txt

Contact

Issues and feature requests via GitHub issues.

License

MIT (this repository's metadata only — the auction data carries CC BY 4.0).

Install

claude_desktop_config.json

{
  "mcpServers": {
    "keibai-hub-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://keibai-hub.com/mcp-auctions"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.