Govinfo

@pipeworx/govinfo

GovInfo.gov MCP — 米国政府刊行物の全文。

Pipeworx の一部です。AI エージェントを1879以上の稼働中のデータソースに接続するMCPゲートウェイです。独立した非公式の連携であり、上流プロバイダーとの提携、同社による推奨、または同社による公開はありません。

ツール

• list_collections()
• search_packages(query, collections?, congress?, date_from?, date_to?, page_size?, offset_mark?)
  • collections には、1つまたは複数のコードを指定できます。複数の場合はカンマまたはスペースで区切ります（"CHRG"、"CHRG,CRPT"）。複数のコードを指定すると和集合が検索されます。"CHRG,CRPT" は「Cooper」で9,239件のヒットを返します。これは、各コレクションを個別に検索したときの5,359件と3,880件の合計と正確に一致します。
  • page_size は limit でも指定できます。
• get_package(package_id)
• list_granules(package_id, page_size?, offset_mark?) — page_size は limit でも指定できます。
• get_granule(package_id, granule_id)

認証

• プラットフォームキー： PLATFORM_DATAGOV_KEY を再利用します。
• BYO： ?_apiKey=<key>（api.data.gov のキー）。

データソース

https://api.govinfo.gov — ?api_key= クエリパラメーター。

GAOの歳出法（fleet #1972）

GAOの二次的権威を、パッケージIDではなくトピックから利用できるようにする2つのツールです。

gao_red_book(topic?, chapter?, include_scope_text?)

財政法上の質問に対応する、GAOの Principles of Federal Appropriations Law（レッドブック）の該当章を特定します。キー不要です。GovInfo APIではなく www.gao.gov を参照するため、data.gov のキーがなくても動作します。

GovInfoを使わない理由。 2026-09-14に測定したところ、GAOREPORTS コレクションには16,569件のパッケージがありますが、2010-01-01以降に発行されたものはゼロです。また、"Principles of Federal Appropriations Law" の全文検索で上位100件に含まれる1,565件のうち、関連するパッケージは正確に1件だけで、それは 2004 Update of the Third Edition です。GovInfoでは、現行のレッドブックをまったく提供できません。

版の扱いが要点です。 GAOは現在、レッドブックを章ごとに公開しているため、現行の論説は複数の版が混在しています。

"Our current Red Book consists of Chapters 1-3 (of the 4th Edition) and Chapters 5-15 (of the 3rd Edition)." — gao.gov、呼び出しのたびにライブで取得

この文と目次全体はハードコードせず、呼び出し時にGAOのページから解析します。そのため、第4章はGAOが公開した日に表示されます。各行には該当する版が記載されます。2004年の年次更新版は、回答に該当しない理由とともに、別途 superseded の下に返されます。

鮮度。 source_last_modified は、章のPDF自体の Last-Modified です。目次ページの Last-Modified はDrupalのレンダリング時刻であり、呼び出すたびに 今日 と表示されます。これを使うと、2019年の章が今朝改訂されたかのように伝わってしまいます。

照合方法とその意義。 章のタイトルはGAOのライブページから取得され、権威ある情報源となります。これに加えて src/index.ts の RED_BOOK_TOPIC_ALIASES があります。これは このパックで保守しているリストであり、GAOが公開しているものではありません。そのため、照合された行には match_basis が付き、title:、alias:、gao_scope: のどれに基づいて照合したかを示します。各章はPDFであり、GovInfoはその内容をインデックス化していません。そのため、エイリアスを本文と照合して検証することはできません。よって、エントリーは、章のタイトルが示す規則の標準名称（bona fide needs rule → Availability of Appropriations: Time）、その規則が定められている米国法典の条項、または章のタイトルが問う内容を平易な英語で表現したものに限定されます。スコアの下限を超える候補がない場合、このツールは match_confidence: "none" と目次全体を返すため、もっともらしく見える誤った章を返しません。

gao_comptroller_decisions(query, date_from?, date_to?, include_reports?, page_size?)

GovInfo は、GAO の監査報告書と会計検査院長官の決定を、1 つのコレクションコードでファイルしています。コレクション名自体も「Government Accountability Office Reports and Comptroller General Decisions」となっているため、関連度検索では両者が混在します。"augmentation of appropriations"で調べたところ、確認した 100 件のうち、上位 25 件中 15 件は決定でした。このツールは決定 26 件を返し、報告書 74 件を除外して、両方の件数を報告します。両者の区別にはパッケージ ID（GAOREPORTS-B-…）を使用します。

収録範囲は 2009 年までで、GAOREPORTS にはそれ以降の資料はありません。最近の入札抗議にはgao_protests_searchを、現行の規則にはgao_red_bookを使用してください。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "govinfo": {
      "url": "https://gateway.pipeworx.io/govinfo/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/govinfo/mcpのtools/listは、上の表にあるツールに加えて、共通の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recallなど、ゲートウェイ全体で利用できるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとともに、共通ツールが約 30 件表示されます。接続のinitializeレスポンスに正確なスコープが記載されており、その日の時点での正式な情報です。

これは意図的な仕様であり、偶発的に多重化されているわけではありません。メタツールを使うと、このパックが対応していない質問にも、カタログ全体を対象にルーティングするask_pipeworx経由で回答できます。2 つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマがルーティングの利便性を上回るほどコンテキストを消費する場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

また、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと 1879 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworxを使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/govinfo_list_collections \
  -H 'Content-Type: application/json' \
  -d '{}'

最初の呼び出しにはアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/govinfo_list_collectionsを使用します。ツールを探すには、{"query":"..."}を指定してPOST https://gateway.pipeworx.io/v1/tools/search_packsを呼び出します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です：

{
  "mcpServers": {
    "govinfo": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-govinfo"]
    }
  }
}

または、直接実行して起動を確認します：

npx -y @pipeworx/mcp-govinfo

stdin/stdout 経由で MCP を使用し、このパック固有のツールのみを対象にinitialize／tools/list／tools/callに応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Govinfo data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT