Reginfo

@pipeworx/reginfo

連邦規制および規制緩和措置の統合アジェンダです。Fall 1995 以降、連邦機関が提案または最終決定する意向を OIRA に伝えた、あるいは完了したすべての RIN（規制識別番号）が、年 2 回公開されています。 これは ecfr／federal-register に先行する主要な記録です。機関が「X を提案する予定」としている内容は、版ごとにここに掲載され、同じ規則が実際に公開または施行される何年も前に現れることがよくあります。

Pipeworx の一部です。AI エージェントを 1683 件以上の稼働中データソースにつなぐ MCP ゲートウェイです。

ツール

• reg_agenda_search(agency?, keyword?, stage?, edition?, limit?) — 機関、フリーテキストのキーワード、規則制定段階で RIN を検索します。デフォルトでは、保存されている最新の版が対象です。
• reg_rin(rin) — 1 つの RIN の全版にわたる詳細を表示し、段階／ステータスが時間とともにどう変化したかを示します。
• reg_agency_agenda(agency, edition?, limit?) — 1 つの版について、指定した機関の規制アジェンダ全体を rule_stage ごとにまとめて表示します。
• reg_agenda_coverage() — 現在読み込まれている版（最古／最新、合計行数）を表示します。

認証

キーは不要です。オペレーターキーは必要ありません。reginfo_rins を利用し、workers/data-pipeline によって毎月更新されます（データセット reginfo）。

データソース

• https://www.reginfo.gov/public/do/XMLReportList — 統合アジェンダのレポートインデックス。
• https://www.reginfo.gov/public/do/XMLViewFileAction?f=REGINFO_RIN_DATA_202504.xml — 年 2 回公開される版 1 件分の完全な XML（約 16.5 MB、約 3,800 件の RIN_INFO レコード）。 版は毎年 4 月（04）／10 月（10）に公開され、REGINFO_RIN_DATA_199510.xml から現在まであります。

存在しない版への応答は HTTP 404 ではなく HTTP 200 です。 reginfo.gov は、公開されなかった版に対して約 50 KB の HTML「そのようなレポートはありません」ページ（Content-Type: text/html）を返します。実在する版では Content-Type: application/xml が返されます。取り込み処理ではファイルを GET する前に HEAD リクエストでコンテンツタイプを確認するため、未公開の版（または 2000 年以前の期間に実際に存在する不定期の空白）については、HTML ページがデータに混入することなく、軽量な HEAD リクエストだけで済みます。

行は RIN ごとではなく、（rin, publication_id）ごとに 1 行です。 RIN の rule_stage は版ごとに変わります（「提案規則段階」→「最終規則段階」→「完了した措置」）。この履歴こそがこのデータセットの目的であるため、新しい版が古い版を上書きすることはありません。reg_rin は、RIN が掲載されたすべての版を新しい順に返します。

対象範囲は一度にではなく、段階的に拡大します。 バックフィルは、1995 年までの約 60 版すべてを一度に読み込むのではなく、版ごとに順次行われます。reg_agenda_coverage では、現時点で読み込み済みの版を正確に確認できるため、「まだバックフィルされていない」状態と「実際に公開されたことがない」状態を区別できます。

機関の照合では、名称、略称、コードを対象とし、直属の機関またはその親機関のどちらにも一致します。 たとえば「Interior」を指定すると、下位機関（Fish & Wildlife など）の規則も表示されます。ソースには RIN ごとに両階層の情報が記録されているためです。

概要はソース XML 内で CDATA に包まれた HTML です。 取り込み処理では abstract 列に書き込む前にタグを除去し、エンティティをデコードするため、呼び出し側に返るのは常にプレーンテキストです。

クイックスタート

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

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

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

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

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

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/reg_agenda_search \
  -H 'Content-Type: application/json' \
  -d '{"agency":"EPA","limit":25}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/reg_agenda_search を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

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

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も必要ありません。

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

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

npx -y @pipeworx/mcp-reginfo

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

ask_pipeworx を使用する

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

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

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

詳細

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

ライセンス

MIT