Congressional Documents

@pipeworx/congressional-documents

議会の公式記録（公聴会の議事録、委員会報告書、Congressional Record）の全文検索と取得に対応します。プラットフォームキー（data.gov）を利用します。BYO も利用できます。

Pipeworx の一部です。AI エージェントを 1875 件以上の稼働中のデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、承認、公開のいずれも行っていません。

ツール

• search_congressional_documents(...) — 公聴会、委員会報告書、委員会印刷物、下院・上院文書、Congressional Record の全文を検索します。doc_type には一般的な単語（"hearings"、"reports"、"record"）を指定します。
• get_congressional_document_text(...) — ページ引用と govinfo.gov の URL を含む、実際の文書本文を取得します。offset／next_offset でページ送りできます（公聴会の文書は約 20 万文字に及びます）。
• list_congressional_document_types(...) — 各文書タイプに含まれる内容と、このデータソースが対象とする範囲を確認できます。キー不要です。

認証

プラットフォームキー（PLATFORM_DATAGOV_KEY）、または _apiKey を使った BYO を利用できます。https://api.data.gov/signup で無料かつ即時に登録できます。1 つのキーで GovInfo とほとんどの連邦政府 API を利用できます。

これが作られた理由

これらの情報はすべて govinfo パックから取得できますが、利用できるのは search_packages({collections:"CHRG"}) と list_granules のみです。「X に関する議会公聴会では何が語られましたか」と尋ねられて、granule API を使ったり、CHRG が公聴会を意味すると理解したりするモデルはありません。データが欠けていたのではなく、そこへたどり着く手段が欠けていました。

このツールは根拠の提示を目的としています。このコーパスは膨大で構造が整っておらず、二次情報では大幅に言い換えられているため、モデルがまさに作り話をしやすい内容です。すべての検索結果に package／granule ID、公式の引用情報、govinfo.gov の URL が含まれるため、記憶に頼らず引用できます。

対象範囲

公開済みの文書のみが対象です。 公聴会の議事録は、公聴会から数か月後に公開されます。委員会が独自のウェブサイトで公開する臨時の文書は GovInfo には一切掲載されません。その場合は search_committee_documents（committee-releases）を使用してください。

page_citation は Congressional Record の慣例（[Pages S6557-S6559]）です。公聴会の文書にはページ引用がないため、その場合は正当に null になります。

意図的に省いたもの

人物を中心としたツールはありません。 名前を受け取り、その人物に言及している文書を返すツールはありません。理由は 2 つあります。

1. 名前は識別子ではありません。 公聴会全体から「Epstein」を検索すると、D.C. Superior Court の判事候補者である Anthony C. Epstein が最初に表示されます。人物を扱うツールでは、姓が同じだけの無関係な人物を、気づかないうちに同一人物としてまとめてしまいます。
2. 文書に登場することは、疑惑をかけられたことを意味しません。 記録には、証人、職員、引用された著者、そして一度だけ言及された人物の名前も記載されています。「X は記録に登場するか」というツールがあると、要約モデルが「言及された」を「関与が疑われた」へとすり替えるおそれがあります。

すべての応答にこの注意書きが含まれます。人物から言及先を検索するツールは追加しないでください。これを省くこと自体が設計です。

データソース

• https://api.govinfo.gov/search
• https://api.govinfo.gov/packages/{packageId}/granules/{granuleId}/htm

クイックスタート

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

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

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

https://gateway.pipeworx.io/congressional-documents/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントでは、パック固有のツールとともに、共有ツールがおよそ 30 個一覧表示されます。接続の initialize 応答に正確なスコープが記載されており、その日の状況を確認するうえで最も信頼できる情報です。

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

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/search_congressional_documents \
  -H 'Content-Type: application/json' \
  -d '{"query":"opioid settlement"}'

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

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

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

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

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

npx -y @pipeworx/mcp-congressional-documents

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

ask_pipeworx を使う

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

ask_pipeworx({ question: "your question about Congressional Documents data" })

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

詳細

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

ライセンス

MIT