get_weather_forecastLABSCO SUMMARY
One official source, six kinds of question.
The value here is provenance: warnings, UV and seismic readings all come from the institute that issues them, not from a reseller's aggregation. Start with the locations list — forecasts are keyed to IPMA's own place names, and asking for a town that is not on that list is the one way this comes back empty.
What it is
A server over the open data published by IPMA, Portugal's meteorological and seismic institute. It covers forecasts, active warnings, station observations, UV index and seismic activity for the mainland and the islands.
What you get
get_weather_forecast— the forecast for a named Portuguese city, up to 10 days, with 5 as the defaultget_weather_warnings— the meteorological warnings currently activeget_seismic_data— recent seismic activity, filtered bycontinent,azores,madeiraorallget_weather_stations— real-time observations from IPMA's station networkget_uv_forecast— the forecast ultraviolet indexget_locations— every place you can ask for a forecast for
Requirements
The package ipma-mcp-server, version 1.0.0. Build it with npm install and npm run build, then point the client at build/index.js with node; there is also an automated Smithery install. No account, no API key — IPMA's data is open.
Setup effort
One command — npx -y @smithery/cli install @DiogoAzevedo03/ipma-mcp-server --client claude
USE CASES
01
Checking whether it is safe to be outside
Read the active warnings and the UV forecast together before planning a day.
02
Planning a week somewhere in Portugal
Ask for a multi-day forecast by city, up to ten days out.
03
Following recent seismic activity
Filter to the mainland, the Azores or Madeira and see what has been recorded.
04
Getting conditions right now rather than a forecast
Read current observations from the station network.
6 tools
Listed in project docs. Your client may show a different list.
get_weather_warningsget_seismic_dataget_locationsget_weather_stationsget_uv_forecastBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
node on PATH
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
Setup
Clone the repository: git clone https://github.com/DiogoAzevedo03/ipma-mcp-server.git then cd ipma-mcp-server
Install dependencies:
TERMINAL
npm installCompile the TypeScript: npm run build — this creates build/index.js
Add the configuration below to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%/Claude/claude_desktop_config.json), with the full path to your build/index.js
Restart Claude Desktop
npx
TERMINAL
npx -y @smithery/cli install @DiogoAzevedo03/ipma-mcp-server --client claudeMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"ipma-weather": {
"command": "node",
"args": [
"<YOUR_PATH_TO_IPMA_MCP_SERVER>/build/index.js"
],
"env": {}
}
}
}<YOUR_PATH_TO_IPMA_MCP_SERVER> is the folder you cloned and built.
