--- url: /houki-hub/specs/houki-egov/get_toc.md description: >- houki-egov-mcp の get_toc（法令の目次を、本則と附則に分けて返す）の仕様。目的・入力・処理の流れと、仕様 ID ごとの仕様項目（specs/current から自動生成） --- # get_toc の仕様 ::: info houki-egov-mcp **v0.21.0** の `specs/current/get_toc/spec.md` から自動生成しました（仕様 ID 29 件・2026-10-12）。手で編集しないでください。再生成は `node scripts/generate-reference.mjs specs` です。 ::: 法令の目次を、本則と附則に分けて返す 使いどころ・引数・実測の呼び出し例は、[ツールのページ](/reference/mcp/houki-egov/get_toc)にあります。 最後に仕様が変わったのは v0.21.0 の「`get_toc` の `truncated` に、刈った理由を示す `truncated_by` を添える（egov #121）」（2026-10-12 承認）です。それまでの経緯は[承認の履歴](#承認の履歴)にあります。 ## 利用者と得られる結果 この機能の利用者と、利用者が渡すもの・得られる結果を示します。 * MCP クライアント（Claude などの LLM、または CLI から呼ぶ人）。`law_name` を渡して、法令の編・章・節・条の目次（本則）と、改正法ごとの附則の目次を受け取る。受け取った `toc[].path` や `suppl_provisions[].index` を `get_law_range` に渡して、範囲の本文を取る ## 入力 呼び出すときに渡す値です。 | 引数 | 必須 | 内容 | | ------------------- | ---- | -------------------------------------------------------------------------- | | `law_name` | 必須 | 法令名または略称。例: `民法`、`消法` | | `at` | 任意 | 時点指定（`YYYY-MM-DD`。[SPEC-EGOV-GET-TOC-024](#spec-egov-get-toc-024)） | | `depth` | 任意 | 本則の構造階層（編・章・節・款・目）を上から何階層まで返すか。1 以上の整数（[SPEC-EGOV-GET-TOC-023](#spec-egov-get-toc-023)）。省くと全階層 | | `suppl` | 任意 | 附則をどこまで返すか。`list`（既定）/ `full` / `none` | | `with_amend_titles` | 任意 | `true` のとき附則に改正法の題名を付ける。既定は `false` | ## 扱わないこと この機能が意図して扱わないことです。 * 条の本文を返すこと（範囲の本文は `get_law_range`、1 条ずつは `get_law`） * 附則の中に `path` を付けること（附則は `suppl_provisions[].index` で指す） * 題名が e-Gov の改正履歴に無い古い改正法に、題名を付けること * `format` を選ぶこと（応答は markdown と構造化した目次の両方を常に返す） * 応答の大きさや文字数で目次を打ち切ること（`truncated` は `depth` で刈ったときだけ `true`。文字数の上限で打ち切るのは `get_law_range` の `range.truncated`） ## 処理の流れ 呼び出しを受けてから応答を返すまでに、何をどの順で行うかを示します。図の中の番号は「できること」の仕様 ID の末尾 3 桁です。 ```mermaid flowchart TD A["呼び出し（law_name・at・depth・suppl・with_amend_titles）"] --> B["法令を引き、本文を e-Gov から取る"] B --> C["本則の目次を toc に、附則を suppl_provisions に分ける（001・002）"] C --> D["本則の構造ノードに path を付ける（003）"] D --> E{"depth があるか"} E -- ある --> F["本則を上から depth 階層で打ち切り、truncated: true・truncated_by: #quot;depth#quot;（010・030）"] E -- 無い --> G{"suppl"} F --> G G -- "list（既定）" --> H["附則は見出しと条数だけ（004・005）"] G -- full --> I["附則の中の条まで（006）"] G -- none --> J["附則を返さず、本数と条数だけ数える（007）"] H --> K{"with_amend_titles が true か"} I --> K J --> K K -- いいえ --> L["改正履歴を引かない（008）"] K -- はい --> M["改正履歴を 1 回引き、法令番号で照合して題名を付ける（009）"] L --> N["markdown と構造化した目次を返す（011）"] M --> N ``` ## 仕様項目 この機能の仕様項目を、仕様 ID ごとに並べています。見出しは仕様項目を 1 文で表したもので、条件・応答の細部・例は「詳細」を開くと読めます。仕様 ID はそれぞれ受入テストと対応していて、テストの無い ID があると各リポジトリの CI が止まります。 ### SPEC-EGOV-GET-TOC-001 本則を `toc`、附則を `suppl_provisions` に分けて返す ::: details 詳細 応答の `toc` には本則（編・章・節・款・目と条）だけを入れ、附則の条は入れない。附則は `suppl_provisions` に改正法ごとに 1 件ずつ入れる。 例: 本則が第一章（第1条・第2条）で附則を 3 本持つ法令では、`toc` は第一章の 1 件で、その `children` の条番号は `["1", "2"]`。附則の条はここに現れず、`suppl_provisions` は 3 件。 ::: ### SPEC-EGOV-GET-TOC-002 `toc` のノードの形 ::: details 詳細 `toc` の各ノードは次のフィールドを持つ。構造ノードは法令の階層どおりに `children` に入れ子になる。 | フィールド | 内容 | | ---------- | ----------------------------------------------------------------------------------------------------- | | `tag` | `Part`（編）/ `Chapter`（章）/ `Section`（節）/ `Subsection`（款）/ `Division`（目）/ `Article`（条） | | `num` | e-Gov の番号。枝番号の条は `30_2` | | `title` | 構造ノードは見出し（例: `第三章　税額控除等`）、条は条名（例: `第三十条`） | | `caption` | 条の見出し（例: `（仕入れに係る消費税額の控除）`）。条にだけ付く | | `path` | 本則の構造ノードにだけ付く範囲のパス（[SPEC-EGOV-GET-TOC-003](#spec-egov-get-toc-003)） | | `children` | 子のノードの配列 | ::: ### SPEC-EGOV-GET-TOC-003 本則の構造ノードに、`get_law_range` にそのまま渡せる `path` を付ける ::: details 詳細 本則の編・章・節・款・目のノードに、法令の根からのタグと番号を `/` でつないだ `path` を付ける（例: `Part1`、`Part1/Chapter2`、`Part2/Chapter2/Section1_2`）。この値は `get_law_range` の `path` にそのまま渡せる。条のノードと、附則の中のノードには `path` を付けない（附則の範囲は `suppl_provisions[].index` で指す）。 例: 第二編第二章のノードの `path` は `Part2/Chapter2` で、これを `get_law_range` の `path` に渡すと、`range.titles` が `["第二編　物権", "第二章　占有権"]` の範囲が返る。 ::: ### SPEC-EGOV-GET-TOC-004 既定（`suppl: "list"`）では附則の見出しと条数だけを返す ::: details 詳細 `suppl` を省くか `list` にしたとき、`suppl_provisions` の各要素の `children` は空配列にする（附則の中の条は返さない）。応答の `suppl` には次を入れる。 | フィールド | 内容 | | --------------------- | ------------------------------------------------------------------------------------------- | | `suppl.mode` | 適用した `suppl` の値（`list`） | | `suppl.count` | この法令が持つ附則の本数 | | `suppl.article_count` | 附則の中の条の総数 | | `suppl.note` | 何を返したかの 1 行。`list` のときは、中の条まで要るなら `suppl: "full"` を指定するよう書く | ::: ### SPEC-EGOV-GET-TOC-005 `suppl_provisions` の各要素の形 ::: details 詳細 `suppl_provisions` の各要素は次のフィールドを持つ。 | フィールド | 内容 | | ---------------- | -------------------------------------------------------------------------------------------------- | | `index` | 附則の出現順の番号（1 始まり）。`get_law_range` の `suppl_index` に渡せる | | `label` | 見出し。全角空白を詰めた `附則` | | `amend_law_num` | どの改正法の附則かを示す法令番号（例: `平成元年六月二八日法律第三九号`）。制定時の附則には付かない | | `extract` | 抄（改正法の附則の一部だけを載せた形）なら `true` | | `article_count` | その附則が持つ条の数 | | `paragraph_only` | 条を立てず項だけで書かれた附則なら `true`（このとき `article_count` は 0、`children` は空配列） | | `children` | 附則の中の目次。`suppl: "full"` のときだけ中身が入る | 附則を持たない法令では `suppl_provisions` は空配列。 例: 1 本目が制定時の附則（抄）、2 本目が改正法の附則、3 本目が項だけの附則のとき、1 本目は `amend_law_num` を持たず `extract: true`、2 本目は `amend_law_num: "平成元年六月二八日法律第三九号"`、3 本目は `paragraph_only: true`。 ::: ### SPEC-EGOV-GET-TOC-006 `suppl: "full"` では附則の中の条まで返す ::: details 詳細 `suppl` を `full` にしたとき、`suppl_provisions` の各要素の `children` に、その附則の中の条のノードを入れる。`suppl.mode` は `full`。 例: 条を 2 本持つ改正法の附則の `children` の条番号は `["1", "2"]`。 ::: ### SPEC-EGOV-GET-TOC-007 `suppl: "none"` では附則を返さず、本数と条数だけを返す ::: details 詳細 `suppl` を `none` にしたとき、`suppl_provisions` は空配列にし、markdown に附則の節を出さない。`suppl.count` と `suppl.article_count` はこのときも数えて返す。 例: 附則 3 本・条 3 件の法令では、`suppl_provisions: []`、`suppl.count: 3`、`suppl.article_count: 3`。 ::: ### SPEC-EGOV-GET-TOC-008 既定では改正履歴を引かない ::: details 詳細 `with_amend_titles` を省くか `false` にしたときは、e-Gov の改正履歴を問い合わせない。附則に `amend_law_title` は付かない。 ::: ### SPEC-EGOV-GET-TOC-009 `with_amend_titles: true` で附則に改正法の題名を付ける ::: details 詳細 `with_amend_titles` を `true` にしたとき、e-Gov の改正履歴（`get_law_revisions` と同じ応答）を 1 回だけ引き、附則の `amend_law_num` と改正履歴の改正法の法令番号を照合して、一致した附則に `amend_law_title` を付ける。附則の法令番号（`平成元年六月二八日法律第三九号`）と改正履歴の法令番号（`平成元年法律第三十九号`）の、公布の月日の有無と漢数字の書き方の違いは吸収して照合する。制定時の附則（`amend_law_num` が無いもの）は照合しない。 応答の `suppl.amend_law_titles` に次を入れる。 | フィールド | 内容 | | ----------- | ---------------------------------------------------------------------------- | | `matched` | 題名を付けた附則の数 | | `unmatched` | 改正履歴に該当が無く題名を付けられなかった附則の数（制定時の附則は数えない） | | `revisions` | 照合に使った改正履歴の件数 | | `source` | `law_revisions` | 題名を付けられなかった附則があるときは、`suppl.note` に残りの本数（`残り N 本`）と、改正履歴に該当が無かったことを書く。 例: 制定時の附則 1 本、改正履歴に載っている改正法の附則 1 本、載っていない古い改正法の附則 1 本の法令では、2 本目にだけ `amend_law_title: "消費税法の一部を改正する法律"` が付き、`suppl.amend_law_titles` は `{ matched: 1, unmatched: 1, revisions: 1, source: "law_revisions" }`。 ::: ### SPEC-EGOV-GET-TOC-010 `depth` で本則の階層を上から打ち切る ::: details 詳細 `depth` に 1 以上の数を渡したとき、本則の構造階層（編・章・節・款・目）を上から `depth` 階層までにし、それより下は `children` を空配列にする。条は階層として数えない（`depth` が構造階層の深さ以上なら条まで残る）。枝を刈ったときは応答の `truncated` を `true` にし、`truncated_by` を `"depth"` にする（[SPEC-EGOV-GET-TOC-030](#spec-egov-get-toc-030)）。附則の本数（`suppl_provisions` の件数）は `depth` で変わらない。 `truncated` が `true` になるのは `depth` で枝を刈ったときだけで、応答の大きさや文字数では打ち切らない。`get_law_range` の `range.truncated`（`max_chars` の文字数の上限で条を打ち切った印。[SPEC-EGOV-GET-LAW-RANGE-017](/specs/houki-egov/get_law_range#spec-egov-get-law-range-017)）とは意味が違い、続きを取る引数や `next_actions` は付かない。全階層が要るときは `depth` を省いて呼び直す。 例: 編 > 章 > 節 > 条の法令で、`depth: 1` は編だけ（編の `children` は空配列）、`depth: 2` は編と章、`depth: 3` は節まで（節の `children` は空配列）、`depth: 4` は条まで返す。章だけの法令に `depth: 1` を渡すと、章の `children` が空配列になり `truncated: true`、`truncated_by: "depth"`。`{ law_name: "民法", depth: 1, suppl: "none" }` は編 5 件だけを返し、`node_count: 5`、`truncated: true`、`truncated_by: "depth"` で、`next_actions` は無い（2026-10-12 JST に houki-egov-dev 0.20.1 で確かめたときは `truncated_by` が無かった）。 ::: ### SPEC-EGOV-GET-TOC-011 markdown の目次 ::: details 詳細 応答の `markdown` は次の形の文字列である。 * 附則を 1 本以上返すときは、`## 本則` の節と `## 附則（<本数> 本・条 <条の合計> 件）` の節に分ける。附則を返さないとき（附則の無い法令、`suppl: "none"`）はどちらの見出しも付けず、本則の箇条書きだけを書く * 本則は階層ごとに字下げした箇条書き。構造ノードは見出し、条は `第N条` の表記（枝番号は `第70条の6`）の後に条見出しを付ける（例: `- 第70条の6 （農地等についての相続税の納税猶予等）`） * 附則は 1 本 1 行で `- 附則() <改正法の法令番号、または 制定時><抄なら（抄）> — <条 N 件、または 項のみ>`。改正法の題名が付いたときは末尾に ` ／ 改正法: <題名>` を付ける。附則の中の条は 1 段下げて書く 例: `- 附則(1) 制定時（抄） — 条 2 件`、`- 附則(2) 平成元年六月二八日法律第三九号（抄） — 条 1 件 ／ 改正法: 消費税法の一部を改正する法律`、`- 附則(3) 平成二年六月二二日法律第三六号 — 項のみ`。 ::: ### SPEC-EGOV-GET-TOC-012 法令が見つからないときは LAW_NOT_FOUND を返す ::: details 詳細 略称辞書にも e-Gov の法令検索にも当たらない `law_name` では、エラー `LAW_NOT_FOUND` を返す。`error` は `法令が見つかりません: `。`next_actions` は 2 件で、1 件目は `resolve_abbreviation`（`example.abbr` に `law_name`）、2 件目は `search_law`（`example.keyword` に `law_name`）。 例: `law_name: "存在しない法"`（法令検索の結果が 0 件）では、`code: "LAW_NOT_FOUND"`、`error: "法令が見つかりません: 存在しない法"`、`next_actions` の `action` は `["resolve_abbreviation", "search_law"]`、`next_actions[0].example` は `{ abbr: "存在しない法" }`、`next_actions[1].example` は `{ keyword: "存在しない法" }`。 ::: ### SPEC-EGOV-GET-TOC-013 houki-egov の管轄外の名前には OUT_OF_SCOPE を返す ::: details 詳細 略称辞書で houki-egov 以外の管轄と分かる `law_name`（通達名など）では、e-Gov に問い合わせずにエラー `OUT_OF_SCOPE` を返す。`error` に正式名称と管轄の MCP 名を書き、`next_actions[0]` は `action: "delegate_to_mcp"`、`example.mcp` に管轄の MCP 名を入れる。 例: `law_name: "消基通"` では、`code: "OUT_OF_SCOPE"`、`error` は `「消費税法基本通達」は houki-nta の管轄です` で始まり、`next_actions[0]` は `{ action: "delegate_to_mcp", example: { mcp: "houki-nta" } }`（`reason` も付く）、`detail.cause` は `source_mcp_hint=houki-nta`。 ::: ### SPEC-EGOV-GET-TOC-014 法令本文の取得で e-Gov が失敗したときのエラー ::: details 詳細 429 以外の 4xx は [SPEC-EGOV-GET-TOC-029](#spec-egov-get-toc-029)。 法令を引けた後、e-Gov から法令本文を取るところで失敗したときは、次のエラーを返す。 | e-Gov の失敗 | `code` | `retryable` | `next_actions` の `action` | | ------------------------------------------- | --------------------- | ----------- | ---------------------------------- | | 429 | `SOURCE_RATE_LIMITED` | `true` | `retry_later` | | タイムアウト | `SOURCE_TIMEOUT` | `true` | `retry_later`、`visit_egov_site` | | 5xx | `SOURCE_API_ERROR` | `true` | `retry_later`、`visit_egov_site` | 429 と 5xx では `detail.status` に HTTP の状態コードを入れる。 例: 本文の取得が 503 で失敗すると、`code: "SOURCE_API_ERROR"`、`error: "e-Gov API がサーバーエラーを返しました（503）"`、`retryable: true`、`detail.status: 503`。429 では `code: "SOURCE_RATE_LIMITED"`、`error: "e-Gov API がレート制限を返しました（429）"`。タイムアウトでは `code: "SOURCE_TIMEOUT"`、`error: "e-Gov API がタイムアウトしました"`。 ::: ### SPEC-EGOV-GET-TOC-015 応答の `meta` ::: details 詳細 応答の `meta` は次のフィールドを持つ。`at` を省いたときもキーは無くならない。 | フィールド | 内容 | | -------------- | ---------------------------------------------------------------------- | | `law_id` | e-Gov の法令 ID | | `title` | 法令名 | | `law_num` | 法令番号 | | `retrieved_at` | 取得日時（ISO 8601 の UTC。例: `2026-09-27T20:31:59.713Z`） | | `url` | e-Gov 法令検索の法令のページ。`https://laws.e-gov.go.jp/law/` | | `at` | 渡した `at`。`at` を省いたときは `null` | 例: 法令 ID `999AC0000000001`・法令名 `テスト法`・法令番号 `令和七年法律第一号` の法令を `at` なしで取ると、`meta` は `{ law_id: "999AC0000000001", title: "テスト法", law_num: "令和七年法律第一号", retrieved_at: , url: "https://laws.e-gov.go.jp/law/999AC0000000001", at: null }`（v0.16.0 では `at` のキーが無かった）。`at: "2020-04-01"` を渡したときは `at: "2020-04-01"`（[SPEC-EGOV-GET-TOC-018](#spec-egov-get-toc-018)）。 ::: ### SPEC-EGOV-GET-TOC-016 `node_count` は返した本則の目次のノード数 ::: details 詳細 応答の `node_count` は、返した `toc` のノード（編・章・節・款・目と条）を入れ子の中まで数えた数である。附則のノードは数えない。`depth` で刈ったときは、刈った後の `toc` のノード数になる。 例: 第一編 > 第一章（第1条・第2条）・第二章 > 第一節（第3条）の本則と附則 2 本を持つ法令では、`node_count: 7`（編 1・章 2・節 1・条 3）、`truncated: false`、`truncated_by: null`。同じ法令に `depth: 1` を渡すと、`node_count: 1`、`truncated: true`、`truncated_by: "depth"`。 ::: ### SPEC-EGOV-GET-TOC-017 markdown の見出しと末尾の出典 ::: details 詳細 `markdown` の 1 行目は `# <法令名> — 目次`。目次の後に `---` の行を置き、続けて `出典：e-Gov法令検索（デジタル庁）`、`URL: https://laws.e-gov.go.jp/law/`、`at` を渡したときだけ `時点: `、最後に `取得日時: ` の行を書く。 例: `law_name: "テスト法"`（法令 ID `999AC0000000001`）を `at` なしで取ると、`markdown` は `# テスト法 — 目次` で始まり、末尾の 4 行は `---`、`出典：e-Gov法令検索（デジタル庁）`、`URL: https://laws.e-gov.go.jp/law/999AC0000000001`、`取得日時: ` で、`時点:` の行を含まない。 ::: ### SPEC-EGOV-GET-TOC-018 `at` で時点を指定する ::: details 詳細 `at` を渡したとき、その値を時点として e-Gov の法令本文の取得に渡し、その時点の目次を返す。`meta.at` に渡した値を入れ、`markdown` の末尾に `時点: ` の行を書く（`URL:` の行と `取得日時:` の行の間）。 例: `at: "2020-04-01"` を渡すと、e-Gov への本文の取得に時点 `2020-04-01` が渡り、`meta.at` は `"2020-04-01"`、`markdown` の末尾の 3 行は `URL: https://laws.e-gov.go.jp/law/`、`時点: 2020-04-01`、`取得日時: `。 ::: ### SPEC-EGOV-GET-TOC-019 `suppl: "full"` と `depth` を一緒に渡すと、附則の中の目次も打ち切る ::: details 詳細 `suppl: "full"` と `depth` を一緒に渡したとき、`suppl_provisions` の各要素の `children` にも本則と同じ打ち切りを当てる（構造階層を上から `depth` 階層までにし、それより下は `children` を空配列にする。条は階層として数えない）。`suppl: "list"` と `suppl: "none"` では附則の中身を返さないので、`depth` は附則に効かない。 例: 1 本目が条だけ（第1条）の附則、2 本目が第一章（第1条・第2条）を持つ附則の法令で、`suppl: "full", depth: 1` を渡すと、1 本目の `children` は第1条の 1 件のまま、2 本目の `children` は第一章の 1 件でその `children` は空配列。`depth: 2` では、2 本目の第一章の `children` の条番号は `["1", "2"]`。 ::: ### SPEC-EGOV-GET-TOC-020 改正履歴が取れなかったときは、題名なしの目次を返す ::: details 詳細 `with_amend_titles: true` で e-Gov の改正履歴の取得に失敗したときは、エラーにせず、附則に `amend_law_title` を付けない目次を返す。`suppl.amend_law_titles` は付けない。`suppl.note` の末尾に `。改正法の題名は付けられませんでした（改正履歴の取得に失敗: <失敗の理由>）` を足す。 例: 附則 2 本・条 3 件の法令で改正履歴の取得が 503（理由の文言 `svc down`）で失敗すると、目次は返り、`suppl_provisions` のどの要素にも `amend_law_title` が無く、`suppl.amend_law_titles` は無く、`suppl.note` は `附則 2 本の見出しと条数だけを返しました（条は合計 3 件）。中の条まで要るときは suppl: "full" を指定してください。改正法の題名は付けられませんでした（改正履歴の取得に失敗: svc down）`。 ::: ### SPEC-EGOV-GET-TOC-021 `suppl: "none"` のときは `with_amend_titles` を渡しても改正履歴を引かない ::: details 詳細 `suppl: "none"` と `with_amend_titles: true` を一緒に渡したときは、返す附則が無いので e-Gov の改正履歴を問い合わせない。`suppl.amend_law_titles` は付かず、`suppl.note` は `suppl: "none"` のときの文のまま。 例: 附則 2 本・条 3 件の法令に `suppl: "none", with_amend_titles: true` を渡すと、改正履歴の問い合わせは 0 回で、`suppl` は `{ mode: "none", count: 2, article_count: 3, note: "附則 2 本（条 3 件）は返していません（suppl: \"none\"）" }`。 ::: ### SPEC-EGOV-GET-TOC-023 `depth` は 1 以上の整数で、0・負の数・小数は `INVALID_ARGUMENT` にして法令を取らない ::: details 詳細 tools/list の inputSchema の `depth` は `type: "integer"`、`minimum: 1` を持ち、`maximum` を持たない（[SPEC-EGOV-COMMON-ERRORS-023](/specs/houki-egov/common_errors#spec-egov-common-errors-023)）。0・負の数・小数・数値でない値を渡すと、inputSchema の検査で `INVALID_ARGUMENT`（`tool: "get_toc"`、`detail.issues[0].path: "depth"`）を返し、e-Gov に問い合わせない。全階層に読み替えたり切り捨てたりしない。構造階層の深さより大きい値は今までどおり条まで返す（[SPEC-EGOV-GET-TOC-010](#spec-egov-get-toc-010)）。 例: `law_name: "民法", depth: 0` は `code: "INVALID_ARGUMENT"`、`detail.issues` は `[{ path: "depth", message: "1 以上で指定してください" }]` で、e-Gov への問い合わせは 0 回（v0.15.4 では全階層を返していた）。`depth: -1` も同じ。`depth: 1.5` は `[{ path: "depth", message: "整数で指定してください" }]`。`depth: 99` は検査を通り、条まで返して `truncated: false`。 ::: ### SPEC-EGOV-GET-TOC-024 `at` は `YYYY-MM-DD` の形だけを受け付け、形に合わない値と暦に無い日付は `INVALID_ARGUMENT` ::: details 詳細 `at` は [SPEC-EGOV-COMMON-ERRORS-024](/specs/houki-egov/common_errors#spec-egov-common-errors-024) に従う。形に合わない値は inputSchema の検査で `INVALID_ARGUMENT`（`tool: "get_toc"`、`detail.issues: [{ path: "at", message: "YYYY-MM-DD の形で指定してください" }]`）、暦に無い日付はツールの処理で `INVALID_ARGUMENT`（`detail.issues: [{ path: "at", message: "暦に無い日付です" }]`）になり、どちらも e-Gov に問い合わせない。 例: `law_name: "民法", at: "2024/04/01"` は `code: "INVALID_ARGUMENT"`・`detail.issues[0].path: "at"`。`at: "2026-02-30"` は `detail.issues[0].message: "暦に無い日付です"`。どちらも e-Gov への問い合わせは 0 回。`at: "2024-04-01"` は [SPEC-EGOV-GET-TOC-018](#spec-egov-get-toc-018) のとおり。 ::: ### SPEC-EGOV-GET-TOC-025 law_name が空文字・空白だけのときは e-Gov に問い合わせずに `INVALID_ARGUMENT` を返す ::: details 詳細 空文字は inputSchema の検査（[SPEC-EGOV-COMMON-ERRORS-025](/specs/houki-egov/common_errors#spec-egov-common-errors-025)）、空白だけはツールの処理（[SPEC-EGOV-COMMON-ERRORS-026](/specs/houki-egov/common_errors#spec-egov-common-errors-026)。`error: "law_name が空です"`）で、どちらも `INVALID_ARGUMENT`（`tool: "get_toc"`、`detail.issues[0].path: "law_name"`）を返し、略称辞書と e-Gov に問い合わせない。 例: `law_name: ""` は `detail.issues[0].message: "空文字は指定できません"`、`law_name: " "` は `error: "law_name が空です"`。どちらも `code: "INVALID_ARGUMENT"` で e-Gov への問い合わせは 0 回。 ::: ### SPEC-EGOV-GET-TOC-026 法令名の検索が通信の失敗で終わったときは `LAW_NOT_FOUND` ではなく `SOURCE_*` を返す ::: details 詳細 `law_name` が略称辞書に law_id 付きで無く、e-Gov の法令名検索で law_id を決めるとき、その検索が通信の失敗（接続できない・時間切れ・5xx・429・429 以外の 4xx）で終わったときは、[SPEC-EGOV-COMMON-ERRORS-027](/specs/houki-egov/common_errors#spec-egov-common-errors-027) の表の code（`SOURCE_UNAVAILABLE` / `SOURCE_TIMEOUT` / `SOURCE_API_ERROR` / `SOURCE_RATE_LIMITED`）を、表の `retryable` と `detail` 付きで返す（[SPEC-EGOV-COMMON-ERRORS-029](/specs/houki-egov/common_errors#spec-egov-common-errors-029)）。`LAW_NOT_FOUND`（[SPEC-EGOV-GET-TOC-012](#spec-egov-get-toc-012)）は、検索が成功して 0 件だったときだけ返す。`SOURCE_*` のときの `next_actions` に `resolve_abbreviation` / `search_law` は入れない。 例: 法令名の検索が 503 を返す状態で `{ law_name: "架空の法律" }` を渡すと、`code: "SOURCE_API_ERROR"`、`retryable: true`、`detail.status: 503`（v0.15.4 では `LAW_NOT_FOUND` だった）。検索が時間切れなら `SOURCE_TIMEOUT`、接続できなければ `SOURCE_UNAVAILABLE`（`detail.cause: "ENOTFOUND"` など）、400 なら `SOURCE_API_ERROR`・`retryable: false`。検索が 0 件で成功したときは `LAW_NOT_FOUND` のまま。 ::: ### SPEC-EGOV-GET-TOC-027 `law_name` の全角英数字・ダッシュ類・全角空白は半角に揃えてから略称辞書と照合する ::: details 詳細 `law_name` を略称辞書で引くときは、houki-abbreviations の `resolveAbbreviation(name, { normalize: true })` の規則（全角英数字を半角に、ダッシュ類 `－` `‐` `‑` `–` `—` `―` `−` を `-` に、全角チルダを `~` に、全角空白を半角空白にし、前後の空白を除く。大文字と小文字は区別する）で揃えてから照合する。管轄の判定（`OUT_OF_SCOPE`）も同じ規則で引く。辞書に無いときに e-Gov の法令名検索へ渡す値は、前後の空白を除いた渡した値のままで、揃えない。 例: `{ law_name: "ＰＬ法" }` は `製造物責任法の目次を返す`（v0.15.4 では辞書に無い扱いで、e-Gov の法令名検索に `ＰＬ法` を渡して `LAW_NOT_FOUND` だった）。`law_name: "労基法　"`（末尾が全角空白）も `労働基準法` として引く。 ::: ### SPEC-EGOV-GET-TOC-028 法令名が完全一致しないときは、目次を返さず候補を付けた `LAW_NOT_FOUND` を返す ::: details 詳細 `law_name` の法令は [SPEC-EGOV-COMMON-ERRORS-032](/specs/houki-egov/common_errors#spec-egov-common-errors-032) の規則で決める。略称辞書に law_id が無く、e-Gov の法令名検索の全件の中に題名の完全一致が無いときは、検索結果の先頭の法令の目次を返さず、032 の形の `LAW_NOT_FOUND`（`retryable: false`）を返す。`next_actions` の候補の要素は `action: "get_toc"`、`example` は渡した引数（`depth`・`suppl`・`with_amend_titles`・`at` のうち渡したもの）の `law_name` だけを候補の題名に替えたもの。`at` を渡したときは、法令名の検索にも `asof=` を付ける。 例: `{ law_name: "保険法", depth: 1 }`（辞書に無い）は、`/laws?law_title=保険法` の 114 件（2026-10-03 10:10 JST）の中の完全一致 `保険法`（`420AC0000000056`）の目次を返す（v0.17.0 では、同じ引数に `meta.title: "健康保険法"`・`meta.law_id: "211AC0000000070"` の目次を返した。2026-10-03 10:10 JST に houki-egov-dev 0.17.0 で確かめた）。`{ law_name: "所得税法施行" }` は、候補 `所得税法施行令`・`所得税法施行規則` の `get_toc` と `search_law` を `next_actions` に持つ `LAW_NOT_FOUND`。 ::: ### SPEC-EGOV-GET-TOC-029 法令本文の取得で e-Gov が 404・時点の 400 を返したときは `LAW_NOT_FOUND`・`INVALID_ARGUMENT` ::: details 詳細 法令を決めた後の法令本文の取得で e-Gov が 429 以外の 4xx を返したときは、[SPEC-EGOV-COMMON-ERRORS-033](/specs/houki-egov/common_errors#spec-egov-common-errors-033) の表のとおりに返す。404・`404004` は `LAW_NOT_FOUND`（`retryable: false`、033 の `error`・`hint`・`next_actions`）、400・`400044` は `INVALID_ARGUMENT`（`tool: "get_toc"`、`detail.issues: [{ path: "at", message: "e-Gov が受け付ける時点の範囲の外です" }]`）、そのほかの 4xx は `SOURCE_API_ERROR`（`retryable: false`、`detail.status`）。 例: `{ law_name: "消費税法", at: "2000-01-01" }` は、2026-10-03 の e-Gov が 400・`400044` を返すので `code: "INVALID_ARGUMENT"`・`tool: "get_toc"`（v0.17.0 では `SOURCE_API_ERROR`・`retryable: false`）。法令本文の取得が 404・`404004` になる状態で `{ law_name: "消費税法" }` を呼ぶと `code: "LAW_NOT_FOUND"`。 ::: ### SPEC-EGOV-GET-TOC-030 `truncated_by` で、`truncated` の理由を返す ::: details 詳細 応答の最上位に `truncated_by` を常に置く。`depth` で本則の枝を刈って `truncated` が `true` のときは `"depth"`、刈らなかった（`truncated` が `false`）ときは `null`。`depth` を省いたとき、および `depth` が構造階層の深さ以上で何も刈らなかったときは `null`（キーは無くならない）。値は `"depth"` と `null` の 2 つだけで、応答の大きさや文字数を理由にした値は無い。`markdown` には刈ったことを書かない。 例: 編 > 章 > 節 > 条の法令に `depth: 2` を渡すと `truncated: true`、`truncated_by: "depth"`。同じ法令に `depth: 99` を渡すと条まで返して `truncated: false`、`truncated_by: null`。`depth` を省いても `truncated: false`、`truncated_by: null`。`suppl: "full", depth: 1` のように附則の中の目次も刈ったとき（[SPEC-EGOV-GET-TOC-019](#spec-egov-get-toc-019)）も、本則を刈っていれば `truncated_by: "depth"`。 ::: ## 実装する人に向けた情報 ここから下は、この機能を実装する人と、仕様の変更を追う人に向けた節です。使い方を知りたいだけなら、読まなくて構いません。 ### 検討中のこと 仕様を書き起こしたときに見つかった項目のうち、扱いを Issue で検討しているものです。ここに挙げたことは、今後の版で変わることがあります。開くと、元の仕様書の記述をそのまま読めます。 ::: details 仕様書の「未決」の節 初版起こしで見つけた、意図か不具合かを人が決める項目です。決まったら「できること」に ID を振るか、`specs/changes/` の差分にします。 意図か不具合かの判断が要る項目は houki-egov-mcp の Issue に移し、ここには題と Issue の番号だけを残します。今の振る舞いのままでよくテストが無いだけの項目は、受入テストを書いてから「できること」に ID を振ります。 1. **法令が見つからないとき・管轄外の名前のとき・e-Gov が失敗したときのエラー。** → [SPEC-EGOV-GET-TOC-012](#spec-egov-get-toc-012)・[SPEC-EGOV-GET-TOC-013](#spec-egov-get-toc-013)・[SPEC-EGOV-GET-TOC-014](#spec-egov-get-toc-014)（一部は約束にしていない。差分 `20260928-untested-behaviors` の proposal.md を参照） 2. **`meta`・`node_count` と markdown の末尾。** → [SPEC-EGOV-GET-TOC-015](#spec-egov-get-toc-015)・[SPEC-EGOV-GET-TOC-016](#spec-egov-get-toc-016)・[SPEC-EGOV-GET-TOC-017](#spec-egov-get-toc-017) 3. **`at` で時点を指定したときの目次。** → [SPEC-EGOV-GET-TOC-018](#spec-egov-get-toc-018) 4. **`suppl: "full"` と `depth` を一緒に渡したとき。** → [SPEC-EGOV-GET-TOC-019](#spec-egov-get-toc-019) 5. **改正履歴の取得に失敗したとき。** → [SPEC-EGOV-GET-TOC-020](#spec-egov-get-toc-020)・[SPEC-EGOV-GET-TOC-021](#spec-egov-get-toc-021) 6. **`depth` に 0 以下を渡したとき。** → [SPEC-EGOV-GET-TOC-023](#spec-egov-get-toc-023) ::: ### 承認の履歴 この機能の仕様が、いつ、どの変更で承認されたかを新しい順に並べています。各リポジトリの `npx spec-ids history get_toc` と同じ内容です。変更の名前から、変更の理由と前後の振る舞いを書いた文書（GitHub）を開けます。 ::: details 承認の履歴（11 件） | 承認日 | 版 | 変更 | 仕様 PR | |---|---|---|---| | 2026-10-12 | v0.21.0 | [`get_toc` の `truncated` に、刈った理由を示す `truncated_by` を添える（egov #121）](https://github.com/shuji-bonji/houki-egov-mcp/blob/v0.21.0/specs/releases/v0.21.0/20261012-toc-truncated-by/proposal.md) | [#122](https://github.com/shuji-bonji/houki-egov-mcp/pull/122) | | 2026-10-03 | v0.18.0 | [法令名・条・委任先を、確かなときだけ 1 つに決める（段階 5 法令の引き当て）](https://github.com/shuji-bonji/houki-egov-mcp/blob/v0.21.0/specs/releases/v0.18.0/20261003-law-resolution/proposal.md) | [#95](https://github.com/shuji-bonji/houki-egov-mcp/pull/95) | | 2026-10-03 | v0.17.0 | [README・使い方・tool description と実際の動きの食い違いを、行ごとに直す（T5 文書と実装の食い違い）](https://github.com/shuji-bonji/houki-egov-mcp/blob/v0.21.0/specs/releases/v0.17.0/20261003-t5-docs-mismatch/proposal.md) | [#92](https://github.com/shuji-bonji/houki-egov-mcp/pull/92) | | 2026-10-03 | v0.17.0 | [値の無いフィールドを null にし、meta の時点を常に返す（T4 応答の形）](https://github.com/shuji-bonji/houki-egov-mcp/blob/v0.21.0/specs/releases/v0.17.0/20261003-t4-response-shape/proposal.md) | [#91](https://github.com/shuji-bonji/houki-egov-mcp/pull/91) | | 2026-10-01 | v0.16.0 | [T1 の差分の書き残しを直す（和の型の message、max_chars の例、REMOVED を指す未決）](https://github.com/shuji-bonji/houki-egov-mcp/blob/v0.21.0/specs/releases/v0.16.0/20261002-t1-followups/proposal.md) | [#89](https://github.com/shuji-bonji/houki-egov-mcp/pull/89) | | 2026-10-01 | v0.16.0 | [全角・半角・ダッシュ類の揃え方を houki-abbreviations 0.7.0 に一本化する（T3）](https://github.com/shuji-bonji/houki-egov-mcp/blob/v0.21.0/specs/releases/v0.16.0/20261001-t3-normalize/proposal.md) | [#86](https://github.com/shuji-bonji/houki-egov-mcp/pull/86) | | 2026-10-01 | v0.16.0 | [「見つからない」と「取得元の失敗」の code を分ける（T2）](https://github.com/shuji-bonji/houki-egov-mcp/blob/v0.21.0/specs/releases/v0.16.0/20261001-t2-error-codes/proposal.md) | [#85](https://github.com/shuji-bonji/houki-egov-mcp/pull/85) | | 2026-10-01 | v0.16.0 | [引数の検査を inputSchema に書き、丸めずに `INVALID_ARGUMENT` にする（T1）](https://github.com/shuji-bonji/houki-egov-mcp/blob/v0.21.0/specs/releases/v0.16.0/20261001-t1-argument-guards/proposal.md) | [#84](https://github.com/shuji-bonji/houki-egov-mcp/pull/84) | | 2026-09-28 | v0.15.2 | [テストが無いだけの振る舞いに仕様 ID を振る](https://github.com/shuji-bonji/houki-egov-mcp/blob/v0.21.0/specs/releases/v0.15.2/20260928-untested-behaviors/proposal.md) | [#76](https://github.com/shuji-bonji/houki-egov-mcp/pull/76) | | 2026-09-28 | v0.15.2 | [「未決」のうち判断が要る 85 件を Issue に移す](https://github.com/shuji-bonji/houki-egov-mcp/blob/v0.21.0/specs/releases/v0.15.2/20260928-undecided-to-issues/proposal.md) | [#68](https://github.com/shuji-bonji/houki-egov-mcp/pull/68) | | 2026-09-28 | — | 初版 | [#50](https://github.com/shuji-bonji/houki-egov-mcp/pull/50) | ::: ## 関連ページ このページの元になった文書と、あわせて読むページです。 * [houki-egov-mcp の仕様の一覧](/specs/houki-egov/) * [houki-egov-mcp の解説](/mcp/houki-egov) * [get_toc のツールのページ（リファレンス）](/reference/mcp/houki-egov/get_toc) * [元の仕様書（GitHub、v0.21.0）](https://github.com/shuji-bonji/houki-egov-mcp/blob/v0.21.0/specs/current/get_toc/spec.md)