Weather MCP server for Claude

A minimal remote MCP server using the official TypeScript/JavaScript MCP SDK and Open-Meteo (no API key required). It exposes:

• get_weather: current conditions and a 1–7 day forecast by place name

• POST /mcp: the Streamable HTTP MCP endpoint

• GET /health: a Render health check

Run locally

Requires Node.js 20 or newer.

corepack enable
pnpm install
pnpm start

The MCP endpoint is http://localhost:3000/mcp.

Related MCP server: weather-mcp

Deploy on Render

1. Put this directory in a GitHub or GitLab repository.

2. In Render, choose New > Blueprint and connect the repository.

3. Render reads render.yaml and creates the web service.

4. When deployment finishes, use https://YOUR-SERVICE.onrender.com/mcp as the MCP URL.

No weather API key is needed. The free Render plan may sleep when idle, so the first request after inactivity can take longer.

Connect Claude

For Claude clients that support remote custom connectors, add a custom connector whose URL is:

https://YOUR-SERVICE.onrender.com/mcp

Auth0 OAuth

The server can operate as an OAuth-protected MCP resource server. Create an Auth0 API with identifier https://weather-mcp-render-ss69.onrender.com/mcp, add the weather:read permission, and configure these environment variables:

AUTH_REQUIRED=true
PUBLIC_BASE_URL=https://weather-mcp-render-ss69.onrender.com
AUTH0_ISSUER_BASE_URL=https://YOUR_AUTH0_DOMAIN/
AUTH0_AUDIENCE=https://weather-mcp-render-ss69.onrender.com/mcp
AUTH0_REQUIRED_SCOPE=weather:read

When enabled, /mcp requires an Auth0 RS256 access token containing the weather:read scope. The health route stays public. OAuth protected-resource metadata is published at /.well-known/oauth-protected-resource/mcp.

SupportBridge

Set SUPPORTBRIDGE_API_KEY to enable the SupportBridge tools, MCP App resources, policy synchronization, and get_weather telemetry. The hosted control plane is configured with SUPPORTBRIDGE_URL=https://app2.getwith.in, and the source name defaults to weather-mcp. The SDK remains disabled when no API key is configured.

Example prompt

Use get_weather to tell me the three-day forecast for Richmond, Virginia in imperial units.

Data source

Weather and geocoding data are supplied by Open-Meteo. Review its attribution and commercial-use terms before using this server in a production product.