WeatherXM

You run an MCP server that gives you real-time weather data, forecasts, historical records, alerts, and station discovery from the WeatherXM decentralized network. It lets your MCP client fetch current conditions, hourly and daily forecasts, historical trends, and data quality assessments from WeatherXM stations around the world.

How to use

After you start the WeatherXM MCP Server, you can query WeatherXM data through your MCP client. Ask for the latest observation from a specific station, request hourly or daily forecasts, pull historical weather data for analysis, and retrieve active weather alerts for a location. You can also discover nearby stations, search for stations by name or location, and inspect weather cell coverage and data quality for stations.

How to install

Prerequisites: You need Node.js 18 or higher and a WeatherXM Pro API key. Obtain the key from pro.weatherxm.com and keep it secure in your environment.

Step 1: Install dependencies and prepare the environment.

Step 2: Run the server in development or production mode using the recommended options below.

Additional sections

Configuration and API key management:

• The server requires a WeatherXM Pro API key for all requests. Set WEATHERXM_API_KEY in your environment to authenticate requests from your MCP client.

Development and local runner options:
- You can run the server via a published npm package, or run a local development version with hot reloading. Use the commands shown below to start the server in development or to build for production.

Troubleshooting:

• Common issues include missing or invalid API keys, network problems, and API rate limits. Validate your API key, ensure it’s exported in your shell, and retry after a short delay if you hit rate limits.

End-to-end usage patterns you can perform with your MCP client include:

• Get current weather for a station
• Get hourly and daily forecasts for a station
• Retrieve historical weather data for a station
• Get active weather alerts for a location
• Find and search for nearby stations
• Retrieve weather cells and assess station health
• Check the local time at a station’s location

Development and local runner

Development mode (Smithery preferred):
- npm run dev
- npm run build  to create production artifacts

Local runner (for testing without Smithery):
- Set your API key: export WEATHERXM_API_KEY=YOUR_API_KEY
- Run the local runner: npm run runner
- Or run directly with tsx: tsx src/runner.ts

Common script references you may use while developing:
- npm run dev - Start Smithery development server
- npm run build - Build with Smithery
- npm run dev:tsc - Start development with TypeScript compiler
- npm run runner - Run local server for testing

Available tools

get_current_weather

Retrieves the latest weather observation from a specific WeatherXM station, returning temperature, humidity, wind, pressure, UV index, solar irradiance, precipitation, and data quality.

get_hourly_forecast

Fetches detailed hourly weather forecasts for a given station, including temperature, precipitation probability, wind, humidity, and UV index for the requested hours.

get_daily_forecast

Fetches daily weather forecasts for a given station, including high/low temperatures, precipitation probability and type, wind, humidity, and UV index for the requested days.

get_historical_weather

Retrieves historical weather data for a station over a specified date range, including temperatures, precipitation, wind, pressure, and summary statistics.

get_weather_alerts

Retrieves active weather alerts and warnings for a location, including severity, type, effective times, and affected areas.

find_weather_stations

Discovers WeatherXM stations near a location within a specified radius, returning station details and locations.

search_weather_stations

Searches for WeatherXM stations by name or location description, with pagination support.

get_weather_cells

Gets weather cells near a location, providing cell center coordinates, station counts, and network coverage.

get_station_health

Assesses data quality and reliability for a specific WeatherXM station, returning quality scores and health assessment.

get_station_local_time

Returns the current local time at a station’s location.