boe

Boe-mcp exposes tools to query Spain's consolidated legislation, daily BOE and BORME summaries, and legal reference data such as domains, departments, and legal relationships. It is designed for MCP-compatible clients and Claude AI integrations to fetch structured legal information efficiently. After configuring the MCP server in your MCP client, you can issue natural language prompts that are translated into precise API calls, such as retrieving the current state laws on data protection, obtaining the BOE summary for a specific date, or browsing the legal reference tables. The server supports block-level navigation of texts, historical summaries, and filtering by date, jurisdiction, and validity to refine results for your LLM workflows.

Prerequisites:

• Python 3.10+.
• uv package manager (install instructions below).

1. Install uv

   • On macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
   • On Windows: powershell -ExecutionPolicy ByPass -c " irm https://astral.sh/uv/install.ps1 | iex"
   • Alternatively, install via pip: pip install uv

2. Verify installation

   • uv --version

3. Run the MCP server locally (example)

   • This assumes the boj_mcp module is discoverable by uvx (the MCP server name as registered by uv):

uvx boe_mcp

4. Configure clients
   • In your MCP client or Claude integration, add the server configuration under mcpServers (see integration section in README). For example:

"boe_mcp": {
  "command": "uvx",
  "args": ["boe_mcp"]
}

5. Optional: run with environment variables as needed by your deployment (see additional notes below).

Tips and common considerations:

• The Boe-MCP server is accessed via uvx with the server name boe_mcp. Ensure the server name matches your environment configuration.
• If you deploy in a containerized or serverless environment, make sure uvx is installed in the runtime and that the boe_mcp module is accessible to uvx.
• You can expose API keys or tokens to access restricted BOE/BORME data if required by your setup via environment variables (not populated by default).
• For Claude or other MCP clients, add the boe_mcp block under mcpServers in your config, and separate multiple servers with commas.
• If you encounter issues finding the server module, ensure your Python path and uvx installation are correct and that boe_mcp is the registered server name.
• Update frequency: depending on data sources, you may want to refresh or cache daily summaries; consider tooling around schedule triggers if supported by your MCP client.