Skip to main content
Glama
Weather MCP Server

Weather MCP Server

by rsys-vtiwari

Weather MCP Server

An MCP server that provides:

  • Active US National Weather Service (NWS) alerts by two-letter state code

  • Short-term point forecasts (next 5 periods) for latitude/longitude coordinates

Data is sourced from the public NWS API at https://api.weather.gov.

Tools

Tool

Description

Inputs

get_alerts

Fetch active NWS alerts for a US state

state (string, two-letter code)

get_forecast

Fetch short-term forecast (next 5 periods) for coordinates

latitude (number), longitude (number)

Related MCP server: Weather Server

Usage (Local)

Install dependencies:

pip install .

Run the MCP server (stdio transport):

python -m weather.weather

Your MCP client should be configured to launch the server via the package entrypoint or the above module path.

Server JSON Summary

See server.json for registry metadata including name, version, tools, and entrypoint configuration.

Publishing Steps (Overview)

  1. Authenticate with publisher (GitHub namespace):

    mcp-publisher login github
  2. Create and push repo to GitHub (see steps below).

  3. (Optional) Publish to PyPI if distributing as a package.

  4. Publish to MCP registry:

    mcp-publisher publish
  5. Verify:

    curl "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.vtiwari/weather-mcp"

Create & Push GitHub Repository

If this directory is not yet a git repo:

git init
git add .
git commit -m "Initial commit: Weather MCP server"

Create repo (GitHub CLI) and push:

gh repo create vtiwari/weather-mcp --public --source . --remote origin --push

If not using GitHub CLI, create the repo manually via the GitHub web UI, then:

git remote add origin https://github.com/vtiwari/weather-mcp.git
git branch -M main
git push -u origin main

Tag version for release consistency:

git tag v0.1.0
git push origin v0.1.0

PyPI Packaging (Optional)

To distribute via PyPI, ensure pyproject.toml includes build backend and metadata (authors, license). Then:

pip install build twine
python -m build
twine upload dist/*

License

MIT (adjust if different).

Disclaimer

This server uses public NOAA/NWS endpoints. Respect API usage guidelines and rate limits.

Available Tools

2 tools
get_alertsA

Get weather alerts for a US state.

Args: state: Two-letter US state code (e.g. CA, NY)

Inputs: state (required). Returns: result

get_forecastC

Get weather forecast for a location.

Args: latitude: Latitude of the location longitude: Longitude of the location

Inputs: latitude (required), longitude (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: get_alerts retrieves weather alerts for US states, while get_forecast provides weather forecasts for geographic coordinates. There is no overlap in functionality or ambiguity between them.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun naming pattern (get_alerts, get_forecast) with identical verb usage and snake_case formatting. The naming is perfectly predictable across the tool set.

    Tool Count2/5

    With only 2 tools for a weather server, the surface feels thin and incomplete for the domain. A weather service typically requires more operations (e.g., current conditions, historical data, multiple forecast types) to be useful for agents.

    Completeness2/5

    There are significant gaps in coverage for a weather domain. Missing essential operations like current weather conditions, historical data, air quality, or radar information. The two tools alone do not provide a complete weather service surface.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides access to National Weather Service (NWS) data, enabling users to retrieve active weather alerts for US states and weather forecasts for specific geographic coordinates.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Provides weather information and alerts from the National Weather Service, including active weather alerts for US states and location-based forecasts using latitude/longitude coordinates.
      2
      MIT