# Weather

> Weather is a freemium MCP server for maps and travel. US National Weather Service alerts and five-period forecasts as two read-only tools. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, self-hosted
- **Website:** https://agent-evidence.thx93.dev
- **Repository:** https://github.com/thx93/mcp-weather-server
- **MCP Registry name:** io.github.Thx93/weather
- **Categories:** maps and travel
- **Listing updated:** 2026-11-15

## About

This is a deliberately small weather server for the United States. It wraps the National Weather Service API, which is free, keyless and US-only, and exposes two tools: active alerts for a two-letter state code, and the next five forecast periods for a latitude and longitude. Both are annotated read-only and open-world, so hosts that honour annotations can call them without prompting.

There are two ways to use it. Run it yourself from npm as @thx93/mcp-weather-server over stdio, which needs Node.js 24 or newer and costs nothing. Or use the hosted route, which is paid per call in USDC on Base over x402; discovery and a health tool are free and a tool call returns a 402 with the price.

The README says its tests stub the NWS API and cover null fields and validation, and that a hosted get-alerts result matched the NWS on 2026-10-19.

## Features

- **State alerts:** get-alerts returns active weather alerts for a two-letter state code.
- **Point forecast:** get-forecast returns the next five forecast periods for a coordinate.
- **Annotated read-only:** Tools carry read-only and open-world hints.
- **Local or hosted:** Run via npm over stdio, or call the paid hosted route.
- **Null-safe output:** Fields the NWS sends as null have defined fallbacks.
- **Free hosted discovery:** tools/list and a health tool on the hosted route need no payment.

## Good for

- Show active alerts for a US state in an assistant
- Pull a short forecast for coordinates
- Give an agent weather without issuing it an API key
- Add a minimal weather tool to a local MCP client

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http weather https://agent-evidence.thx93.dev/weather/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://agent-evidence.thx93.dev/weather/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "weather": {
      "url": "https://agent-evidence.thx93.dev/weather/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "weather": {
      "type": "http",
      "url": "https://agent-evidence.thx93.dev/weather/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "weather": {
      "serverUrl": "https://agent-evidence.thx93.dev/weather/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "weather": {
      "type": "http",
      "url": "https://agent-evidence.thx93.dev/weather/mcp"
    }
  }
}
```

## Tools

- `get-alerts`: Active weather alerts for a two-letter state code.
- `get-forecast`: The next five forecast periods for a latitude and longitude.

## FAQ

### Does it cover outside the US?

No, the NWS data is US-only.

### What does the hosted version cost?

Paid per call in USDC on Base over x402; the registry entry lists $0.01 per call.

### Is it free to self-host?

Yes. Running the npm package locally costs nothing and needs no credentials.

### What does it need to run?

Node.js 24 or newer.

### Is Weather free?

Weather has a free plan, with paid plans for more usage or features.

### How do I add Weather to Claude Code?

Run this command in your terminal: claude mcp add --transport http weather https://agent-evidence.thx93.dev/weather/mcp

### What are the best alternatives to Weather?

The closest alternatives to Weather are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/weather-17
