MCP Weather Alert Agent
Enables environment variable management for storing and accessing API keys securely
Used for MCP Protocol specification and repository hosting, allowing users to contribute to the project through pull requests
Provides the agent framework for the weather alert system, enabling interactive conversation with memory and structured function calling
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Weather Alert Agentshow me current weather alerts for Florida"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
๐ฆ๏ธ MCP Weather Alert Agent
A lightweight AI agent powered by MCP (Modular Connector Protocol) that fetches real-time weather alerts for any U.S. state using the National Weather Service API.
โจ Features
๐ค AI Chat Interface - Interactive conversation with memory
๐ช๏ธ Real-time Weather Alerts - Live data from National Weather Service
โก Fast Inference - Powered by Groq LLM via LangChain
๐ง MCP Integration - Built with
mcp,mcp-use, andFastMCP๐ ๏ธ Tool-based Architecture - Structured function calling
Related MCP server: Weather Alerts MCP Server
๐ฏ Quick Example
๐ฌ User: "Provide me weather alerts for California"
๐ค Agent: Calling get_alerts("CA")...
๐ฆ๏ธ Result: "FLOOD WARNING for Central Valley until 6 PM PST..."๐ Getting Started
Prerequisites
Python 3.8+
Groq API key (Get one here)
Installation
Clone the repository
git clone https://github.com/MokshadaRaibagkar/mcp-weather-alert-agent.git cd mcp-weather-alert-agentCreate virtual environment
python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activateInstall dependencies
pip install -r requirements.txtSet up environment variables
cp .env # Edit .env and add your GROQ_API_KEY
๐ ๏ธ Usage
Option 1: Interactive Chat Agent
uv run server/client.pyOption 2: MCP Dev Server (for testing)
uv run mcp dev server/weather.pyOpens MCP Inspector for tool testing and debugging.
Option 3: MCP Inspector (Visual Interface)
uv run mcp dev server/weather.py๐ง API Reference
get_alerts(state: str) -> str
Fetches active weather alerts for a U.S. state.
Parameters:
state(str): Two-letter state code (e.g., "CA", "TX", "NY")
Returns:
Formatted string with current weather alerts or "No active alerts"
Example:
result = get_alerts("FL")
# Returns: "HURRICANE WARNING for Miami-Dade County..."๐งช Example Interactions
Weather Alert Agent initialized! Ask me about weather alerts.
๐ฌ You: What are the current weather alerts for Texas?
๐ ๏ธ Calling get_alerts with state: TX
๐ฆ๏ธ Current alerts for Texas:
- TORNADO WATCH for East Texas until 10 PM CDT
- FLASH FLOOD WARNING for Austin area until midnight
๐ฌ You: Any alerts in California?
๐ ๏ธ Calling get_alerts with state: CA
โ
No active weather alerts for California at this time.๐ Tech Stack
Component | Technology |
MCP Framework | |
LLM | |
Agent Framework | |
Weather API | |
Development |
๐ค Contributing
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
๐ฉโ๐ป Author
Mokshada Raibagkar
โญ Star this repo if it helped you!
Made with โค๏ธ and โ
This server cannot be deployed
Maintenance
Related MCP Connectors
US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.
US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.
US weather alerts (NWS): warnings, watches. $0.01/query. Register in-session โ free testnet funds.
Get US weather forecasts, active alerts, and current observations.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables users to fetch real-time weather alerts from the National Weather Service API for any US state. Provides formatted weather warnings, watches, and advisories with severity levels and safety instructions.1MIT
- FlicenseAqualityDmaintenanceProvides real-time weather alerts for US states using the National Weather Service API, enabling users to fetch and view active weather warnings through natural language queries.11-
- FlicenseBqualityDmaintenanceProvides real-time US weather alerts and forecasts by integrating with the National Weather Service API. It enables AI assistants to fetch state-specific alerts and detailed local forecasts using geographic coordinates.21-
- AlicenseNot gradedqualityCmaintenanceProvides real-time weather, 5-day forecasts, and weather alerts for US states via NWS and WeatherAPI.com, accessible through natural language queries.13 npmMIT