Wwo

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:

   Type	Name	Value
   CNAME	mcp	wwo-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

Tool	Description
get_weather	Current conditions + 14-day forecast
get_historical_weather	Past weather from 2008 onwards
get_marine_weather	Swell, tides, water temperature
get_ski_weather	Top/mid/base elevation forecasts
search_location	Location autocomplete
get_astronomy	Sunrise, sunset, moon phase
get_timezone	Local time + UTC offset
get_climate_averages	Monthly 12-year climate averages

---

Local Development

npm install
npm run dev

Server runs at http://localhost:3000