weatherxm-pro

WeatherXM PRO MCP server exposes WeatherXM PRO APIs as MCP tools, enabling clients to access weather station data, observations, and forecasts through the MCP protocol. The server supports a range of tools such as retrieving stations near a location, stations within a bounding box, all available stations, latest observations for a station, historical observations for a specific date, and weather forecasts (daily or hourly) for a given H3 cell. It also provides capabilities to search H3 cells by region name, get stations in a specific H3 cell, retrieve hyperlocal forecasts for a station-variable pair, and access forecast performance (FACT) and ranking information. To use the server, configure the MCP client with the provided mcpServers entry and supply your WeatherXM PRO API key via the WEATHERXMPRO_API_KEY environment variable; the client will route commands to WeatherXM PRO through the MCP server. Once configured, you can run queries such as locating nearby stations, fetching latest or historical observations, and obtaining forecast data for specific regions or stations directly from your MCP client.

The MCP server acts as a bridge between MCP clients and WeatherXM PRO APIs, translating MCP tool invocations into API requests and returning structured responses suitable for further MCP tool chaining or integration with editors and clients that support MCP tooling.

Prerequisites:

• Node.js and npm installed
• Access to WeatherXM PRO API key
• Git (optional, for cloning)

Installation steps:

1. Clone the repository (optional if you already have the project): git clone https://github.com/WeatherXM/weatherxm-pro-mcp.git cd weatherxm-pro-mcp

2. Install dependencies: npm install

3. Build the project (if required by the project): npm run build

4. Set up configuration for MCP clients:

   • Use the provided mcp_config example as a starting point.
   • Replace "path to mcp" with the actual path or package name of the MCP server, and set your API key in WEATHERXMPRO_API_KEY.

5. Run the MCP server (example using npx as shown in the config): npx -y path to mcp

6. Verify the server is reachable through your MCP client and that the API key has the necessary permissions.

Tips and considerations:

• Ensure WEATHERXMPRO_API_KEY is valid and has permissions for the required WeatherXM PRO endpoints.
• If you deploy via Docker, follow the Docker image build/run steps and pass the API key as an environment variable.
• When configuring MCP clients, ensure the path or package name in the mcpServers configuration correctly points to the WeatherXM PRO MCP server package.
• If you encounter authentication or rate-limiting errors, check the API key scope and your WeatherXM PRO plan.
• Monitor logs for any errors related to API requests or MCP tool translations to diagnose issues quickly.