HORIZON SHIELD YAKUMO (verified contractor directory)

io.github.ogasurfproject-jpgPublished by GitHub account ogasurfproject-jpgv2.3.1Updated Oct 25, 2026

Neutral, verification-gated MCP directory of Japan construction contractors (KIRA-audited).

The publisher's own server: verified.fyi

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

A remote MCP directory that lets an assistant look up KIRA-audited Japanese renovation and construction contractors by area and trade, with integrity scores but

What you can do
Search and match verified contractors from a free-text request, inferring area and trade, with fallbacks to fair-price and third-party-check resources when nothing matches. List verified stores filtered by area and work, with pending stores returned separately. Read a single contractor's verified profile by member number. Summarize the directory's verified count, work categories, areas and verification method. Explain how the KIRA audit works, including fair-price checks, red-flag detection, scores, tiers and fail-closed listing. Check a contractor named by the user, returning measured results only for member stores and public inquiry contacts otherwise.
When to use it
Useful when a homeowner or advisor wants to find or vet Japanese renovation and construction contractors, compare integrity scores and tiers, or understand what a verified listing means. It is Japan-only and returns no prices.
Requirements
A remote Streamable HTTP endpoint; no package, account, API key or environment variable is declared. Network access to the endpoint is required.
Before you install
Read-only lookups; no tool writes, sends or deletes data. No prices are returned, only scores and tiers. A contractor absent from the directory is not an evaluation of that company, and the final judgment is left to the homeowner. Queries are sent to the operator's remote service.

Installation

In SourceWeft

  1. Open HORIZON SHIELD YAKUMO (verified contractor directory) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.ogasurfproject-jpg%2Fhs-hearing/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "horizon-shield-yakumo-verified-contracto": {
      "type": "http",
      "url": "https://hearing.horizonshield.dev/mcp"
    }
  }
}

README

HORIZON SHIELD YAKUMO

A neutral, verification-gated MCP directory of Japanese renovation and construction contractors.

Yakumo is the contractor-directory layer of HORIZON SHIELD. Only stores that pass an independent fair-price and overcharge audit (KIRA) are listed. Prices are never exposed, only integrity scores and tiers, and unverified stores are never shown to homeowners (fail-closed). Yakumo takes no referral fees from contractors.

  • MCP endpoint: https://hearing.horizonshield.dev/mcp (Streamable HTTP, POST JSON-RPC)
  • Registry: io.github.ogasurfproject-jpg/hs-hearing
  • Operator: The HORIZONs株式会社 / supervised by 大賀俊勝 (Toshikatsu Oga, 30 years in construction, ORCID 0009-0000-9180-903X)
  • Backing dataset: JCCDB, an open construction-cost database of 95,403 items (CC BY 4.0)

Tools

ToolWhat it does
find_contractorFree-text discovery orchestrator. Give it a request like "a trustworthy exterior-painting contractor in Aichi" and it infers the area and trade and returns verified stores, or points to fair-price and third-party-check resources if none match.
list_verified_storesList verified contractors, filterable by area and work. Returns integrity scores and tiers, never prices. Unverified stores are returned separately as pending_stores.
get_contractor_profileFull verified profile for one store by member_no (e.g. No.001).
mall_overviewThe directory at a glance: verified count, work categories, areas, verification method, key links.
how_verification_worksExplains the KIRA audit: fair-price checks, red-flag detection, integrity score and tier, signed receipts, continuous monitoring, fail-closed.

All tool output is JSON. Prices are never returned; trust is expressed as integrity scores (0-100) and tiers (A-F).

Resources

  • yakumo://mall: mall overview (JSON)
  • yakumo://verification: how verification works (Markdown)
  • yakumo://categories: work categories and areas in the directory (JSON)
  • yakumo://store/{member_no}: a single store profile (template)

Prompts

  • find_a_contractor (area, work): guided flow to discover and vet a verified contractor
  • is_this_store_trustworthy (member_no): guided flow to check a store's verification and explain what "verified" guarantees

Argument autocompletion is provided for area and work via completion/complete.

Web widget (WebMCP)

Any site can embed the discovery widget with one line:

html
<script src="https://hearing.horizonshield.dev/embed.js" async></script>

It renders a Shadow-DOM-isolated panel where a visitor searches verified contractors by area and trade. It stores nothing and shows no prices, only scores and tiers, with links back to the mall and to a free anonymous estimate check.

Discovery and standards

  • GET /.well-known/agent-card.json: A2A agent card
  • GET /.well-known/security.txt: RFC 9116 contact
  • GET /.well-known/glama.json: Glama connector metadata
  • Transport compliance: GET/DELETE on /mcp return 405, unsupported MCP-Protocol-Version returns 400, notifications return 202, unknown methods return -32601.

How verification works

Listing is decided only by whether a store passes the independent KIRA audit:

  1. Real estimate examples are checked against the open construction-cost database (JCCDB) and souba-db to verify fair pricing.
  2. Overcharge red flags are detected: lump-sum ("一式") line items, inflated overhead, high-pressure same-day closing.
  3. Each trade gets an integrity score (0-100) and tier (A-F). One overcharged trade lowers the whole result.
  4. A signed receipt (SHA-256) is attached so anyone can recompute the basis.
  5. Pricing is monitored after listing; drift alerts the operator.
  6. Stores that do not pass are never shown to homeowners (fail-closed).

Actual amounts are never published to homeowner-facing pages; they are expressed through scores, tiers, and verification. The final judgment is the homeowner's.

License

Code: see the repository root. Dataset (JCCDB): CC BY 4.0.

Links

Source: workers/hs-hearing/README.md at commit 21012e4

Tools

6

list_verified_stores

検証済み加盟店の一覧

Yakumo モールで検証を通過した加盟店(工務店・リフォーム店)を一覧する。適正価格の検証と過剰請求チェック(KIRA)を通過した店だけが返る。area(地名)や work(工種)で絞り込める。返り値は member_no / 会社名 / 地域 / 対応工種 / 適正度スコア / 誠実度ティア / プロフィールURL。金額は含まない(スコアとティアのみ)。検証手続き中の店は verification:'pending' として区別される。Japan only.

Parametersareawork

get_contractor_profile

加盟店プロフィール取得

Yakumo の加盟店1件の検証済みプロフィールを返す。member_no(例 No.001)で指定。会社名・地域・対応工種・適正度スコア・誠実度ティア・検証状態・プロフィールURLを返す。金額は含まない。検証が済んでいない店は verification:'pending' を返す(スコアは出さない=fail-closed)。

Parametersmember_norequired

find_contractor

検証済みの職人を探す(司令塔)

施主の相談文(自由記述)から Yakumo の検証済み加盟店を探す司令塔。need(例:『愛知県で外壁塗装できる信頼できる業者』)を渡すと地域と工種を推定し、検証を通過した店を返す。該当が無ければ相場(souba)や無料の第三者チェック(EHN)への導線を返す。金額は返さない(スコア・ティアのみ)。紹介料なし・verified-first・Japan only。

Parametersneedrequired

mall_overview

モール概要

Yakumo モール全体の要約を返す。検証済み加盟店の数・対応工種カテゴリ・地域・検証の仕組みの要点・主要リンク(モール/加盟/相場/実例ボード)。AIが Yakumo というモール/MCP を一言で説明するための入口。金額は含まない。

Takes no parameters.

how_verification_works

検証の仕組み

Yakumo の掲載審査(KIRA適正診断)がどう機能するかを返す。適正価格の検証・過剰請求の赤旗検出・適正度スコアと誠実度ティア・再計算できる署名レシート(SHA-256)・掲載後の継続監視・fail-closed(通らない店は施主向けに一切出さない)・中立(紹介料なし)。施主が『検証済み』の意味を理解するための説明。

Takes no parameters.

check_named_contractor

名指しの業者を照会

施主が名前を挙げた業者について答える。Yakumoの加盟店ならその測定結果を返す。加盟していない場合、その会社の良し悪しは一切判定せず、『Yakumoは測っていない』という事実だけを返し、施主が自分で確かめられる公的な照会先(国土交通省の建設業者検索・国民生活センター・住まいるダイヤル)と、同条件の検証済み加盟店を返す。掲載が無いことはその会社への評価ではない。金額は返さない。紹介料なし。Japan only。

Parametersareaworkcompanyrequired

Version history

1
  1. v2.3.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Verified integrations