WeatherXM PRO MCP server

The WeatherXM PRO MCP Server enables access to weather station data, observations, and forecasts through the Model Context Protocol. It provides a bridge between WeatherXM PRO APIs and MCP clients, allowing you to retrieve detailed weather information programmatically.

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

Installation

Clone the repository to your local machine and install dependencies:

git clone https://github.com/WeatherXM/weatherxm-pro-mcp.git
cd weatherxm-pro-mcp
npm install
npm run build

MCP Client Configuration

To use the WeatherXM PRO MCP server with your MCP clients, add the following configuration:

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

Be sure to 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.

Client-Specific Setup

Claude Desktop

1. Edit the MCP settings file 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
4. You can now run queries on the WeatherXM PRO MCP server

Cursor

1. Install Cursor
2. Go to Cursor > Cursor Settings > MCP > Add a new global MCP server
3. Input the configuration as shown above
4. Save the configuration
5. The weatherxm-pro server will appear in your MCP servers list

Windsurf Editor

1. Install Windsurf Editor
2. Navigate to Command Palette > Windsurf MCP Configuration Panel or Windsurf - Settings > Advanced > Cascade > Model Context Protocol (MCP) Servers
3. Click "Add Server" then "Add custom server"
4. Add the WeatherXM PRO MCP Server configuration
5. Save the configuration
6. The weatherxm-pro server will now be available in the MCP Servers list

Docker Deployment

You can also run the MCP server as a Docker container:

Build the image

docker build -t weatherxm-pro-mcp .

Run the container

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

• Verify the path to your MCP server is correct in your configuration
• Check that your WeatherXM PRO API key is valid and correctly set
• Ensure your MCP client configuration matches the required server settings
• Review logs for any error messages if you encounter issues

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

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

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

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

3. Restart Claude Desktop for the changes to take effect