Skip to main content
Glama

HORIZON SHIELD: Construction Estimate Auditor for Japan (KIRA)

一文で聞けば、正しい窓口に繋ぐ

route_request
Read-onlyIdempotent

Check whether a construction or renovation quote in JAPAN is fairly priced, against 95,403 open catalogue items and Bitcoin-anchored verification records. Single entry point: pass one sentence. USE WHEN: the user has a quote or a price for building/renovation work in Japan and wants to know if it is reasonable; or wants to check a HORIZON SHIELD receipt or a jidec: citation; or asks about overcharging tactics used by contractors; or is looking for a verified contractor. DO NOT USE WHEN: the work is outside Japan; the question is not about construction or renovation; the user has already signed or paid and needs consumer-protection help; or there is an active emergency (gas smell, collapse, water not stopping). In those cases this tool does not answer - it returns the appropriate outside destination instead, and says so. Every reply carries verify (a URL that checks the answer) and limits (what the answer does NOT prove). Routing is a deterministic keyword table, not an LLM, so the same input always routes the same way. Examples: "is 800,000 yen high for exterior wall painting?" / "is jidec:entry:9 genuine?" / "how do I refuse a door-to-door sales pitch?" 日本の建設・リフォーム見積もりが適正かを確認する単一入口。日本語の一文で渡してよい。適正診断・台帳(JIDEC)の記録検証・過剰請求の手口・検証済み加盟店の4方向へ決定的に振り分ける。日本国外/建設以外/契約後の紛争/緊急時は**答えずに適切な外部の窓口を返す。**返り値には必ず verify(検証URL)と limits(証明していないこと)が入る。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
askNoやりたいことを一文で。例:「外壁塗装80万は高いですか」「jidec:entry:9 は本物ですか」
refNo(任意)検証したい引用ID。jidec:entry:N / 64桁hex / エントリ番号
workNo(任意)工事名。分かっているなら渡すと推測を挟まない。
amountNo(任意)業者提示の金額(円)

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYesWhether the request was handled.
nextNoTool names to call next.
limitsNoWhat this answer does NOT prove. Always present.
resultNoThe answering desk's payload.
verifyNoURL where the caller can recompute and check the claim.
messageNoReason when ok is false.
routed_outNoTrue when the question was routed to an external desk rather than answered here.
answered_byNoWhich desk answered: the router itself, an internal audit, the ledger, or a guide fallback.

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Added

TDQS

A4.5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and idempotentHint=true, and the description adds substantial behavior beyond that: it reveals the tool is 'a deterministic keyword table, not an LLM, so the same input always routes the same way', guarantees every reply carries verify and limits fields (and what they mean), and explains the non-answering behavior on excluded inputs. It contradicts nothing in the annotations and meaningfully enriches the safety/behavior profile.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The critical information is front-loaded: purpose first, then USE WHEN/DO NOT USE, then behavioral disclaimers, then examples. However, the description carries a full English and a full Japanese section that restate the same content, nearly doubling the length. It is comprehensive but not tight – the bilingual duplication is structural waste that could be trimmed.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a routing tool with four destinations, the description is complete: it enumerates all four routing directions, disposes of the exclusion cases, discloses the deterministic routing mechanism, and explains the output contract (verify/limits). An output schema exists to carry the return-value details, and the description covers everything an agent needs to decide whether to call this tool and what to expect.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% – all four parameters (ask, ref, work, amount) carry their own descriptive text with format guidance. The description reinforces the primary entry pattern ('pass one sentence', 'single entry point') which maps to `ask`, but adds no new meaning beyond the schema. The schema's own hints (e.g., work '渡すと推測を挟まない') already carry the marginal semantics, so the baseline of 3 is correct.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb+resource ('Check whether a construction or renovation quote in JAPAN is fairly priced...') and names the exact scope of the routing tool: quote fairness, HORIZON SHIELD receipts, jidec: citations, contractor tactics, and verified contractors. It self-identifies as a 'single entry point' that routes to four directions, which distinguishes it from the list of siblings without needing to inspect any of their schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Uses an explicit 'USE WHEN' block listing four specific trigger conditions, and a 'DO NOT USE WHEN' block giving four concrete exclusions (outside Japan, non-construction, already signed/paid, active emergency). It even states what happens in those excluded cases ('returns the appropriate outside destination instead, and says so'). This is model-quality routing guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.7/5.0
Disambiguation5/5

Each tool has a clearly distinct purpose: draft_broadcast generates text, intake_estimate provides price verdicts, scan_tactics returns awareness material, route_request is a deterministic router, and run_full_audit orchestrates the others. The USE WHEN / DO NOT USE WHEN clauses explicitly delineate boundaries, leaving no ambiguity.

Naming Consistency5/5

All five tools follow a consistent verb_noun snake_case pattern (draft_broadcast, intake_estimate, route_request, run_full_audit, scan_tactics). The verbs and nouns clearly describe the action and object, with no mixing of conventions or vague terms.

Tool Count5/5

Five tools is a well-scoped number for this service: a router, two specialized analysis tools, a draft generator, and an orchestrator. Each tool has a clear role and earns its place, with no redundancy or excessive bloat.

Completeness5/5

The surface covers the full workflow: intake, tactics, broadcast drafting, and orchestration, plus a router that handles edge cases (outside Japan, non-construction, emergencies). The router ensures no dead ends by directing users to appropriate external resources, and all core use cases are addressed.