Utilizes Git version control for repository management and development workflow
Hosted on GitHub for source code management, distribution, and collaborative development
Built using Python programming language with FastMCP framework for MCP server implementation
Displays project status badges for Python version, license, and version information
Law Scrapper MCP šāļø
A comprehensive Model Context Protocol (MCP) server for accessing and analyzing Polish legal acts from the Sejm API, enabling AI-powered legal research and document analysis.
⨠Features
ā Comprehensive legal act access - Full access to Polish legal acts from Dziennik Ustaw and Monitor Polski ā Advanced search & filtering - Multi-criteria search by date, type, keywords, publisher, and status ā Detailed document analysis - Complete metadata, structure, references, and content retrieval ā Date & time utilities - Specialized date calculations for legal document analysis ā System metadata access - Keywords, statuses, document types, and institution data ā FastMCP integration - Built with FastMCP framework following best practices ā Professional documentation - Extensive examples and clear parameter descriptions ā RESTful API integration - Direct connection to official Sejm API endpoints
š Requirements / prerequisites
Python: 3.12 or higher
Package manager: uv (recommended) or pip
Internet connection: Required for accessing Sejm API endpoints
MCP-compatible tool: Cursor IDE, Claude Code, or other MCP-supported applications
š Installation
Using uv (recommended)
Using pip
āļø Configuration
MCP server configuration
Add the following configuration to your MCP client's configuration file:
For Cursor IDE (.cursor/mcp.json
):
For Claude Code:
For other MCP tools (.mcp.json
or mcp_config.json
):
šÆ Quick start / usage
Once configured, you can start using the legal research tools:
Basic usage examples
Get current date for legal analysis:
"What is today's date?"
Search for specific legal acts:
"Find all regulations from 2020 containing 'environment'"
Analyze document structure:
"Show me the table of contents for act DU/2020/1"
Get comprehensive document details:
"Give me full information about legal act DU/2020/1280"
Available tool categories
The server provides 14 specialized tools organized in 4 categories:
š Dates & time (2 tools)
get_current_date
- Get current date for legal analysiscalculate_date_offset
- Calculate date ranges for legal periods
š System metadata (6 tools)
get_legal_keywords
- Access all available search keywordsget_legal_publishers
- List all legal publishers (DU, MP)get_publisher_details
- Detailed publisher informationget_legal_statuses
- Document status typesget_legal_types
- Legal document typesget_legal_institutions
- Involved institutions
š Acts browsing & search (2 tools)
search_legal_acts
- Advanced multi-criteria searchget_publisher_year_acts
- Browse acts by publisher and year
š Act details & analysis (4 tools)
get_act_comprehensive_details
- Complete document metadataget_act_content
- PDF/HTML content retrievalget_act_table_of_contents
- Document structure analysisget_act_relationships
- Legal references and amendments
š Project structure
š ļø Development
Development setup
Running tests
Code quality
The project follows FastMCP best practices:
Tagged Tools: All tools have descriptive tags for filtering
Annotated Parameters: Every parameter has clear descriptions
Comprehensive Examples: Minimum 5 examples per tool
Professional Documentation: Detailed docstrings and usage examples
š¤ Contributing
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature
)Commit your changes using Conventional Commits format
Push to the branch (
git push origin feature/amazing-feature
)Open a Pull Request
Development guidelines
Follow FastMCP best practices for tool definitions
Include comprehensive examples and parameter descriptions
Add appropriate tags for tool categorization
Test all new functionality before submitting
Use English for all code comments and documentation
š License
This project is licensed under the MIT License
š¤ Author
Legal disclaimer: This tool provides access to Polish legal documents for research purposes. Always consult with qualified legal professionals for legal advice and interpretation of laws.
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.
Tools
Enables AI-powered legal research and analysis of Polish legal acts from the Sejm API. Provides comprehensive search, document retrieval, metadata analysis, and content access for legal documents from Dziennik Ustaw and Monitor Polski.