Skip to main content

federal-register-mcp

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

No authentication required. MCP is an open standard: this server runs in any MCP client, not just Claude. Executed and verified on eleven platforms in August 2026 (see Configuration).

Tested and hardened through six rounds of integration testing against the live Federal Register API. 228 regression tests (132 offline, 96 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. See testing.md for the full testing 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

MCP is an open standard, and this config was executed and verified in August 2026 on eleven platforms: Claude Desktop, Claude Code, Codex Desktop and CLI, Gemini via Antigravity, GitHub Copilot CLI, DeepSeek Harness, Grok Build, Cursor, opencode, and LibreChat. Most clients take the same JSON block below and differ only in where the config file lives; the universal setup guide (PDF) has the exact file path and format for every platform, including the Codex TOML form.

{
  "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.

Request pacing

Every upstream request uses a provisional 3-second cross-process anti-burst interval by default. Federal Register does not publish a numeric limit, so this is a 1102tools safeguard rather than a provider requirement. Override with FEDERAL_API_MIN_INTERVAL_SECONDS, use 0 to deliberately disable it, and use FEDERAL_API_PACING_DIR to relocate local pacing state.

License

MIT

Release files for federal-register-mcp 1.0.3

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.3
File Size Uploaded
federal_register_mcp-1.0.3.tar.gz 122.1 kB Details

Built distribution (wheel)

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

Total release size: 140.7 kB

Release files / federal_register_mcp-1.0.3.tar.gz

Download URL federal_register_mcp-1.0.3.tar.gz
Size 122.1 kB
Tags Source
SHA-256 checksum
How to use checksums
a4354779127a651cf423499a9d869e7b58a3973a792a4a4d2f97c41f69536013
BLAKE2b-256 checksum
How to use checksums
b0f7387b7f5fb996a353e3b6878c623b9b0c377fd97d1d4446b77c230fab0a71
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 Aug 22, 2026.

Transparency log

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

Download URL federal_register_mcp-1.0.3-py3-none-any.whl
Size 18.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1bd12a288fa333e7977eedb5303118164444df7e3a8f75c8f61df75a6d591ee5
BLAKE2b-256 checksum
How to use checksums
b1b5930c2d59fed7a7c5b6a359dfdf7bf404b9a08a02938ff341f4d786c9c5f1
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 Aug 22, 2026.

Transparency log

Release history Release notifications | RSS feed

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

This release

1.0.3 This release

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