home / mcp / aare.guru mcp server

Aare.guru MCP Server

Provides access to Aare.guru data and tools for current, historical, and summarized river conditions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "baking-bread-aareguru-mcp": {
      "command": "npx",
      "args": [
        "aareguru-mcp"
      ]
    }
  }
}

This MCP server provides access to the Aare.guru API, letting you retrieve water temperature, river conditions, forecasts, and historical data for monitoring locations along the Aare river in Switzerland. It enables practical queries for swimmers, researchers, and river enthusiasts by exposing focused tools that return current conditions, summaries, and historical trends.

How to use

You connect a client to the MCP server and request data through the available tools. Use clear, location-focused queries to get current conditions, city lists, summaries, or historical data. The server supports querying all locations at once or targeting a single city such as Bern or Thun. Typical uses include checking current water temperature before a swim, comparing conditions across multiple locations, or reviewing historical trends for a chosen period.

How to install

Prerequisites: You need Node.js 18 or newer installed on your system.

Using npx (recommended) you can start the MCP server without a local install.

npx aareguru-mcp

Global installation lets you run the MCP server from anywhere on your system.

npm install -g aareguru-mcp
 aareguru-mcp

For local development and testing, clone the project, install dependencies, and start the server locally.

git clone <repository-url>
cd aareguru-mcp
npm install
npm start

Additional notes

Configure your MCP client to connect to the Aare.guru MCP server by using one of the provided commands or the server's executable name, depending on how you installed it. If you prefer to run via npx, the client can invoke the server with a short command. If you installed globally, you can invoke the server directly by name.

Typical integration steps with an MCP client include adding a server entry that points to the local process or to the command you use to start it. Then you can query for lists of locations, current conditions for a city, a minimal today summary, widget data for all locations, or historical data for a time range.

Available tools

get_cities

Returns a list of all available monitoring locations along the Aare river.

get_current_conditions

Provides current conditions for a specific location, including temperature, flow, forecasts, and related data.

get_today_summary

Offers a minimal current temperature and swimming recommendation for a chosen city.

get_widget_data

Fetches current data for all locations in a single request.

get_historical_data

Returns historical time series data for water temperature, river flow, and air temperature for a city and time range.