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
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
- AsecurityAlicenseAqualityA Model Context Protocol server that enables LLMs to perform web searches using Google's Custom Search API through a standardized interface.Last updated -123TypeScriptMIT License
- 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 -475JavaScriptMIT 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 -1JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that provides Google Maps API integration, allowing users to search locations, get place details, geocode addresses, calculate distances, obtain directions, and retrieve elevation data through LLM processing capabilities.Last updated -716325TypeScriptMIT License