Skip to main content
Glama
Sunshine Atlas MCP server

Sunshine Atlas MCP server

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/mcp

Listed in the official MCP registry as com.sunshineatlas/sunshine-atlas. Docs page: sunshineatlas.com/mcp.

Tools

Tool

Answers

find_sunny_destinations

"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

get_destination_climate

"When is the best time to visit Faro?" — full 12-month climate card for one destination (city, "city, country" or IATA code)

compare_destinations

"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/mcp

Claude (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.mjs

GET /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 tools
compare_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

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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 npm
      MIT