Skip to main content

federal-register-mcp

price: free license: MIT tools: 8 regression tests: 289

Free, open-source MCP server for the Federal Register API. Proposed rules, final rules, notices, executive orders, comment periods, and regulatory tracking since 1994.

No API key required, locally or hosted. See Local or hosted.

Tested and hardened through nine audit rounds and integration testing against the live Federal Register API. 289 collected regression tests (184 offline, 105 live-gated) covering the list_agencies pydantic crash that hit every call, payload bombs, silent-wrong-data docket matches, the pre-2011 archive lockout, and open-comment results that missed the soonest deadlines, FAR Council agency mapping, presidential filters, parent-agency public inspection, and page limits. See testing.md for the full testing record.

The October 10, 2026 content research round 3 found zero new defects in 54 ordinary and power-user calls across all eight tools. All 54 public answers matched primary-source comparisons, and all 54 answers from a fresh official PyPI 1.0.14 CLI installation matched the public service. The current offline suite passed 181 tests with 105 live-gated skips; no new full live-suite run is claimed. See the round 3 record for coverage and source limits.

The October 10, 2026 content research round 4 found zero new defects in 63 valid public questions across all eight tools. A fresh official PyPI 1.0.14 stdio CLI matched all 63 answers in substance (62 exactly; one source page-view timestamp differed). Current verification passed 181 offline tests with 105 live skips, distinct from the new content corpus. See the round 4 record for source comparisons, corrected audit selections and coverage limits.

Local or hosted

Local (desktop) Claude (hosted) ChatGPT (hosted)
Local setup Install Coming soon
  • Local runs it on your computer, inside the Claude or ChatGPT desktop app or another AI app. You get your own full rate limits, and it relies only on the government service. You don't have to set it up by hand: give your AI this page's link and ask it to set it up or walk you through it.
  • Hosted is the convenient option: one click, no keys, and it works in Claude or ChatGPT anywhere.

Compare local and hosted · Matching prompts

The October 10, 2026 content research round 5 found zero new content defects in 71 ordinary questions across all eight tools. A fresh official PyPI 1.0.14 stdio CLI matched all 71 public answers in substance (69 exactly; two dynamic page-view differences). Complete EPA/NRC/FCC/VA comment scans and deadline-to-document followups passed. Frozen tests passed 181 with 105 skips; the separate MCP 2.3 published-package lane retained 60 legacy validation/error-expectation failures (121 passed, 105 skipped). See the round 5 record for primary evidence, source bounds and execution distinctions.

The October 10, 2026 content research round 6 completed 71 genuinely new questions across all eight tools, plus one prior public-inspection control excluded from new coverage. All 72 valid published 1.0.14 CLI/public answers matched exactly. A new P3 scope/recovery finding is fixed in candidate 1.0.15: indexed comment metadata can omit a reopened period, so zero results and scan completeness now carry deadline-source verification guidance. The actual Coast Guard docket/detail followup recovers the October 29 DATES deadline while preserving the reported August 24 metadata. Candidate tests measured 184 passed/105 skipped frozen, and 124 passed/60 failed/105 skipped with SDK 2.3; those 60 retained legacy negatives are separate from passing ordinary content. Publication and actual 1.0.15 acceptance remain pending. See the round 6 record.

What it does

Exposes the Federal Register API as 8 MCP tools:

Core

  • search_documents - Search with flexible filters (agency, type, term, docket, dates, RIN, CFR title/part)
  • get_document - Full details for a single document by number
  • get_documents_batch - Fetch up to 20 documents in one call
  • get_facet_counts - Document counts by type, agency, topic, or time bucket (daily through yearly)
  • get_public_inspection - Pre-publication documents with client-side filtering
  • list_agencies - All ~470 agencies with slugs

Workflow

  • open_comment_periods - Currently open comment periods (sorted by deadline)
  • far_case_history - Full rulemaking history for a FAR/DFARS case

No authentication required

The Federal Register API is fully public. No key, no registration.

Installation

uvx federal-register-mcp

Configuration

Use the configuration below as the server definition and adapt its placement to your compatible MCP client. For practical requests using this source, see the prompt library.

{
  "mcpServers": {
    "federal-register": {
      "command": "uvx",
      "args": ["--refresh-package", "federal-register-mcp", "--from", "federal-register-mcp", "federal-register-mcp"]
    }
  }
}

The --refresh-package flag tells uv to check PyPI for a newer release each time your client launches the server, so fixes arrive automatically; without it, uv keeps serving whatever version it first cached. It adds a moment of network time at startup, so raise your platform's MCP startup timeout if it enforces a short one.

Restart the client and the tools appear.

Example prompts

  • "What FAR cases have open comment periods right now?"
  • "Show me the full rulemaking history for FAR Case 2023-008."
  • "Find all proposed rules from DoD published in the last 6 months."
  • "What significant rules has GSA published this fiscal year?"
  • "Are there any pre-publication documents related to procurement today?"
  • "How many proposed rules vs final rules has the SBA published since January?"
  • "Find executive orders related to federal acquisition from the last year."

Companion tools

  • ecfr-mcp: what the regulation currently says (the book)
  • federal-register-mcp: what is changing (the newspaper)

Together they cover the full regulatory pipeline. Use far_case_history to trace a rulemaking from proposal through final rule, then ecfr-mcp to read the codified result.

License

MIT

Open-comment completeness

open_comment_periods sorts the documents it scans by deadline. complete says whether every matching document was scanned; truncated also flags a result shortened by limit. An incomplete scan can omit a deadline earlier than one returned. Narrow with agencies or keywords, or use search_documents with comment_date_gte/comment_date_lte to verify a deadline window. FAR Council answers preserve the underlying scan metadata and flag lower-bound totals.

Metadata

Release files for federal-register-mcp 1.0.15

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for federal-register-mcp 1.0.15
File Size Uploaded
federal_register_mcp-1.0.15.tar.gz 159.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for federal-register-mcp 1.0.15
File Interpreter ABI Platform
federal_register_mcp-1.0.15-py3-none-any.whl Python 3 none any Details

Total release size: 193.1 kB

Release files / federal_register_mcp-1.0.15.tar.gz

Download URL federal_register_mcp-1.0.15.tar.gz
Size 159.0 kB
Tags Source
SHA-256 checksum
How to use checksums
554c963ab52728528d9bf8639aafdcedbc1158a1ecbe9cfd93b1fac9ce2f78cd
BLAKE2b-256 checksum
How to use checksums
edfae494bacd1ed08047be9ca24793806537259a63f2aeed45bda297066c65c7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.

Transparency log

Release files / federal_register_mcp-1.0.15-py3-none-any.whl

Download URL federal_register_mcp-1.0.15-py3-none-any.whl
Size 34.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b70d1bd87e52f184a8c4e7d1911b151af8d4a4a87a9e2664694f43f55d5da9ce
BLAKE2b-256 checksum
How to use checksums
c7811d79074430a5ddbdf54ac25c36266f9087c376ccbec8cc4222de09e03810
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.

Transparency log

Release history Release notifications | RSS feed

1.0.17

2 release files

1.0.16

2 release files

This release

1.0.15 This release

2 release files

1.0.14

2 release files

1.0.13

2 release files

1.0.12

2 release files

1.0.11

2 release files

1.0.9

2 release files

1.0.8

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page