WeatherXM PRO

You can access WeatherXM PRO APIs through this MCP server, turning weather station data, observations, and forecasts into MCP-ready tools. This enables you to query stations, observations, and forecasts via your MCP client with real-time API access and flexible search options.

How to use

You use an MCP client to connect to the WeatherXM PRO MCP server and run queries that fetch weather stations, observations, and forecasts. Start by configuring your MCP client with the WeatherXM PRO MCP server settings, then issue commands to retrieve nearby stations, stations within a bounding box, latest observations, historical observations, and forecast data. You can target data by location, region name, and specific H3 cells, or request hyperlocal forecasts for a given station and variable. Use the results to build dashboards, automate alerts, or feed other systems with weather data.

How to install

Prerequisites you need before starting:

Install Node.js and npm on your machine.

Clone the WeatherXM PRO MCP server repository, install dependencies, and build the project.

How to install

git clone https://github.com/WeatherXM/weatherxm-pro-mcp.git

npm install

npm run build

Configuration for MCP clients

Configure your MCP client to connect to the WeatherXM PRO MCP server. The server uses a stdio (local) runtime, started via a command that runs with an API key. Include the WeatherXM PRO API key in the environment to authorize API requests.

Server configuration example

{
  "mcpServers": {
    "weatherxm-pro": {
      "command": "npx",
      "args": [
        "-y",
        "path to mcp"
      ],
      "env": {
        "WEATHERXMPRO_API_KEY": "your-api-key"
      }
    }
  }
}

Environment variables

The API key is required to access WeatherXM PRO data. Provide WEATHERXMPRO_API_KEY in the environment where you run the MCP server.

Docker image

You can run the MCP server in a Docker container. Build and run with the following example commands.

Build a Docker image

docker build -t weatherxm-pro-mcp .

Run the Docker container

docker run -d -p 3000:3000 -e WEATHERXMPRO_API_KEY="your-api-key" -e PORT=3000 weatherxm-pro-mcp

Troubleshooting

Check that the API key is set correctly and that the MCP client configuration matches the server settings. Review logs for any errors or warnings that indicate issues with the MCP server.

Available tools

getStationsNear

Retrieve stations near a given latitude/longitude within a specified radius.

getStationsInBoundingBox

Fetch stations within a defined latitude/longitude bounding box.

getAllStations

Return all available WeatherXM PRO stations.

getLatestObservation

Get the most recent observation for a specific station.

getHistoricalObservations

Obtain historical observations for a station on a specific date.

searchH3ByRegion

Search for H3 cells by region name.

getStationsInH3Cell

List stations contained in a specific H3 cell.

getForecast

Get weather forecast data (daily or hourly) for a specific H3 cell.

getHyperlocalForecast

Fetch hyperlocal forecast for a station and a variable.

getForecastPerformance

Retrieve forecast performance (FACT) metrics for a station and a variable.

getForecastRanking

Get forecast ranking (FACT) for a station.