English Français العربية

World Weather Online

Official registry Maps, travel and weather

Global weather API: forecasts, historical data, marine, ski, astronomy and timezone.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http world-weather-online 'https://mcp.worldweatheronline.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "world-weather-online": {
            "type": "http",
            "url": "https://mcp.worldweatheronline.com/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. World Weather Online — MCP Server (Railway)
  2. Deploy to Railway
  3. Connecting AI Clients
  4. Available Tools
  5. Local Development

World Weather Online — MCP Server (Railway)

MCP server for World Weather Online. Lets AI assistants like Claude, Cursor, and others call WWO weather data directly as tools.

Deploy to Railway

Step 1 — Push to GitHub
  1. Create a new repository on github.com (call it wwo-mcp-server)
  2. Open Terminal in this folder and run:
git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/YOUR_USERNAME/wwo-mcp-server.git
git push -u origin main
Step 2 — Deploy on Railway
  1. Go to https://railway.app and sign up / log in with GitHub
  2. Click New Project → Deploy from GitHub repo
  3. Select your wwo-mcp-server repository
  4. Railway detects Node.js automatically and deploys

Your server will be live at a URL like:

https://wwo-mcp-server-production.up.railway.app
Step 3 — Add Custom Domain
  1. In Railway dashboard → your project → Settings → Networking → Custom Domain
  2. Type mcp.worldweatheronline.com and click Add
  3. Railway shows you a CNAME value like:
     wwo-mcp-server-production.up.railway.app
  4. Go to your DNS provider and add:
    TypeNameValue
    CNAMEmcpwwo-mcp-server-production.up.railway.app
  5. SSL certificate is provisioned automatically within minutes
Step 4 — Test

Visit your health endpoint:

https://mcp.worldweatheronline.com/health

Test in MCP Inspector:

https://mcp.worldweatheronline.com/mcp?key=YOUR_WWO_API_KEY

Connecting AI Clients

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "world-weather-online": {
      "url": "https://mcp.worldweatheronline.com/mcp?key=YOUR_API_KEY"
    }
  }
}
Cursor / Windsurf

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "world-weather-online": {
      "url": "https://mcp.worldweatheronline.com/mcp?key=YOUR_API_KEY"
    }
  }
}

Available Tools

ToolDescription
get_weatherCurrent conditions + 14-day forecast
get_historical_weatherPast weather from 2008 onwards
get_marine_weatherSwell, tides, water temperature
get_ski_weatherTop/mid/base elevation forecasts
search_locationLocation autocomplete
get_astronomySunrise, sunset, moon phase
get_timezoneLocal time + UTC offset
get_climate_averagesMonthly 12-year climate averages

Local Development

npm install
npm run dev

Server runs at http://localhost:3000

Frequently asked questions

What is World Weather Online?

Global weather API: forecasts, historical data, marine, ski, astronomy and timezone.

How do I install World Weather Online?

It runs as a remote server. In Claude Code: claude mcp add --transport http world-weather-online 'https://mcp.worldweatheronline.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does World Weather Online need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is World Weather Online open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains World Weather Online?

It is published by WorldWeatherOnline. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.