Skip to main content
Glama

Law Scrapper MCP

by numikel

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.

Python Version License Version

✨ 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)

# Clone the repository git clone https://github.com/numikel/law-scrapper-mcp.git cd law-scrapper-mcp # Install dependencies uv sync

Using pip

# Clone the repository git clone https://github.com/numikel/law-scrapper-mcp.git cd law-scrapper-mcp # Install dependencies pip install -e .

āš™ļø Configuration

MCP server configuration

Add the following configuration to your MCP client's configuration file:

For Cursor IDE (.cursor/mcp.json):

{ "mcpServers": { "law-scrapper-mcp": { "command": "uvx", "args": [ "--from", "git+https://github.com/numikel/law-scrapper-mcp", "law-scrapper" ], "transport": "stdio" } } }

For Claude Code:

claude mcp add law-scrapper-mcp uvx '--from' 'git+https://github.com/numikel/law-scrapper-mcp' 'law-scrapper'

For other MCP tools (.mcp.json or mcp_config.json):

{ "mcpServers": { "law-scrapper-mcp": { "command": "uvx", "args": [ "--from", "git+https://github.com/numikel/law-scrapper-mcp", "law-scrapper" ], "transport": "stdio" } } }

šŸŽÆ 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 analysis

  • calculate_date_offset - Calculate date ranges for legal periods

šŸ“š System metadata (6 tools)

  • get_legal_keywords - Access all available search keywords

  • get_legal_publishers - List all legal publishers (DU, MP)

  • get_publisher_details - Detailed publisher information

  • get_legal_statuses - Document status types

  • get_legal_types - Legal document types

  • get_legal_institutions - Involved institutions

šŸ” Acts browsing & search (2 tools)

  • search_legal_acts - Advanced multi-criteria search

  • get_publisher_year_acts - Browse acts by publisher and year

šŸ“‹ Act details & analysis (4 tools)

  • get_act_comprehensive_details - Complete document metadata

  • get_act_content - PDF/HTML content retrieval

  • get_act_table_of_contents - Document structure analysis

  • get_act_relationships - Legal references and amendments

šŸ“ Project structure

law-scrapper-mcp/ ā”œā”€ā”€ app.py # Main MCP server implementation with 14 legal research tools ā”œā”€ā”€ pyproject.toml # Project configuration, dependencies, and CLI scripts ā”œā”€ā”€ uv.lock # Lock file ensuring reproducible builds ā”œā”€ā”€ README.md # Project documentation └── __pycache__/ # Python bytecode cache (generated)

šŸ› ļø Development

Development setup

# Install in development mode uv sync # Run the server directly uv run app.py # Or use the installed script law-scrapper

Running tests

# Run basic functionality tests uv run python -c " import app print('Server imports successfully') funcs = [name for name in dir(app) if name.startswith('get_')] print(f'Available tools: {len(funcs)}') "

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

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes using Conventional Commits format

  4. Push to the branch (git push origin feature/amazing-feature)

  5. 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

@numikel


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.

Deploy Server
-
security - not tested
A
license - permissive license
-
quality - not tested

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.

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.

  1. ✨ Features
    1. šŸ“‹ Requirements / prerequisites
      1. šŸš€ Installation
        1. Using uv (recommended)
        2. Using pip
      2. āš™ļø Configuration
        1. MCP server configuration
      3. šŸŽÆ Quick start / usage
        1. Basic usage examples
        2. Available tool categories
      4. šŸ“ Project structure
        1. šŸ› ļø Development
          1. Development setup
          2. Running tests
          3. Code quality
        2. šŸ¤ Contributing
          1. Development guidelines
        3. šŸ“„ License
          1. šŸ‘¤ Author

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/numikel/law-scrapper-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server