IPMA

You run the IPMA MCP Server to access Portuguese weather data through natural language queries. The MCP exposes forecasts, warnings, seismic data, real-time station observations, UV index forecasts, and a list of available locations, all via a simple commandable interface that your MCP client can talk to.

How to use

Once your IPMA MCP Server is running, you interact with it through your MCP client by calling its tools with natural language prompts. You can ask for a city’s forecast for a certain number of days, check active weather warnings, view recent seismic events, see current observations from IPMA stations, get the UV index forecast, or list all available locations. The tools are designed to translate your natural language requests into the underlying data queries and present clear, concise results.

How to install

Prerequisites: Node.js and npm must be installed on your machine. You will also use npm to install project dependencies, build the TypeScript source, and run the server locally.

1. Create the project directory and install dependencies.

# Create project directory
mkdir ipma-mcp-server
cd ipma-mcp-server

# Install dependencies
npm install

2. Build the project.

npm run build

3. Configure Claude Desktop to run the local server. You will point Claude Desktop to the compiled entry file and ensure the server starts when Claude initializes.

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
%APPDATA%/Claude/claude_desktop_config.json

4. Add the IPMA MCP server to Claude Desktop configuration. The following example runs the local compiled server. Replace the path with your actual build output path.

{
  "mcpServers": {
    "ipma-weather": {
      "command": "node",
      "args": ["/caminho/completo/para/ipma-mcp-server/build/index.js"],
      "env": {}
    }
  }
}

5. Restart Claude Desktop after saving the configuration so the MCP server is loaded and ready to answer queries.

Additional notes

This server uses the public IPMA API to fetch data. Data are updated by IPMA twice daily at 00:00 UTC and 12:00 UTC. All times are in UTC. If you plan to use this server for commercial purposes, contact IPMA at webmaster@ipma.pt.

Development and structure

Project structure includes the source entry at src/index.ts, a compiled build directory, and npm scripts to build and run. You can extend functionality by adding new tool handlers, implementing the corresponding logic, and then rebuilding.

Security and licensing

The IPMA MCP Server relies on IPMA's free API. Use the service responsibly and respect rate limits. This project is released under the MIT License.

Available tools

get_weather_forecast

Fetches weather forecasts for a specified city and an optional number of days. Parameters include city (required) and days (optional, default 5, max 10).

get_weather_warnings

Retrieves active weather warnings for Portugal.

get_seismic_data

Provides recent seismic data with an optional area parameter (continent, azores, madeira, or all).

get_locations

Lists all cities or locations available for forecast queries.

get_weather_stations

Returns current observations from IPMA weather stations.

get_uv_forecast

Gets the UV index forecast for a given day.