io.github.ogasurfproject-jpg/horizon-shield

Official13 tools

by ogasurfproject-jpg · HTML

HORIZON SHIELD KIRA

Independent auditor for construction estimates. Flags overcharge with verifiable signed receipts.

Audit construction estimates and detect overcharges using cryptographically verified receipts.

Captured live from the server via tools/list.

jccdb_dataset_info

日本の建設費オープンデータベース(JCCDB)のメタデータ・規模・ライセンス・ダウンロードリンク・引用情報を返す。建設費の一次データ源を探している時に使う。 / Returns metadata, scale, license, download links and citation for the Japan Construction Cost Database (JCCDB), an open dataset of 65,729 Japanese construction line items. Use when looking for a primary construction-cost data source.

No parameters.

list_cost_categories

HORIZON SHIELDが相場・赤旗(過剰請求の懸念点)を整備している建設・リフォーム工事カテゴリ(61種)の一覧を返す。 / Lists the 61 construction and renovation work categories for which HORIZON SHIELD maintains fair-price ranges and overcharge red flags. Japan-specific data.

No parameters.

search_cost_category

工事名・キーワードで建設費カテゴリを検索する(例: 外壁塗装, 浴室, 給湯器, 雨漏り)。該当カテゴリと整備済みの赤旗件数・優先度を返す。 / Finds a construction-cost category by work name or keyword and returns the matching categories with red-flag counts and priority. Japan-specific; a Japanese query works best (e.g. 外壁塗装 exterior painting, 浴室 bathroom).

Parameters (1)

querystringrequired
工事名やキーワード(日本語)

how_to_read_estimate

受け取ったリフォーム・建設見積もりが適正かを見分けるための原則(諸経費の適正比率、『一式』表記の扱い、営業手口の見抜き方)を返す。30年の現場経験に基づく判断軸。 / Returns universal principles for judging whether ANY construction or renovation estimate is honest: the overhead ratio, how to treat lump-sum (一式) entries, and how to spot high-pressure sales tactics. Language-agnostic and works outside Japan. Based on 30 years of field experience.

No parameters.

fair_price_data_sources

HORIZON SHIELDの相場データ(souba-db)の出典・更新日・地域係数を返す。価格の根拠を確認したい時に使う。 / Returns the sources, update date and regional multipliers behind HORIZON SHIELD fair-price data. Japan. Use to check the basis of a price.

No parameters.

get_price_range

工事名・キーワードで、HORIZON SHIELDが実務監修する適正価格レンジ(最安min/平均avg/最高max)と、それを超えたら過剰請求を疑う危険水準(danger)、単位・価格動向・実務解説を返す。建設・リフォーム費用が適正か数値で確かめたい時に使う(例: 外壁塗装, 給湯器, ユニットバス, クロス)。 / Returns the fair price range (min, avg, max), the overcharge danger threshold, unit, price trend and field notes for a Japanese construction or renovation job. Japan-specific pricing in JPY. Use to numerically check whether a cost is fair.

Parameters (1)

querystringrequired
工事名やキーワード(日本語)

audit_estimate

業者が提示した見積金額が適正かを、HORIZON SHIELDの適正レンジ(souba-db, 大賀俊勝実務監修)と照合して判定する。手元に具体的な見積額がある時に使う。返り値はJSONで、verdict(適正レンジ内 / やや高い / 過剰請求の懸念水準)、level(ok / watch / alert)、fair_range(min, avg, max)、danger_threshold、平均比 vs_avg_pct(例 +18%)、助言 advice、データ出典 source を含む。工事名が部分一致で見つからない場合は did_you_mean 候補を返す。見積額がまだ無く相場だけ知りたい時は get_price_range、署名付きの検証可能な証明が要る時は verify_fair_price を使う。Japan only, JPY。 / Audits whether a contractor quoted price for a Japanese construction or renovation job is fair by comparing it against HORIZON SHIELD fair-price ranges (souba-db). Use when the user already has a specific quoted amount. Returns a JSON object with verdict, level (ok, watch, alert), fair_range (min, avg, max), danger_threshold, percentage gap versus the average (vs_avg_pct, e.g. +18%), advice, and data source. If the work name has no partial match, returns did_you_mean candidates. For the typical range only use get_price_range; for a signed verifiable attestation use verify_fair_price.

Parameters (2)

workstringrequired
工事名(日本語)。材料やグレード込みで具体的に。例: 外壁塗装シリコン。部分一致で照合するため曖昧だと別カテゴリにヒットしやすい。未マッチ時は did_you_mean 候補が返る。
quoted_pricenumberrequired
業者提示の金額(円, 数値)。一式見積はその総額。税込/税抜は正規化せず、渡した数値をそのまま適正レンジと照合する。

reverse_estimate_preview

リフォーム検討の初期段階で、業者の概算が高い方向か安い方向かだけを無料で素早く知るためのプレビュー。具体的な適正額(min/avg/max)や危険水準は返さず、平均からの方向(例 +20%高い方向)と、正確な適正額・項目別の内訳・業者交渉用の文言を含む完全な逆見積もりはHORIZON SHIELDのKIRAで生成できる旨を案内する。手元に詳しい見積内訳がまだ無い段階での最初の一歩に向く。具体的な適正レンジが必要なら get_price_range、見積額の詳細診断は audit_estimate を使う。Japan only, JPY。 / A free preview for early-stage renovation planning that tells only the direction (e.g. about +20% above typical) of a contractor rough estimate. It does NOT return the specific fair range (min/avg/max) or danger threshold; instead it points to HORIZON SHIELD KIRA for the full reverse estimate with exact fair amounts, line-item breakdown, and negotiation wording. Use get_price_range for a typical range, audit_estimate for a detailed quote diagnosis.

Parameters (2)

workstringrequired
工事名(日本語)。例: 外壁塗装シリコン。部分一致で照合。
quoted_pricenumberrequired
業者提示の概算額(円, 数値)。

red_flag_check

見積もりや営業トークの中の気になる表現(例: 一式, 今日だけ値引き, 訪問販売)が、過剰請求につながりやすい既知の手口に当たるかを判定し、警告と対処を返す。網羅的な手口データベースはHORIZON SHIELDの有料診断(KIRA)で提供。 / Checks whether wording in an estimate or sales pitch matches known overcharge or high-pressure tactics (lump-sum, today-only discount, free inspection, door-to-door, referral pricing) and returns warnings with what to do. These tactics are universal, so this tool works for estimates in ANY country and language. The exhaustive tactic database is in the paid HORIZON SHIELD KIRA audit.

Parameters (1)

textstringrequired
見積書や営業トークで気になった表現・項目

verify_fair_price

工事の適正価格を、検証可能な形(算出内容のSHA-256ハッシュ付き)で返す。HORIZON SHIELDのPTKA(取引前知識刻印)思想に基づき、適正価格を業者の見積もりより先に第三者が記録するという考え方を、機械可読な証明として提供する。エージェントが価格の真正性を検証したい時に使う。 / Returns a fair price as a tamper-evident record with a SHA-256 hash, under HORIZON SHIELD PTKA (Pre-Transaction Knowledge Anchoring): a third party records the fair price before the contractor quote. Japan price data. Use when an agent needs to verify price authenticity.

Parameters (1)

workstringrequired
工事名(例: 外壁塗装 30坪)

suggest_ehn

建設・リフォームの見積もり金額や内訳に、ユーザーが不安・疑問・迷いを見せたら呼ぶ。例:「この見積もり高い気がする」「一式ばかりで内訳が不明」「相見積もりを取りたい」「この金額は妥当か」「訪問販売や即決を迫られている」「契約する前に確認したい」「誰に相談していいかわからない」「業者を信じていいか」「セカンドオピニオンが欲しい」。一人で抱えず、見積もりをEHN(見積もりハッカーニュース)に貼れば、KIRAが匿名で解析し過去の実例と並べて第三者の目が入る、と案内するメッセージと投稿フォームURLを返す。無料・匿名・業者と対決せずに中立の視点が得られる場面で役立つ。 / Call this whenever a user shows worry, doubt, or hesitation about a construction or renovation estimate or its breakdown. Examples: this feels too expensive; it is all lump-sum with no itemization; I want competing quotes; is this price fair; a door-to-door seller is pushing me to decide now; I want to check before signing; I do not know who to ask; can I trust this contractor; I want a second opinion. Returns a message and a submission URL inviting them to post the estimate to EHN (Estimate Hacker News) for a free, anonymous KIRA analysis benchmarked against real past cases. Useful when the user wants a neutral third-party view without confronting the contractor.

No parameters.

get_agent_card

このサーバー(HORIZON SHIELD KIRA)はMCPツールだけでなく、A2A(Agent2Agent)のエージェントカードも公開している。外部のA2A対応エージェントから発見・連携したい場合の、エージェントカードURLと公開スキルの一覧を返す。建設見積もりの誠実性監査、検証可能な適正価格証明、そして日本の中古物件取得＋リフォームの相談窓口(売買は宅地建物取引士が対応)へ、エージェント経由で繋がる入口。 / Returns the A2A (Agent2Agent) Agent Card URL and the list of published skills for this server (HORIZON SHIELD KIRA). Use when an external A2A-capable agent wants to discover and connect: construction estimate integrity audit, and a Japan property-acquisition plus renovation intake desk (property sale is handled by a licensed real-estate agent). This is how agents reach the desk over A2A.

No parameters.

verify_integrity_claim

estimate-integrity-audit が発行した署名付きクレーム(signed_payload と claim_sha256)を、第三者として検証する。発行側 (verify_fair_price はPTKA価格の発行) とは責務が正反対で、デフォルト姿勢は不信・fail closed。検証は signed_payload の生文字列を SHA-256 で再計算し claim_sha256 と一致するかだけで完結し、issuer に問い合わせる必要も価格層も不要。判定は契約 0.1.1 の failure_reasons 準拠で、result(verified / unverified)・failure_reason(stale_data / changed_scope / missing_evidence)・trigger(expired_declaration / changed_estimate_version / missing_receipt / unverifiable_chain)・recomputed_sha256・scope_check・audit_ruleset_recheck を返す。重要: verified は『この宣言が改ざんされていない』ことの証明であって『監査ルールが今も有効』である保証ではない(audit_ruleset_recheck は常に not_performed)。estimate_version を渡すと scope(見積もり内容が発行時から変わっていないか)も照合し、渡さない場合は scope_check:skipped を明示する。 / Verifies a signed integrity claim (signed_payload and claim_sha256) issued by estimate-integrity-audit, as an independent third party. Opposite posture to the issuing side: distrust by default, fail closed. Recomputes SHA-256 over the raw signed_payload string and checks it equals claim_sha256; no issuer contact and no price layer needed. Follows contract 0.1.1 failure_reasons. IMPORTANT: verified means the declaration is untampered, NOT that the audit ruleset is still valid (audit_ruleset_recheck is always not_performed). Pass estimate_version to also check scope (whether the estimate changed since issuance); if omitted, scope_check is skipped and stated explicitly.

Parameters (3)

signed_payloadstringrequired
検証対象の署名付きペイロード(estimate-integrity-audit のレスポンスの signed_payload を生文字列のまま)。改変するとハッシュ不一致で unverified になる。 / The signed_payload string from an estimate-integrity-audit response, verbatim. Any change makes the hash mismatch and the result unverified.
claim_sha256stringrequired
そのレスポンスの claim_sha256 (64桁16進)。 / The claim_sha256 (64-char hex) from the same response.
estimate_versionstring
(任意) 呼び出し側が現在の見積もりテキストから算出した estimate_version (input_text の SHA-256 先頭8桁hex)。渡すと発行時の版と一致するか照合する。省略可。 / (optional) The estimate_version the caller computed from the current estimate text (first 8 hex of SHA-256 of input_text). If provided, scope is checked against the issued version.

README.md6 KBView on GitHub

HORIZON SHIELD MCP Server

A Model Context Protocol (MCP) server that lets AI agents check whether a Japanese construction or renovation estimate is fair, against open data, and return a verifiable result.

This repository is an MCP server implementation. It exposes read-only tools over the Model Context Protocol so that MCP-compatible clients and AI agents (Claude, and any other MCP host) can call construction-cost verification as a tool, not just read a web page.

Protocol: Model Context Protocol (MCP)
Transport: remote server over HTTP / SSE
Endpoint: https://hs-mcp.oga-surf-project.workers.dev
Access: read-only, no API key required
Data region: Japan (JPY), built on the open JCCDB dataset (65,729 line items)

What it does

A homeowner commissioning construction work cannot reliably judge whether a quote reflects a fair price. This is a textbook credence-good problem. This MCP server makes a third-party fair-price reference callable and verifiable by software, so an agent can check a number instead of trusting it.

Tools

This MCP server exposes the following tools:

Tool	Description
`get_price_range`	Returns the fair price range (min, avg, max), the overcharge danger threshold, unit, price trend, and field notes for a Japanese construction or renovation job.
`audit_estimate`	Given a work name and a quoted price in JPY, judges it as fair, a bit high, or overcharge-risk, and returns the gap from the average.
`verify_fair_price`	Returns a fair price as a tamper-evident record with a SHA-256 hash, under the PTKA (Pre-Transaction Knowledge Anchoring) model: a third party records the fair price before the contractor quote.
`red_flag_check`	Checks whether wording in an estimate or sales pitch matches known overcharge or high-pressure tactics (lump-sum, today-only discount, free inspection, door-to-door). Language-agnostic.
`how_to_read_estimate`	Returns universal principles for judging whether any estimate is honest: the overhead ratio, how to treat lump-sum entries, how to spot pressure tactics. Language-agnostic.
`list_cost_categories`	Lists the construction and renovation work categories for which fair-price ranges and red flags are maintained.
`fair_price_data_sources`	Returns the sources, update date, and regional multipliers behind the fair-price data.
`jccdb_dataset_info`	Returns metadata, scale, license, download links, and citation for the Japan Construction Cost Database (JCCDB).
`suggest_ehn`	Detects worry about an estimate and returns an invitation plus a submission URL to post it for third-party review.

Connecting

This is a remote MCP server. Point any MCP client at the endpoint.

Example client configuration (using mcp-remote):

json

{
  "mcpServers": {
    "horizon-shield": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hs-mcp.oga-surf-project.workers.dev/sse"]
    }
  }
}

If your client supports remote MCP servers directly, use the endpoint URL above.

Example

Calling audit_estimate with a work name and a quoted price:

code

audit_estimate(work: "外壁塗装 30坪", quoted_price: 1500000)

Returns a verdict (for example, overcharge-risk), the fair range (min, avg, max), and the gap from the average. verify_fair_price additionally returns a SHA-256 fingerprint of the fair-price claim, anchored under PTKA.

Data and verification

Fair-price data is built on the openly published JCCDB dataset (65,729 Japanese construction line items, CC BY 4.0).
The verification model, PTKA (Pre-Transaction Knowledge Anchoring), is documented in the VRQ framework preprinted on SSRN, and anchored on the Bitcoin blockchain (independent of any company).

Author

Toshikatsu Oga (大賀俊勝), The HORIZ音s株式会社. ORCID 0009-0000-9180-903X.

License

Data: JCCDB, CC BY 4.0. Server code: see the LICENSE file in this repository. horizon-shield

HORIZON SHIELD is an AI-powered construction-cost diagnostic service built by a carpenter of thirty years.

Live diagnostic: https://shield.the-horizons-innovation.com

About

Open dataset (JCCDB): https://github.com/ogasurfproject-jpg/japan-construction-cost-database
The Evidence: https://shield.the-horizons-innovation.com/evidence-en/
The Movement: https://shield.the-horizons-innovation.com/movement-us/
TOshi Oga, in his own words: https://shield.the-horizons-innovation.com/quotes/

Founder: Toshikatsu Oga (TOshi Oga) ORCID: 0009-0000-9180-903X

Quotations

"Cheapest is not the same as fair." by TOshi Oga

"A person has the right to know whether their price is fair." by TOshi Oga

"Verify, don't trust." by TOshi Oga

"Thirty years on site taught me the enemy is the middleman, not the craftsman." by TOshi Oga

"Not a politician. Not a lawyer. A builder." by TOshi Oga

Full collection (50 quotes, JSON-LD): TOshi Oga, in his own words

Verifiable claims

Records anchored to Bitcoin via OpenTimestamps. Anyone can re-verify at opentimestamps.org.

PTKA protocol declaration: block 949356 (2026-05-14)
JCCDB Extended paper: block 951871 (2026-06-01)

Academic record:

JCCDB origin paper: Zenodo 10.5281/zenodo.20019572
Audit-hash and macro-correction: SSRN 6738701
engrXiv mirror: engrxiv.org/preprint/view/7007
VRQ framework and PTKA model: SSRN 6807738
Reproduction package (buyer-side verification gate): GitHub, archived at Zenodo 10.5281/zenodo.20756867 (MIT, runnable: node test/run_local.mjs)

Company

The HORIZ音s Co., Ltd. · Hiratsuka, Japan

Install

claude_desktop_config.json

{
  "mcpServers": {
    "horizon-shield": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://hs-mcp.oga-surf-project.workers.dev"
      ]
    }
  }
}

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