Weather MCP Server
A FastMCP server that provides weather data, forecasts, and alerts for Poke integration.
🚀 Features
- get_current_weather: Current conditions (from National Weather Service forecast data)
- get_forecast: Detailed multi-day forecast (day/night periods)
- get_weather_alerts: Real-time alerts and warnings (NWS official alerts)
Data Source: National Weather Service (https://api.weather.gov) — no API key required.
🛠️ Local Development
# Install dependencies
pip install -r requirements.txt
# Run the server
python src/server.py
🔑 API Key Setup
Not required. This server uses the National Weather Service API and does not need an API key.
🚢 Deployment
Deploy to Render
Steps:
- Click the "Deploy to Render" button above or go to render.com
- Connect your GitHub account to Render (if you haven't already)
- Create a new Web Service:
- Connect this repository
- Name:
weather-mcp - Environment:
Python 3 - Plan:
Free - Build Command:
pip install -r requirements.txt - Start Command:
python src/server.py
- No environment variables required
- Deploy!
Note: On Render's free tier, services go idle after ~15 minutes of inactivity and may require a manual "Deploy" to wake or to pick up the latest commit. Unlike Vercel, pushes do not auto-deploy by default.
Your server will be available at https://weather-mcp.onrender.com/mcp
🎯 Poke Integration
- Go to poke.com/settings/connections
- Add the MCP URL:
https://weather-mcp.onrender.com/mcp - Give it a name like "Weather"
- Try: "Use the Weather MCP to get the 3-day forecast for Boston."
References
- Based on the Interaction MCP server template: MCP Server Template
- Discovered via Interaction’s HackMIT challenge: Interaction HackMIT Challenge
- National Weather Service API docs:
https://www.weather.gov/documentation/services-web-api
🔧 Available Tools
get_current_weather(location, units="metric|imperial"): Current conditions based on NWS forecast periodsget_forecast(location, days=1..5, units="metric|imperial"): Multi-day forecast (day/night periods)get_weather_alerts(location): Official alerts/watches/warnings for the specified location
📝 Example Usage
# Get current weather (uses NWS forecast period closest to now)
get_current_weather(location="Seattle", units="metric")
# Get 3-day forecast (day/night periods)
get_forecast(location="New York", days=3, units="imperial")
# Get weather alerts
get_weather_alerts(location="Miami")
Notes:
- Locations are resolved via a simple built-in mapping of major US cities. For other places, default coordinates are used. You can extend this with a geocoding service if needed.
- Current conditions are derived from the first forecast period when station observations are unavailable.