AEMET (Spain's Meteorological Agency)

AEMET-MCP is a tool that integrates with the Spanish Meteorological Agency API through the MCP protocol, allowing users to query historical climate data and weather information from meteorological stations across Spain from compatible clients such as Claude AI.

Research and data Developer tools #Meteorological data #API integration #Historical climate .Python

rating : 2.5 points

downloads : 15

update time : 2025-04-28

What is AEMET-MCP?

AEMET-MCP is a meteorological data service based on the Model Context Protocol (MCP), allowing users to directly obtain historical and real-time weather data from the Spanish National Meteorological Agency (AEMET) through simple commands.

How to use AEMET-MCP?

Simply add the server configuration to an MCP-supported client and then enter simple query commands to obtain the required weather data.

Applicable scenarios

Suitable for researchers, developers, and individual users interested in weather who need to obtain historical weather records in the Spanish region.

Main features

Query historical daily dataSupports querying historical weather data such as temperature, wind speed, and precipitation.

Obtain monthly climate summariesProvides monthly climate summary reports by station.

Query beach conditionsProvides information such as radiation indices in beach areas.

Advantages and limitations

Advantages

Easily obtain weather data without programming skills

Supports multiple query methods, such as filtering by time range and station

Unified data format, easy to integrate into other applications

Limitations

Requires registering for an AEMET API key to use

Some advanced features may be restricted by the API

How to use

Install AEMET-MCP

Quickly install AEMET-MCP through Smithery or uv tools.

Configure the MCP client

Edit the client configuration file and add the AEMET-MCP server address.

Start querying data

Use natural language questions to obtain weather data.

Usage examples

Query the weather conditions in SevilleObtain real-time weather information in Seville.

Obtain the UV index of Maspalomas BeachObtain the UV index for a specified date.

Obtain the rainfall data of AlbaceteObtain precipitation within a specified time period.

Frequently Asked Questions

How to obtain an AEMET API key?

Does it support multi-language queries?

Are there any data usage restrictions?

Related resources

AEMET official documentation

Detailed description of the AEMET API.

AEMET-MCP GitHub repository

Project source code and update logs.

Smithery installation tutorial

Quick installation guide.

🚀 AEMET (Spanish National Meteorological Agency) MCP Integration

AEMET MCP Integration allows you to directly access historical climate data and meteorological information from the AEMET API through Claude AI and other MCP-compatible clients using the Model Context Protocol (MCP).

AEMET is the national meteorological agency of Spain.

Aemet-mcp enables you to obtain historical climate data and meteorological information directly from the AEMET API via Claude AI and other MCP-compatible clients, utilizing the Model Context Protocol (MCP).

Aemet-mcp is an MCP server that provides tools for LLMs to query data from meteorological stations in Spain.

It includes secure handling of API keys and JSON files to support data.

✨ Features

Query historical daily values (temperature, wind force, precipitation, etc.)
Access monthly climate summaries by meteorological station
Filter by year, month, and AEMET meteorological station code
Get beach conditions, including the UV radiation index
Receive responses in JSON format, ready for use in various applications

📦 Installation

Install via Smithery

To automatically install the AEMET weather data server via Smithery:

npx -y @smithery/cli install @AnCode666/aemet-mcp --client claude

Install from uv

Prerequisites

Python 3.10 or higher.
uv package manager.

Install uv

The first step is to install uv, a package manager for Python.
It can be installed via the command line.

On macOS and Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

On Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

You can also install it using pip:

pip install uv

For more information on installing uv, visit the uv documentation.

💻 Usage Examples

Integrate with Clients like Claude Desktop

Once you have installed uv, you can use this MCP server from any compatible client (e.g., Claude Desktop):

Go to Claude > Settings > Developer > Edit Configuration > claude_desktop_config.json
Add the following code block to "mcpServers":

"aemet_mcp_": {
    "command": "uvx",
    "args": [
        "aemet_mcp"
    ],
    "env": {
        "AEMET_API_KEY": "YOUR_AEMET_API_KEY"
    }
}

Obtain an API key for free from AEMET: https://opendata.aemet.es/centrodedescargas/altaUsuario
Replace YOUR_AEMET_API_KEY with your actual API key (keep the quotes).
If you have already configured other MCP servers, separate them with a comma ,.

In general, to integrate it with any other compatible client (e.g., Cursor, CODEGPT, or Roo Code), simply go to the client's MCP server configuration and add the same code block.

Basic Usage

After configuration, you can ask questions like the following:

- "What's the weather like in Seville?"
- "Tell me the radiation level at Maspalomas Beach tomorrow"
- "Show me the historical rainfall data in Albacete from January 1st to February 1st, 2020"