playbooks

home / mcp / mcp server ipma

MCP Server IPMA

Provides weather forecasts, warnings, seismic data, IPMA observations, UV index, and location listing via natural language.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "brandao-20-mcp_server_ipma": {
      "command": "node",
      "args": [
        "C:\\\\Users\\\\nome_user\\\\mcp_server_ipma\\\\src\\\\index.js"
      ]
    }
  }
}

You can access IPMA meteorological data through natural language by using this MCP server. It provides weather forecasts for Portuguese cities, real-time weather warnings, seismic data, real-time IPMA observations, UV index forecasts, and a list of available locations, all accessible via an MCP client.

How to use

You interact with the MCP server through your MCP client by asking questions or issuing requests that map to the available tools. You can ask for the weather forecast for a city, check current weather warnings, view recent seismic activity, look up UV index forecasts, or list all supported locations. The server translates your natural language queries into actions that fetch data from IPMA and returns you clear, actionable results.

How to install

Prerequisites you need on your machine are Node.js (and npm) to run the MCP server locally.

Optionally install automatically via Smithery to set up Claude Desktop integration.

# Install the MCP server automatically for Claude Desktop
npx -y @smithery/cli@latest install @brandao-20/mcp_server_ipma --client claude

Clone the project repository and install dependencies.

git clone https://github.com/brandao-20/mcp_server_ipma.git
cd mcp_server_ipma

# Install dependencies
npm install

Run the server locally.

npm start

Configure Claude Desktop to use the MCP server. Create or edit the Claude Desktop configuration file on your system and add the server entry.

{
  "mcpServers": {
    "mcp_server_ipma": {
      "command": "node",
      "args": ["C:\\Users\\nome_user\\mcp_server_ipma\\src\\index.js"],
      "env": {}
    }
  }
}

After saving the configuration, restart Claude Desktop to apply changes.

Additional notes

The server uses the public IPMA API endpoints to provide data for weather forecasts, warnings, seismic activity, station observations, UV index, and the list of available locations.

If you need to customize environment variables for your local setup, you can add them to the server startup configuration and to the Claude Desktop entry as shown above.

Examples of usage

Ask for the weather forecast for Viana do Castelo this week, check for any heavy rain warnings for today, or query the UV index forecast for Braga.

Available tools

get_locations

List all available cities for which you can request a weather forecast.

get_weather_forecast

Get a weather forecast for a specific city. Requires city and may take an optional days parameter to specify the forecast horizon.

get_weather_warnings

Retrieve active weather warnings for Portugal.

get_uv_forecast

Obtain the UV index forecast for a given time period.

get_seismic_data

Fetch recent seismic activity information, with an optional area filter.