Sunshine Atlas MCP server
Sunshine Atlas MCP lets you query long-term climate normals to find sunny destinations, inspect monthly climate, and compare places.
Find sunny destinations by month, ranked by Sunshine Score; filter by continent/country, minimum daytime temperature, population, swimmable sea (≥21°C), and result limit up to 50.
Get a full 12-month climate card for a city, "city, country", or IATA airport code, including Sunshine Score, day/night temperatures, rainfall, sea temperature, sunniest month, and annual sunshine hours.
Compare 2–5 destinations side-by-side year-round or for a specific month, with a one-line verdict on which is sunnier.
Results include attribution and citable sunshineatlas.com URLs; data describes typical climate normals, not forecasts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Sunshine Atlas MCP server Where is it sunny and warm in October?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Sunshine Atlas MCP server
A remote, read-only Model Context Protocol server that answers "where is it sunny?" with data: monthly 0–100 Sunshine Scores, day/night temperatures, rainfall, midday UV index (WHO scale) and sea temperature for 3,833 destinations — every one with its own airport — from long-term climate normals. It serves the same open dataset published at sunshineatlas.com/data (CC BY 4.0, DOI 10.5281/zenodo.21322408).
Live endpoint (no key, no signup):
https://sunshineatlas.com/api/mcpListed in the official MCP registry as
com.sunshineatlas/sunshine-atlas. Docs page: sunshineatlas.com/mcp.
Tools
Tool | Answers |
| "Where is it sunny (and warm) in November?" — ranked by that month's Sunshine Score, filterable by continent/country, minimum day temperature, swimmable sea (≥21 °C), population |
| "When is the best time to visit Faro?" — full 12-month climate card for one destination (city, "city, country" or IATA code) |
| "Algarve or Crete in October?" — side-by-side comparison of 2–5 destinations with a one-line verdict |
Every result carries attribution and citable sunshineatlas.com destination URLs.
Related MCP server: Weather MCP Server
Connect a client
Claude Code
claude mcp add --transport http sunshine-atlas https://sunshineatlas.com/api/mcpClaude (custom connector), ChatGPT connectors, or any Streamable-HTTP client — add the URL
https://sunshineatlas.com/api/mcp.
Generic JSON config (Cursor, etc.)
{
"mcpServers": {
"sunshine-atlas": {
"url": "https://sunshineatlas.com/api/mcp"
}
}
}Self-host
The server is a single stateless Node file (fresh McpServer per request, plain JSON responses,
binds to 127.0.0.1 — put it behind your reverse proxy). It reads one dataset file and hot-reloads
it on mtime change.
npm install
curl -O https://sunshineatlas.com/data/sunshine-atlas-destinations.json
PORT=8787 DATA_FILE=./sunshine-atlas-destinations.json node server.mjsGET /healthz reports status and destination count. server.json is the MCP-registry manifest.
Data & methodology
Sunshine Score =
100 × warmth × (0.5 + 0.5 × (0.55 × dryness + 0.45 × sunniness)), computed from long-term climate normals — methodology.Sources: temperature, rainfall and sunshine from NASA POWER climatology (2001–2020); places & populations from GeoNames & OurAirports; sea temperatures via Open-Meteo Marine.
Dataset: sunshineatlas.com/data · CSV/JSON · CC BY 4.0 · mirrors on GitHub, Hugging Face and Zenodo.
License
Code MIT. Data CC BY 4.0 (credit "Sunshine Atlas" + link). Not a forecast — climate normals describe typical conditions, not this week's weather.
Available Tools
3 toolscompare_destinationsCompare destinationsA
Side-by-side sunshine/climate comparison of 2–5 destinations — overall or for one month ("Algarve or Crete in October?"). Returns each place's Sunshine Score, temperatures, rain and sea temperature, plus a one-line verdict of which is sunnier.
Inputs: destinations (required), month.
find_sunny_destinationsFind sunny destinationsA
Ranked answer to "where is it sunny (and warm) in ?" — destinations sorted by that month's 0–100 Sunshine Score (long-term climate normals). Filter by continent or country, minimum daytime temperature, population, or swimmable sea (≥21°C). Every result has a citable sunshineatlas.com URL.
Inputs: month (required), limit, where, min_day_high_c, +2 more.
get_destination_climateDestination climate & best time to visitA
Full climate card for one destination: 0–100 Sunshine Score, day/night °C, rainfall and sea temperature for all 12 months, plus its sunniest month ("best time to visit" for sunshine) and annual sunshine hours. Accepts a city name ("Faro"), "city, country" ("Nice, France") or IATA airport code ("FAO").
Inputs: destination (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool serves a clearly distinct purpose: comparison of multiple destinations, ranked search by month, and detailed single-destination climate data. There is no overlap or ambiguity.
All tool names follow a consistent verb_noun pattern: compare_destinations, find_sunny_destinations, get_destination_climate. The verbs are descriptive and the nouns indicate the object of the action.
Three tools is slightly on the low side but appropriate for a focused climate comparison server. The tools cover the core use cases without unnecessary bloat.
The tool set covers comparison, search, and detailed climate data. A minor gap might be a tool to list all available destinations or get metadata, but for the stated purpose it is reasonably complete.
Maintenance
Related MCP Connectors
Where is it sunny? Monthly sunshine scores, temps, rain, UV and sea temp for 3,833 destinations.
Weather data, forecast API, climate data, historical weather, alerts, agricultural & travel weather.
When to go and where to book: 87 places scored month by month from measured weather.
Travel data tools: destinations, places, India heritage, visas, weather. Account required.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides real-time, historical, and forecasted weather data for any location worldwide using the Open-Meteo API. It includes specialized tools for agricultural growing conditions, weather alerts, and up to 16 days of forecasts across multiple transport modes.13 npmMIT
- FlicenseNot gradedqualityDmaintenanceProvides AI assistants with tools to retrieve current weather, 7-day forecasts, and city-to-city weather comparisons using the Open-Meteo API. It features specialized resources for weather data and prompts for generating weather summaries without requiring an API key.28 npm-
- AlicenseNot gradedqualityDmaintenanceProvides real-time weather information and multi-day forecasts for global locations using city names, coordinates, or ZIP codes. It includes tools for current conditions, forecasting, and weather summaries designed for activity planning.11 npmMIT
- AlicenseNot gradedqualityFmaintenanceProvides weather and climate intelligence for AI agents, including current conditions, forecasts, historical data, severe-weather alerts, agricultural outlook, and travel conditions via free and paid tools.1MIT