Weather Mcp Server

io.github.jaredco-aiPublished by GitHub account jaredco-aiv1.0.1Updated Oct 24, 2026

Fast - accurate weather conditions and forecasts by city or coordinates.

VerifiedSTDIODesktop onlyLocation & Lifestyle

Overview

AI-generated overview

A weather MCP server that lets an assistant fetch current conditions and multi-day forecasts for cities, ZIP codes or coordinates worldwide.

What you can do
Retrieve current weather for a location, including temperature, condition, wind and humidity, by city name, ZIP code or coordinates. Get multi-day forecasts of up to 14 days for a location. Produce a 7-day planning forecast tailored to construction, travel or event contexts. Responses are compact and token-efficient for LLM use.
When to use it
Useful when you want an assistant to answer everyday weather questions or help plan outdoor work, travel or events around a forecast. It is a lightweight addition with no account or key needed on the client side.
Requirements
Runs as a local npm package over stdio, so Node.js is needed; the README also documents a hosted remote endpoint. No client-side API keys or environment variables are declared. The server itself needs a World Weather Online API key in WEATHER_API_KEY when self-hosted, plus network access.
Before you install
Self-hosting requires a World Weather Online API key in WEATHER_API_KEY, which the README says to keep server-side and never commit. The README notes an operational metrics endpoint that should not be exposed publicly without access control. Locations are sent to the weather provider; the README states locations and raw provider responses are not logged.

Installation

In SourceWeft

  1. Open Weather Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

🌦 WeatherTrax MCP Server

Fast, reliable weather data for Claude and other MCP clients.
Get current conditions and multi-day forecasts for any location worldwide.

🌐 Remote MCP Server (no install required)
https://mcp-weathertrax.jaredco.com/mcp

[License: MIT] [MCP Protocol] [MCP Registry]

⚡ 10-Second Demo

Ask Claude:

“What’s the weather in Miami tomorrow?”

Claude will call the MCP weather server and return a forecast instantly.

Example API call:

bash
curl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \  -H "Content-Type: application/json" \  -d '{"location":"Miami","query_type":"current"}'

🚀 Features

  • Real-time Weather Data – Current conditions, temperature, humidity, wind speed
  • Multi-day Forecasts – Up to 14-day forecasts
  • Planning Tool – 7-day forecasts optimized for events or construction
  • Flexible Locations – City names, ZIP codes, or coordinates
  • Token-Efficient – Compact responses optimized for LLM usage
  • Production-Ready – Rate limiting and monitoring
  • Public API – No API keys required
  • MCP Compliant – Full JSON-RPC 2.0 support

⚡ Quick Start

Claude

In Claude or Claude Desktop, open Settings → Connectors → Add connector and use:

Name: WeatherTraxURL:  https://mcp-weathertrax.jaredco.com/mcp

You can now ask:

What’s the weather in New York this weekend?

🌐 Direct API Usage

Health Check

bash
curl https://mcp-weathertrax.jaredco.com/healthz

MCP Manifest

bash
curl https://mcp-weathertrax.jaredco.com/.well-known/mcp/manifest

💡 Usage Examples

Current Weather

bash
curl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \  -H "Content-Type: application/json" \  -d '{    "location": "San Francisco, CA",    "query_type": "current"  }'

Example response:

json
{  "summary": "It is currently 54°F and Clear in San Francisco.",  "temp_high": 54,  "temp_low": 54,  "condition": "Clear",  "wind": "5 mph W",  "humidity": 65}

Multi-Day Forecast

bash
curl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \  -H "Content-Type: application/json" \  -d '{    "location": "New York",    "query_type": "multi_day",    "num_days": 3  }'

🛠 Available Tools

weatherTool

Retrieve current weather or forecasts.

Input:

json
{  "location": "city name or coordinates",  "query_type": "current | multi_day",  "num_days": "optional forecast length"}

weatherPlanningTool

7-day planning forecast for outdoor work or events.

Input:

json
{  "location": "city or place",  "context": "construction | travel | event",  "timeframe": "optional timeframe hint"}

🔗 MCP Protocol Integration

This server supports the full MCP JSON-RPC protocol.

Example tool call:

bash
curl -X POST https://mcp-weathertrax.jaredco.com/mcp \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -d '{    "jsonrpc":"2.0",    "id":1,    "method":"tools/call",    "params":{      "name":"weatherTool",      "arguments":{        "location":"London",        "query_type":"current"      }    }  }'

🧪 Testing

Run locally in one terminal:

bash
npm installnpm start

In another terminal, run the protocol tests:

bash
npm test

Release smoke suite:

bash
npm run test:full

npm run test:full currently runs the same supported end-to-end smoke suite. The old pre-Streamable-HTTP regression harness remains available as npm run test:legacy; it is retained for reference and is not a release gate.

Deployment configuration

Set these server-side environment variables; never commit them:

VariableRequiredPurpose
WEATHER_API_KEYYesWorld Weather Online API key.
PORTNoHTTP listener port; defaults to 3000.
TRUST_PROXYProduction-dependentNumber of trusted reverse-proxy hops; set to 1 for a single known proxy.
ALLOWED_ORIGINSNoComma-separated browser origins allowed to call MCP; defaults to https://claude.ai.

The service exposes aggregate, non-identifying operational counters at /metrics. Do not place this endpoint behind a public dashboard without adding appropriate access control.

🔒 Privacy

Privacy policy available at:

https://mcp-weathertrax.jaredco.com/privacy

Key points:

  • Aggregate operational metrics only; locations and raw provider responses are not logged
  • Short-lived in-memory caching reduces duplicate provider requests
  • No cookies or tracking
  • HTTPS enforced

🛠 Development

Clone the repo:

bash
git clone https://github.com/jaredco/weather-mcp-server.gitcd weather-mcp-servernpm installnpm start

Server runs locally at:

http://localhost:3000

📦 Technology Stack

  • Node.js
  • Express 5
  • @modelcontextprotocol/sdk
  • World Weather Online API
  • Railway hosting

📄 License

MIT License.

🌟 Acknowledgments

Built using the Model Context Protocol by Anthropic.

Weather data provided by World Weather Online.

📊 Status

Server: Production
API Version: 1.0.1
MCP Protocol: 2025-03-26

Made with ☀️ for Claude and MCP

Source: README.md at commit 859a57c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts