Model Context Protocol

Weather tools for your AI assistant

Point Claude Desktop, Cursor, Windsurf, or any MCP-compatible AI at one URL and instantly unlock 11 live weather tools — no code, no plugins, just your API key.

Get your API key →Setup guide

How it works

Get an API key

Add your MCP URL

Paste one line into your AI client's config. The URL is your personal endpoint that includes your key.

Ask weather questions

Your AI assistant can now look up real-time weather, forecasts, air quality, and more automatically.

Setup guide

Replace YOUR_API_KEY with the key from your dashboard.

Your MCP endpoint URL

https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY

You can also pass your key as an X-API-Key header or Authorization: Bearer header instead of the query parameter.

Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Go to Cursor → Settings → MCP and add a new server, or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY",
      "type": "http"
    }
  }
}

Any other MCP client

WeatherAI uses the Streamable HTTP transport (MCP spec 2025-03-26) in stateless mode. Add the following to your client's mcp.json (or equivalent config file):

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY",
      "type": "http",
      "transport": "streamable-http"
    }
  }
}

Alternatively, you can pass your key as an X-API-Key header or Authorization: Bearer header instead of the apiKey query parameter.

Available tools

All 11 tools are registered automatically — no configuration needed on your end.

Tool name	Tier	Description
get_current_weather	Standard	Real-time conditions — temperature, wind, humidity, UV, visibility.
get_weather_forecast	Standard	Up to 14-day daily and hourly forecast with rain chance.
get_historical_weather	Premium	Actual past weather for any date and location.
get_future_weather	Premium	Predictions from 14 to 300 days ahead.
get_air_quality	Standard	AQI, PM2.5, PM10, CO, NO2, SO2, and O3.
get_weather_alerts	Standard	Active government weather warnings and advisories.
get_astronomy	Standard	Sunrise, sunset, moonrise, moonset, moon phase.
get_solar_data	Premium	Solar irradiance and energy generation estimates.
get_timezone	Standard	Timezone, UTC offset, and local time for any location.
search_locations	Standard	Find matching cities and places by partial name.
ask_ai_weather	Premium	Plain-English weather questions answered by Claude AI.

Standard tools count against your 1,000 free calls/day. Premium tools count against your 50 free premium calls/day; overage is billed at $0.001/call from your credit balance.

Machine-readable resources

Structured files for AI assistants, directory crawlers, and developer tooling to auto-discover WeatherAI capabilities.

TXT

llms.txt

Plain-text API reference for LLMs

A concise, LLM-readable summary of all WeatherAI endpoints, parameters, authentication methods, and example usage — following the llms.txt convention. Ideal for including in AI system prompts or context windows.

weatherai.io/llms.txt↗

JSON

mcp.json

MCP server discovery manifest

A structured JSON manifest describing the WeatherAI MCP server — endpoint URL, transport protocol, authentication methods, and all 11 tool definitions. Used by MCP directories and compatible clients for auto-discovery.

weatherai.io/.well-known/mcp.json↗

Ready to get started?

Create a free account, grab your API key, and paste one line into your AI client.

Get your free API key →