Supports environment variable configuration through .env files for setting API keys and other configuration options
Provides test suite integration for validating the functionality of GovInfo API connections and tool operations
Built with Python 3.12+ as the runtime environment for the MCP server implementation
Optimized for deployment on Ubuntu/Linux environments with bash command support
Enables retrieval of U.S. government documents in XML format, allowing for structured access to official publications like regulations, statutes, and bills
GovInfo MCP Server
A Model Context Protocol (MCP) server that provides LLM-friendly access to the official GovInfo API v4. This server enables searching and retrieving U.S. government documents, including bills, laws, regulations, and other official publications, for precise legal research and citation verification.
🎯 Purpose
The GovInfo MCP Server provides comprehensive access to federal regulations, statutes, and government documents through the GovInfo API. It is designed for LLMs and legal research tools to programmatically access up-to-date U.S. government information.
📦 Key Features
- Access to bills, statutes, regulations (CFR), and more
- Real-time updates from the official GovInfo API
- Retrieve full document text and metadata in HTML, XML, PDF, or plain text
- Search by keyword, collection, date, and more
- Explore related documents and cross-references
🛠️ Available MCP Tools
Tool Name | Description | Example Call |
---|---|---|
get_collections | List all available GovInfo collections | get_collections(page_size=10) |
get_collection_details | Get details for a specific collection | get_collection_details(collection_code="CFR") |
search_packages | Search packages by query and filters | search_packages(query="discovery procedures", collection="CFR", page_size=5) |
advanced_search | Advanced search with Lucene syntax and filters | advanced_search(query="title:discovery AND collection:CFR", sort_by="relevance") |
get_packages_by_collection | List packages from a collection | get_packages_by_collection(collection="BILLS", congress=118, page_size=5) |
get_package_summary | Get metadata for a specific package | get_package_summary(package_id="CFR-2023-title5-vol3") |
get_package_content | Download package content in various formats | get_package_content(package_id="CFR-2023-title5-vol3", content_type="html") |
get_published_packages | Get packages published on a specific date | get_published_packages(date_issued="2024-01-15", collection="CFR") |
get_published_range | Get packages published within a date range | get_published_range(start_date="2024-01-01", end_date="2024-01-31", collection="PLAW") |
get_related_packages | Find packages related to a specific package | get_related_packages(package_id="BILLS-118hr1234-ih") |
get_granule_related | Find items related to a specific granule | get_granule_related(package_id="CFR-2023-title5-vol3", granule_id="CFR-2023-title5-vol3-sec1201-72") |
search_statutes | Search US statutes across statute collections | search_statutes(query="civil rights", collection="USCODE", page_size=5) |
get_public_laws_by_congress | List public laws from a specific Congress | get_public_laws_by_congress(congress=117, page_size=5) |
get_statutes_at_large | Search Statutes at Large by volume | get_statutes_at_large(volume="137", page_size=5) |
get_uscode_title | Search US Code sections within a title | get_uscode_title(title_number="42", page_size=5) |
list_statute_collections | List all statute-related collections | list_statute_collections() |
See app/README.md for full tool parameter documentation.
🚀 Setup
Prerequisites
- Python 3.12+
- uv for dependency management (Poetry is NOT used)
- Internet connection for GovInfo API access
- GovInfo API key (set
GOVINFO_API_KEY
in your environment) - Ubuntu/Linux recommended (all commands below are for bash)
Installation
- Clone the repository and navigate to the GovInfo project directory:
- Install dependencies using uv:
- Set your GovInfo API key:
- (Optional) Copy
.env.example
to.env
and edit as needed.
Running the Server
Start the MCP server:
Or use the VS Code task "Run MCP Server".
Running Tests
See tests/README.md for details. Typical usage:
API Usage
See app/README.md for detailed tool documentation and usage examples.
🔗 Links
📝 Notes
- All code examples are tested and working.
- File paths use relative references from the project root.
- All commands use
uv run
where needed. - For Ubuntu/Linux. For Windows, adapt commands as needed.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that provides LLM-friendly access to the official GovInfo API for searching and retrieving U.S. government documents including bills, laws, regulations, and other official publications.
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that provides access to government datasets from Data.gov, enabling users to search packages, view dataset details, list groups and tags, and access resources by URL.Last updated -468614JavaScriptMIT License
- AsecurityFlicenseAqualityAn MCP server that enables users to search for government grants based on keywords and view detailed information including funding, eligibility, and deadlines.Last updated -13JavaScript
- AsecurityFlicenseAqualityA Model Context Protocol server implementation that provides structured, AI-friendly access to eRegulations data, making it easier for AI models to answer user questions about administrative procedures.Last updated -4671TypeScript
- AsecurityFlicenseAqualityA Model Context Protocol server that enables LLMs to explore and interact with API specifications by providing tools for loading, browsing, and getting detailed information about API endpoints.Last updated -43913TypeScript