WeatherXM PRO

You can access WeatherXM PRO data through MCP by running a lightweight server that exposes WeatherXM PRO APIs as MCP tools. This lets you locate stations, retrieve observations, and request forecasts using simple MCP queries across your preferred clients.

How to use

With WeatherXM PRO MCP Server, you can perform practical data queries directly from your MCP-enabled client. Look up nearby stations by location, fetch the latest observations for a station, pull historical observations for a specific date, and request daily or hourly forecasts for a region. You can also search for H3 cells by region name, get stations in a given H3 cell, and retrieve hyperlocal forecasts or forecast performance rankings for selected stations and variables. Use the configured MCP server like any other MCP endpoint, and chain multiple tools to build weather-aware workflows.

How to install

Prerequisites you need before starting:

1. Install Node.js and npm on your machine.

2. Ensure you have a valid WeatherXM PRO API key.

3. Clone the WeatherXM PRO MCP Server setup (from your preferred location in your environment). You will run the MCP server locally to expose the WeatherXM PRO APIs via MCP.

4. Install dependencies and build the project.

npm install
npm run build

Additional sections

Configuration and usage details are provided below to help you set up and start querying WeatherXM PRO data through MCP.

Configuration details and runtime commands

The MCP server is configured to run locally using a runtime command with your API key. The following configuration shows how to expose the MCP server via a standard MCP client stack. Replace path placeholders and the API key with your actual values.

{
  "mcpServers": {
    "weatherxm_pro": {
      "type": "stdio",
      "name": "weatherxm_pro",
      "command": "npx",
      "args": ["-y", "path to mcp"],
      "env": {
        "WEATHERXMPRO_API_KEY": "your-api-key"
      }
    }
  }
}

Security and maintenance notes

Keep your API key secure. Do not share your API key in public or insecure channels. If you rotate keys, update the MCP server environment configuration accordingly and restart your MCP client applications to apply changes.

Troubleshooting

If you encounter issues, verify the following:

• The path to the MCP server configuration is correct in your client.
• The WeatherXM PRO API key is set correctly in the MCP server environment.
• The MCP client configuration matches the server settings.
• Check logs for errors or warnings that indicate problems with the MCP server.

Available tools

getStationsNear

Find stations near a specific latitude/longitude within a given radius.

getStationsInBoundingBox

Retrieve stations contained within a defined geographic bounding box (min/max latitude and longitude).

getAllStations

Return the complete list of available WeatherXM PRO stations.

getLatestObservation

Get the most recent observation for a specific station.

getHistoricalObservations

Fetch observations for a station on a specific date.

searchH3Cells

Search for H3 cells by region name to locate weather data at higher spatial resolution.

getStationsInH3Cell

Get stations that belong to a specific H3 cell.

getForecastForH3Cell

Retrieve daily or hourly forecasts for a specific H3 cell.

getHyperlocalForecast

Obtain a hyperlocal forecast for a station and a given variable.

getForecastPerformance

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

getForecastRanking

Get forecast ranking (FACT) for a station.