@pipeworx/govinfo

Connect: https://gateway.pipeworx.io/govinfo/mcp · Install: one-click buttons

Tools: 7

GovInfo.gov MCP — full text of US government publications.

Tools

• list_collections()
• search_packages(query, collections?, congress?, date_from?, date_to?, page_size?, offset_mark?)
  • collections takes one code or several, comma- or space-separated ("CHRG", "CHRG,CRPT"). Several codes search the union — "CHRG,CRPT" returns 9,239 hits for “Cooper”, exactly the 5,359 + 3,880 the two collections return on their own.
  • page_size also answers to limit.
• get_package(package_id)
• list_granules(package_id, page_size?, offset_mark?) — page_size also answers to limit.
• get_granule(package_id, granule_id)

Auth

• Platform key: reuses PLATFORM_DATAGOV_KEY.
• BYO: ?_apiKey=<key> (api.data.gov key).

Data source

https://api.govinfo.gov — ?api_key= query param.

GAO appropriations law (fleet #1972)

Two tools that make GAO’s secondary authority reachable by TOPIC rather than by package id.

gao_red_book(topic?, chapter?, include_scope_text?)

Resolves a fiscal-law question to the governing chapter of GAO’s Principles of Federal Appropriations Law — the Red Book. Keyless: it reads www.gao.gov, not the GovInfo API, so it works with no data.gov key.

Why it does not use GovInfo. Measured 2026-09-14: the GAOREPORTS collection holds 16,569 packages but zero issued after 2010-01-01, and a full-text search for “Principles of Federal Appropriations Law” returns exactly one relevant package in its top 100 of 1,565 hits — the 2004 Update of the Third Edition. GovInfo cannot serve the current Red Book at all.

Edition handling is the point. GAO now publishes the Red Book chapter by chapter, so the current treatise is a mix:

“Our current Red Book consists of Chapters 1-3 (of the 4th Edition) and Chapters 5-15 (of the 3rd Edition).” — gao.gov, read live on every call

That sentence and the whole table of contents are parsed from GAO’s page at call time rather than hardcoded, so Chapter 4 appears the day GAO posts it. Every row names its edition; the 2004 annual update is returned separately under superseded with the reason it is not the answer.

Freshness. source_last_modified is the Last-Modified of the chapter PDF itself. The TOC page’s Last-Modified is a Drupal render timestamp that reads as today on every call — using it would tell a caller a 2019 chapter was revised this morning.

How matching works, and what it is worth. Chapter titles come off GAO’s live page and are authoritative. On top of them sits RED_BOOK_TOPIC_ALIASES in src/index.ts — a list maintained in this pack, not something GAO publishes, which is why every matched row carries match_basis saying whether it matched title:, alias: or gao_scope:. The chapters are PDFs and GovInfo does not index them, so an alias cannot be verified against the text; entries are therefore restricted to terms that are the standard NAME of the rule the chapter’s own title states (bona fide needs rule → Availability of Appropriations: Time), the US Code section that rule lives at, or a plain-English framing of the question the chapter’s title asks. When nothing clears the score floor the tool returns match_confidence: "none" and the complete table of contents rather than a plausible wrong chapter.

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

GovInfo files GAO audit reports and Comptroller General decisions under one collection code — its own name says so, “Government Accountability Office Reports and Comptroller General Decisions” — so a relevance search interleaves them. Measured on "augmentation of appropriations": 100 hits examined, 15 of the top 25 were decisions; this tool returns the 26 decisions and drops the 74 reports, reporting both counts. The split is the package id (GAOREPORTS-B-…).

Coverage stops at 2009 — GAOREPORTS carries nothing newer. For recent bid protests use gao_protests_search; for the current rule use gao_red_book.

Tools

• list_collections — List GovInfo collections (BILLS, CFR, USCODE, FR, CHRG, CRPT, HMAN, PLAW, SERIALSET, USCOURTS, etc.) with package counts. Use the collection code with search_packages to filter.
• search_packages — Full-text + faceted search across GovInfo. Filter by one or more collection codes (BILLS, FR, CFR, USCODE, CHRG, CRPT, CREC, PLAW, USCOURTS…), date range, congress, and free-text query. Several code
• get_package — Metadata for a single package by packageId (e.g., “BILLS-118hr1234ih”, “FR-2024-05-12”). Returns title, dates, citations, granule count, download links (PDF/XML/MODS).
• list_granules — List granules within a package — e.g., sections of a CFR title, individual entries in a Federal Register issue. Returns granule IDs + titles.
• get_granule — Fetch summary metadata for a single granule (sub-unit) within a GovInfo package, given package_id and granule_id (both from list_granules). Returns title, class, and provenance fields from the GovInfo
• gao_red_book — Find the chapter of GAO’s Principles of Federal Appropriations Law — the Red Book — that governs a federal appropriations, fiscal-law or government-funding question, described in plain words. Answers
• gao_comptroller_decisions — Search Comptroller General decisions and opinions — the B-numbered rulings in which GAO decides federal appropriations and fiscal-law disputes, the precedent the Red Book itself cites. Give a topic in