WeatherXM PRO MCP Server
About
This MCP server exposes the WeatherXM PRO APIs as MCP tools, allowing clients to access weather station data, observations, and forecasts through the MCP protocol.
Details
- Author
- WeatherXM
- GitHub stars
- 7
- Downloads
- 284
- Categories
- Other
Jump to
- Retrieve weather stations by location, bounding box, or all available
- Get latest or historical observations for a specific station
- Search for H3 cells by region name and find stations within them
- Fetch daily or hourly forecasts for a specific H3 cell
- Access hyperlocal forecasts and forecast performance (FACT) data
- Rank stations by forecast accuracy with FACT data
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
WeatherXM PRO MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies with npm install, then build with npm run build. Configure the server in your MCP client using the provided JSON configuration, specifying WEATHERXMPRO_API_KEY as an environment variable.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"weatherxm pro mcp server": {
"weatherxm-pro": {
"command": "npx",
"args": [
"-y",
"path to mcp"
],
"env": {
"WEATHERXMPRO_API_KEY": "your-api-key"
}
}
}
}
}McpServers
{
"weatherxm-pro": {
"command": "npx",
"args": [
"-y",
"path to mcp"
],
"env": {
"WEATHERXMPRO_API_KEY": "your-api-key"
}
}
}WeatherXM PRO MCP Server
An MCP server implementation exposing the WeatherXM PRO APIs as MCP tools, allowing clients to access weather station data, observations, and forecasts through the MCP protocol.
Features
- Get stations near a location (latitude, longitude, radius)
- Get stations within a bounding box (min/max latitude and longitude)
- Get all available stations
- Get the latest observation for a specific station
- Get historical observations for a station on a specific date
- Search for H3 cells by region name
- Get stations in a specific H3 cell
- Get weather forecast (daily or hourly) for a specific H3 cell
- Get hyperlocal forecast for a station and variable
- Get forecast performance (FACT) for a station and variable
- Get forecast ranking (FACT) for a station
Prerequisites
- Node.js and npm installed
- A valid WeatherXM PRO API key
Configuration
Clone the repository to your local machine.
git clone https://github.com/WeatherXM/weatherxm-pro-mcp.git
Installation
After cloning the repository, you need to install the dependencies and build the project before running the MCP server.
npm install
npm run build
Server Configuration for MCP Clients
This is the common configuration for MCP clients such as Claude Desktop, Cursor, Windsurf Editor, VSCode and plugins such as RooCode and Cline.
{
"mcpServers": {
"weatherxm-pro": {
"command": "npx",
"args": [
"-y",
"path to mcp"
],
"env": {
"WEATHERXMPRO_API_KEY": "your-api-key"
}
}
}
}
Replace "path to mcp" with the actual path to the MCP server or package name, and "your-api-key" with your WeatherXM PRO API key.
> Note: If you have other MCP servers in use in the client, you can add it to the existing mcpServers object.
Claude Desktop
Follow the steps below to use the WeatherXM PRO MCP server with Claude Desktop MCP client:
1. Edit the MCP settings file located at:
~/Library/Application Support/Claude/claude_desktop_config.json
2. Add the WeatherXM PRO MCP server configuration under the mcpServers object.
3. Restart Claude Desktop to apply the changes.
4. You can now use the server in Claude Desktop to run queries on the WeatherXM PRO MCP server.
Cursor
Follow the steps below to use the WeatherXM PRO MCP server with Cursor:
1. Install Cursor on your machine.
2. In Cursor, go to Cursor > Cursor Settings > MCP > Add a new global MCP server.
3. Specify the same configuration as in the Server Configuration for MCP Clients section.
4. Save the configuration.
5. You will see weatherxm-pro as an added server in MCP servers list.
6. You can now use the WeatherXM PRO MCP server in Cursor to run queries.
Windsurf Editor
Follow the steps below to use the WeatherXM PRO MCP server with Windsurf Editor:
1. Install Windsurf Editor on your machine.
2. Navigate to Command Palette > Windsurf MCP Configuration Panel or Windsurf - Settings > Advanced > Cascade > Model Context Protocol (MCP) Servers.
3. Click on Add Server and then Add custom server.
4. Add the WeatherXM PRO MCP Server configuration from the Server Configuration for MCP Clients section.
5. Save the configuration.
6. You will see weatherxm-pro as an added server in MCP Servers list.
7. You can now use the WeatherXM PRO MCP server in Windsurf Editor to run queries.
Docker Image
The MCP server can be built and run as a Docker container.
Build
docker build -t weatherxm-pro-mcp .
Run
docker run -d -p 3000:3000 -e WEATHERXMPRO_API_KEY="your-api-key" -e PORT=3000 weatherxm-pro-mcp
Replace "your-api-key" with your actual WeatherXM PRO API key.
Troubleshooting Tips
- Ensure the path to your MCP server repository is correct in the configuration.
- Verify that your WeatherXM PRO API key is set correctly.
- Check that the MCP client configuration matches the server settings.
- Check the logs for any errors or warnings that may indicate issues with the MCP server.
License
MIT License
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
