Spanish Public Info Radar MCP

The Spanish Public Data MCP server provides 26 tools to query the open data of the Spanish government, including grants, regulations, company registrations, statistical data, and open data catalogs.

Research and data Law and compliance #Government Data #Spain #Open Data #Real - time Query .Python

rating : 2.5 points

downloads : 7.4K

update time : 2026-03-13

Open Site

What is the Spanish Public Data Query Assistant?

This is an extended tool specifically designed for Claude AI, enabling Claude to directly query the official open data of the Spanish government. Through this tool, Claude can help you find government grants, laws and regulations, company registration information, economic statistical data, etc. in Spain. All data comes from the official APIs of the Spanish government, ensuring the accuracy and timeliness of the information.

How to use this tool?

You just need to configure this tool in Claude Desktop, and then you can talk to Claude as usual. When you need to query Spanish public data, Claude will automatically call the corresponding tools to obtain the latest information. For example, you can ask 'Find the government grants in the last month' or 'What is the latest inflation rate in Spain?'.

Applicable scenarios

This tool is especially suitable for users who need to query Spanish government information, including: researchers looking for statistical data, business owners seeking grant opportunities, legal workers querying regulations, investors understanding company information, students working on research projects, etc. Whether you are an individual user or a professional, you can obtain valuable official information from it.

Main Features

Government Grants Query

Query the grant projects in the Spanish National Grants Database (BDNS), including the open grant applications and the information of the issued grants. It can be filtered by various conditions such as date range, issuing agency, and beneficiary.

Laws and Regulations Query

Query the laws and regulations in the Spanish Official Gazette (BOE), including the full legal text, legal structure, and relevant legal references. It supports querying by various classifications such as department, legal type, and theme.

Company Registration Information

Query the company registration, change, dissolution and other information in the Spanish Commercial Registry Gazette (BORME). You can obtain the company registration summary for a specific date.

Statistical Data Query

Query the official statistical data of the Spanish National Institute of Statistics (INE), including more than 400 statistical items such as CPI inflation rate, unemployment rate, GDP growth rate, and population census.

Open Data Catalog

Query more than 40,000 data sets on the Spanish National Open Data Platform (datos.gob.es), covering various fields such as environment, transportation, economy, and society.

Comprehensive Research Function

Supports comprehensive queries across data sources. For example, you can query the grant records and company registration information of a company at the same time, or conduct analysis by combining laws and regulations with statistical data.

Advantages

Authoritative data source: All data comes from the official APIs of the Spanish government, ensuring the accuracy and authority of the information.

Real - time update: The data is directly obtained from the government server without waiting for database updates.

Easy to use: You can query by talking to Claude in natural language without learning complex API calls.

Comprehensive functions: 26 query tools cover all aspects of Spanish public data.

Free to use: Based on the open data services of the Spanish government, it is completely free.

Limitations

Dependent on network connection: A stable Internet connection is required to access the government APIs.

API restrictions: Some government APIs may have query frequency restrictions.

Data update cycle: The update frequencies of different data vary (daily, monthly, quarterly, etc.).

No updates on weekends: BOE and BORME do not publish new content on weekends and holidays.

Requires Claude Desktop: Currently, it mainly supports the Claude Desktop client.

How to Use

Installation Preparation

Ensure that your computer has Python 3.11 or a higher version installed, and install the uv package management tool (recommended) or pip.

Download the Tool

Download the code of the Spanish Public Data Query Assistant from GitHub to the local directory.

Install Dependencies

Install all the dependency packages required for the tool to run.

Configure Claude Desktop

Find the configuration file of Claude Desktop, select the corresponding path according to your operating system, and then add the MCP server configuration.

Add Configuration Content

Add the following content to the configuration file, and note to modify the path to your actual installation path.

Restart and Verify

Completely close and reopen Claude Desktop, and then ask Claude what Spanish public data tools are available.

Usage Examples

Case 1: Looking for Startup Grants

Entrepreneur Zhang San wants to learn about the grant opportunities provided by the Spanish government for startups and check the relevant laws and regulations.

Case 2: Market Research and Analysis

Market analyst Li Si needs to conduct a market analysis for the Spanish renewable energy industry and needs economic data and company information.

Case 3: Academic Research Support

Graduate student Wang Wu is researching the Spanish social security system and needs official statistical data and research data.

Case 4: Corporate Compliance Check

Corporate legal counsel Zhao Liu needs to check whether the company complies with the latest data protection regulations and see if the company has any violation records.

Frequently Asked Questions

Is this tool free?

Do I need programming knowledge to use it?

What is the data update frequency?

Which operating systems are supported?

Is there a limit on the number of queries?

Is the data accurate?

Can I query historical data?

What if Claude Desktop cannot find the MCP server?

Related Resources

GitHub Project Homepage

The source code, issue feedback, and latest updates of the project.

Spanish Official Gazette API Documentation

The official documentation of the BOE open data API.

Spanish National Institute of Statistics API Manual

The API usage manual for INE statistical data.

National Grants Database API

The Swagger API documentation for BDNS grant data.

Spanish Open Data Platform

The open data API documentation of datos.gob.es.

Model Context Protocol Official Website

The official documentation and specifications of the MCP protocol.

Claude Desktop Download

The official download page for the Claude Desktop client.

🚀 Spanish Public Data MCP

An MCP server for querying Spanish government open data APIs.

🚀 Quick Start

Option 1: Run directly (development/testing)

# Install dependencies
uv sync

# Run MCP server (HTTP/SSE mode)
uv run python -m public_radar

# Or on a specific port
uv run python -m public_radar --port 9000

# Or in stdio mode (for Claude Desktop)
uv run python -m public_radar --stdio

Option 2: With Docker

# Build and run
docker-compose up -d

# View logs
docker-compose logs -f

# Stop
docker-compose down

Verify it works

# Health check (HTTP mode)
curl http://localhost:8080/health

# Should return: {"status":"healthy","service":"spanish-public-data-mcp"}

✨ Features

Spanish Public Data MCP provides LLM-friendly tools for querying Spanish government data on-the-fly:

BDNS - National Grants Database (grants and subsidies)
BOE - Official Gazette (consolidated legislation)
BORME - Company Registry Gazette (company acts)
INE - National Statistics Institute (official statistics)
datos.gob.es - National Open Data Catalog (40,000+ datasets)

Architecture: On-the-fly queries to official APIs. No database required.

Total: 26 MCP tools | 211 tests | 53%+ coverage

📦 Installation

# Clone repository
git clone https://github.com/mjgmario/spanish-public-info-radar-mcp.git
cd spanish-public-data-mcp

# Install with uv (recommended)
uv sync

# For development
uv sync --extra dev

💻 Usage Examples

Claude Desktop Integration

Step 1: Locate your config file

The Claude Desktop configuration file is located at:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Step 2: Add the MCP server configuration

Open the config file and add the following:

{
  "mcpServers": {
    "spanish-public-data": {
      "command": "uv",
      "args": ["run", "python", "-m", "public_radar", "--stdio"],
      "cwd": "C:\\Users\\YOUR_USER\\path\\to\\spanish-public-data-mcp"
    }
  }
}

Note: Replace YOUR_USER and the path with your actual installation path.

Step 3: Restart Claude Desktop

Close and reopen Claude Desktop to load the new MCP server.

Step 4: Verify the connection

Ask Claude: "What Spanish public data tools do you have available?" Claude should respond with information about the 26 available tools.

Example Queries for Claude

Grants & Subsidies (BDNS)

"Find grants published in the last month"
"Search for grants related to innovation or R&D"
"What grants has the company with NIF B12345678 received?"
"Show me details of grant BDNS 123456"

Legislation (BOE)

"Search for laws about renewable energy"
"What was published in the BOE today?"
"Find legislation about public subsidies from 2023"
"Show me the full text of the data protection law"

Company Registry (BORME)

"What companies were registered in Madrid today?"
"Show me the BORME summary for January 15, 2024"
"Find recent company dissolutions"

Statistics (INE)

"What statistical operations are available from INE?"
"Show me the latest CPI (IPC) data"
"Get unemployment statistics from the EPA survey"
"What is the current inflation rate in Spain?"
"Show me GDP growth data for the last 12 quarters"
"Find tables about population in the Census operation"

Combined Research

"I want to investigate company XYZ. Check:
1. What grants have they received?
2. Any recent BORME entries about them?"
"Find all funding opportunities for renewable energy projects:
1. Current open grants
2. Relevant legislation"
"Give me an economic overview of Spain:
1. Latest unemployment rate (EPA)
2. Current inflation (IPC)
3. Recent GDP growth"

Open Data (datos.gob.es)

"Search for datasets about air quality"
"Find open data from the Madrid city council"
"What data categories are available in datos.gob.es?"
"Show me details of dataset e05068001-mapas-estrategicos-de-ruido"

📚 Documentation

Available MCP Tools

BDNS (Grants) - 3 tools

Tool	Description
`search_grants`	Search grant calls by date range and granting body
`search_grant_awards`	Search awarded grants by date range and beneficiary NIF
`get_grant_details`	Get detailed information about a specific grant call

BOE (Legislation) - 11 tools

Tool	Description
`search_legislation`	Search consolidated laws with filters (query, dates, department, legal range, matter)
`get_legislation_details`	Get metadata of a specific law or regulation (optionally with legal analysis)
`get_legislation_text`	Get full consolidated text of a law
`get_legislation_structure`	Get the structure/index of a law (articles, dispositions, annexes)
`get_legislation_block`	Get a specific block (article, disposition) from a law
`get_departments_table`	Get list of government departments with codes
`get_legal_ranges_table`	Get list of legal norm types (Ley, Real Decreto, etc.)
`get_matters_table`	Get list of subject matters/topics with codes
`find_related_laws`	Find laws related to a given legislation (modifications, repeals, references)
`search_recent_boe`	Search BOE publications from the last N days with filters
`get_boe_summary`	Get the daily BOE summary for a specific date (with filters)

BORME (Company Registry) - 1 tool

Tool	Description
`get_borme_summary`	Get daily company registry acts for a specific date

INE (Statistics) - 6 tools

Tool	Description
`get_ine_operations`	List all available statistical operations (IPC, EPA, PIB, etc.)
`get_ine_operation`	Get details of a specific statistical operation
`get_ine_table_data`	Get data from a specific statistical table
`get_ine_series_data`	Get time series data by series code
`search_ine_tables`	Search for tables within a statistical operation
`get_ine_variables`	List available variables, optionally filtered by operation

datos.gob.es (Open Data) - 4 tools

Tool	Description
`search_open_data`	Search datasets in the national open data catalog
`get_open_data_details`	Get detailed information about a specific dataset
`list_open_data_themes`	List available themes/categories
`list_open_data_publishers`	List publishing organizations

General - 1 tool

Tool	Description
`get_system_info`	Get overview of available data sources and tools

Tool Parameters Reference

search_grants

{
  "date_from": "2024-01-01",    // Optional: Start date (YYYY-MM-DD)
  "date_to": "2024-12-31",      // Optional: End date (YYYY-MM-DD)
  "granting_body": "E00003901", // Optional: Granting body code
  "limit": 20                   // Optional: Max results (1-100, default 20)
}

search_grant_awards

{
  "date_from": "2024-01-01",      // Optional: Start date
  "date_to": "2024-12-31",        // Optional: End date
  "beneficiary_nif": "B12345678", // Optional: Beneficiary NIF/CIF
  "limit": 20                     // Optional: Max results
}

get_grant_details

{
  "grant_id": "123456"  // Required: BDNS grant ID
}

search_legislation

{
  "query": "energias renovables",  // Required: Search text
  "date_from": "2020-01-01",       // Optional: Start date
  "date_to": "2024-12-31",         // Optional: End date
  "title": "ley energia",          // Optional: Filter by title
  "department_code": "4225",       // Optional: Department code (use get_departments_table)
  "legal_range_code": "ley",       // Optional: Legal range (use get_legal_ranges_table)
  "matter_code": "170",            // Optional: Matter code (use get_matters_table)
  "include_derogated": false,      // Optional: Include repealed laws (default false)
  "offset": 0,                     // Optional: Skip results (pagination)
  "limit": 20                      // Optional: Max results (1-100)
}

get_legislation_details

{
  "legislation_id": "BOE-A-2015-10566"  // Required: BOE legislation ID
}

get_legislation_text

{
  "legislation_id": "BOE-A-2015-10566"  // Required: BOE legislation ID
}

get_legislation_structure

{
  "legislation_id": "BOE-A-2015-10566"  // Required: BOE legislation ID
}

get_legislation_block

{
  "legislation_id": "BOE-A-2015-10566", // Required: BOE legislation ID
  "block_id": "a1"                       // Required: Block ID (e.g., "a1" for article 1)
}

get_departments_table

{}  // No parameters required

get_legal_ranges_table

{}  // No parameters required

get_matters_table

{}  // No parameters required

get_boe_summary

{
  "date": "2024-01-15"  // Optional: Date (YYYY-MM-DD), defaults to today
}

get_borme_summary

{
  "date": "2024-01-15"  // Optional: Date (YYYY-MM-DD), defaults to today
}

get_ine_operations

{}  // No parameters required

get_ine_operation

{
  "operation_id": "IPC"  // Required: Operation ID or code (e.g., 'IPC', 'EPA', '25')
}

get_ine_table_data

{
  "table_id": "50902",  // Required: Table ID from INE
  "nult": 12            // Optional: Number of last periods (1-100, default 12)
}

get_ine_series_data

{
  "series_code": "IPC251856", // Required: Series code from INE
  "nult": 12                   // Optional: Number of last periods (1-100, default 12)
}

search_ine_tables

{
  "operation_id": "IPC"  // Required: Operation ID to search tables for
}

get_ine_variables

{
  "operation_id": "IPC"  // Optional: Filter variables by operation
}

search_open_data

{
  "query": "air quality",           // Optional: Search text
  "theme": "medio-ambiente",        // Optional: Theme code
  "publisher": "L01280796",         // Optional: Publisher ID
  "limit": 20                       // Optional: Max results (1-100)
}

get_open_data_details

{
  "dataset_id": "e05068001-mapas-estrategicos-de-ruido"  // Required: Dataset ID
}

list_open_data_themes

{}  // No parameters required

list_open_data_publishers

{
  "limit": 50  // Optional: Max results (default 50)
}

Project Structure

src/public_radar/
├── common/          # HTTP client, dates, logging
├── sources/         # API clients (BDNS, BOE, INE, datos.gob.es)
│   ├── bdns.py      # BDNS client (grants)
│   ├── boe.py       # BOE client (legislation, BORME)
│   ├── ine.py       # INE client (statistics)
│   └── datos_gob.py # datos.gob.es client (open data)
├── mcp/             # MCP server and tools
│   ├── server.py    # MCP server + 26 tool handlers
│   └── logging.py   # Tool call logging (JSONL)
├── __init__.py
└── __main__.py      # CLI entry point

tests/
├── unit/            # Unit tests with mocks (168 tests)
├── integration/     # Real API tests (43 tests)
└── fixtures/        # Sample API responses

Configuration

Environment Variables

Variable	Description	Default
`MCP_HOST`	Host to bind SSE server	`0.0.0.0`
`MCP_PORT`	Port for SSE server	`8080`
`MCP_LOGS_DIR`	Directory for tool call logs	`./logs`
`LOG_LEVEL`	Logging level	`INFO`

Tool Call Logging

All MCP tool calls are logged to logs/mcp_calls_YYYY-MM-DD.jsonl:

{
  "timestamp": "2024-01-15T10:30:00Z",
  "tool": "search_grants",
  "input": {"date_from": "2024-01-01", "limit": 10},
  "output_summary": {"count": 10, "first_title": "..."},
  "duration_ms": 450,
  "success": true,
  "error": null
}

Logs are automatically rotated (deleted after 7 days).

Docker Deployment

# Start MCP server
docker-compose up -d

# Check health
curl http://localhost:8080/health

# View logs
docker-compose logs -f mcp

# Stop server
docker-compose down

Development

# Install dev dependencies
uv sync --extra dev

# Run tests
uv run pytest

# Run with coverage
uv run pytest --cov

# Run linting
uv run pre-commit run --all-files

# Type checking
uv run mypy src/

Current Test Coverage

211 tests passing (168 unit + 43 integration)
53%+ code coverage (unit tests only)
Unit tests for all parsers and tool handlers
Integration tests for real API calls (BDNS, BOE, INE, datos.gob.es)

Data Sources

Source	API	Description
BDNS	Swagger	National Grants Database
BOE	Open Data	Official Gazette & Legislation
INE	API Manual	National Statistics Institute
datos.gob.es	API Data	National Open Data Catalog