MCP BOE

v1.0.0Search & Data Extractionstable

MCP server para el BOE 🇪🇸 — Acceso a legislación consolidada, sumarios diarios y tablas oficiales del Boletín Oficial del Estado mediante Model Context Protocol y API REST.

apiboegovernmentlegalmcp
Share:
40
Stars
0
Downloads
0
Weekly
0/5

What is MCP BOE?

MCP BOE is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server para el boe 🇪🇸 — acceso a legislación consolidada, sumarios diarios y tablas oficiales del boletín oficial del estado mediante model context protocol y api rest.

MCP server para el BOE 🇪🇸 — Acceso a legislación consolidada, sumarios diarios y tablas oficiales del Boletín Oficial del Estado mediante Model Context Protocol y API REST.

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server para el BOE 🇪🇸 — Acceso a legislación consolidada

Use Cases

Access Spanish government legislation through the Official Gazette (BOE), including consolidated laws, daily summaries, and official tables.
ComputingVictor

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-boe

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP BOE

MCP BOE is a Python MCP server that provides AI-powered access to Spain's Official State Gazette (Boletín Oficial del Estado), the authoritative source of Spanish legislation and official government publications. It exposes 31 tools covering consolidated law search and retrieval, daily and weekly BOE/BORME summaries, auxiliary classification tables, and PDF text extraction — all via the public BOE API, which requires no API key. Legal researchers, compliance teams, and developers building Spanish public-sector applications can use it to query, summarise, and compare legislation through natural language.

Prerequisites

  • Python 3.9 or higher installed
  • uv package manager installed (recommended) or pip as an alternative
  • An MCP-compatible client such as Claude Desktop
  • Internet access to reach the public BOE API (api.boe.es) — no API key required
1

Install via uvx (no clone required)

The easiest installation method is uvx, which fetches and runs the package directly from the GitHub repository without a permanent install.

uvx --from git+https://github.com/ComputingVictor/MCP-BOE.git mcp-boe
2

Or install from source with uv

Clone the repository and run the server with uv for more control over the environment.

git clone https://github.com/ComputingVictor/MCP-BOE.git
cd MCP-BOE
uv run python -m mcp_boe.server
3

Verify the server starts correctly

Run the diagnostic mode to confirm the server can reach the BOE API and all tools load without errors.

python -m mcp_boe.server --mode diagnose
4

Configure Claude Desktop

Add the MCP BOE server to your claude_desktop_config.json. The recommended approach uses uvx so no permanent installation is needed.

MCP BOE Examples

Client configuration

Claude Desktop configuration using uvx to run MCP BOE directly from the GitHub repository. No environment variables are required as the BOE API is public.

{
  "mcpServers": {
    "mcp-boe": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ComputingVictor/MCP-BOE.git", "mcp-boe"],
      "env": {
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

Prompts to try

Sample prompts covering legislation search, daily summaries, PDF reading, and law comparison.

- "Busca la Ley Orgánica 3/2018 de Protección de Datos y dame un resumen de sus puntos principales"
- "Dame el sumario del BOE de hoy y destaca las nuevas normas con rango de ley"
- "Lee el PDF de BOE-A-2023-12345 y explícame qué regula"
- "Compara la Ley 39/2015 y la Ley 40/2015 e indica las principales diferencias entre ambas"

Troubleshooting MCP BOE

Connection timeout errors when querying legislation

The BOE API can be slow during peak hours. Increase the timeout by setting BOE_HTTP_TIMEOUT=60 in the env block of your MCP client config. You can also raise BOE_MAX_RETRIES to 5 for transient failures.

uvx command not found

Install uv (which provides uvx): curl -LsSf https://astral.sh/uv/install.sh | sh — then restart your terminal or source your shell profile. Alternatively, use the pip installation method.

PDF extraction returns empty or truncated text

The PDF tool has a maximum extraction limit of 80,000 characters. For very long documents, request specific sections by article number rather than extracting the entire document at once.

Frequently Asked Questions about MCP BOE

What is MCP BOE?

MCP BOE is a Model Context Protocol (MCP) server that mcp server para el boe 🇪🇸 — acceso a legislación consolidada, sumarios diarios y tablas oficiales del boletín oficial del estado mediante model context protocol y api rest. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP BOE?

Follow the installation instructions on the MCP BOE GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP BOE?

MCP BOE works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP BOE free to use?

Yes, MCP BOE is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-boe": { "command": "npx", "args": ["-y", "mcp-boe"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP BOE?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides