Skip to content

io.github.JaviMaligno/vitamind

by JaviMaligno · remote · no sign-in to list tools · v1.0.0 · published by GitHub user JaviMaligno

Know when the sun can make vitamin D where you are, for your skin type. Live UV data.

Final · 1Changes · 3

15 tools: 1 do something that can't be undone, 3 change things and 11 only read.

Scanned Oct 21, 2026

2 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http vitamind https://getvitamind.app/api/mcp/mcp

Findings

Matches of fixed checks, with the text they matched.

2 warn
  • The description names a tool "vitamin_d" that this server does not list.

    Matched text

    description: "...times — for vitamin D questions use the vitamin_d tools instead."

    What this check looks for
  • The description contains "every other tool", wording about other tools or servers.

    Matched text

    description: "...an interactive form for the four values every other tool assumes — Fitzpatrick skin type, fracti..."

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

15 tools

Can't be undone 1Claude Code: ask
  • set_history_locationRecords where the signed-in user was over a range of past days, so their history stops assuming.No findings

    Why it is in this group

    • The name "set_history_location" says "set": a word for a change.
    • The input addresses people (input.to): what it sends cannot be taken back.
    Description, as the server wrote it
    Records where the signed-in user was over a range of past days, so their history stops assuming. Use it when the user corrects a stretch — get_my_history marks inherited days with `locationAssumed`, and the history calendar offers those stretches for correction. Pass a cityId from search_city, or lat/lon. Changes only the location: whether they went outside that day is untouched. Requires OAuth (scope history:write).
Changes things 3Claude Code: ask
  • estimate_sun_sessionEstimate a sun session's outcome: 'I was (or will be) out N minutes — how much vitamin D did I make?' plus 'how long before I'd burn?' for the profile.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Estimate a sun session's outcome: 'I was (or will be) out N minutes — how much vitamin D did I make?' plus 'how long before I'd burn?' for the profile. Takes a start time (defaults to the day's best hour) and session minutes; returns estimated IU (with the physiological cap), average UV and clear-sky minutes-to-sunburn. Use for any 'how much did I get / can I get in X minutes' or 'how long without burning' question.
  • log_sun_sessionSets a day's answer in the signed-in user's history calendar.No findings

    Why it is in this group

    • The name "log_sun_session" says "log": a word for reading.
    • The description's first verb is "set": a word for a change.
    Description, as the server wrote it
    Sets a day's answer in the signed-in user's history calendar. Three values: confirmed=true (went out, the default), confirmed=false (had usable sun but stayed in), confirmed=null (clear the answer). Defaults to today. Requires OAuth (scope history:write).
  • update_my_profileSave the signed-in user's synthesis profile — skin type, exposed-skin fraction, age and target IU — to their account, so the app and every later call use them.No findings

    Why it is in this group

    • The name "update_my_profile" says "update": a word for a change.
    Description, as the server wrote it
    Save the signed-in user's synthesis profile — skin type, exposed-skin fraction, age and target IU — to their account, so the app and every later call use them. Requires OAuth (scope profile:write). Only these four values are writable; favourites, cities and history are not.
Only reads 11Claude Code: allow
  • compare_vitamin_d_yearCompare the vitamin D year of 2 to 5 places side by side in ONE call — 'Madrid vs Berlin vs Oslo, where do I actually get winter sun?'.No findings

    Why it is in this group

    • The name "compare_vitamin_d_year" says "compare": a word for reading.
    Description, as the server wrote it
    Compare the vitamin D year of 2 to 5 places side by side in ONE call — 'Madrid vs Berlin vs Oslo, where do I actually get winter sun?'. Returns each place's months with sun, exact season span and viable days per year, plus rankedByViableDays. Use this instead of calling get_vitamin_d_year once per city: only this tool can draw the years on a shared axis.
  • configure_sun_profileShow the user an interactive form for the four values every other tool assumes — Fitzpatrick skin type, fraction of skin exposed, age and target IU — with the minutes they need upd…1 finding

    Why it is in this group

    • The description's first verb is "show": a word for reading.

    Findings

    • Warn

      The description contains "every other tool", wording about other tools or servers.

      Matched text

      description: "...an interactive form for the four values every other tool assumes — Fitzpatrick skin type, fracti..."

      What this check looks for
    Description, as the server wrote it
    Show the user an interactive form for the four values every other tool assumes — Fitzpatrick skin type, fraction of skin exposed, age and target IU — with the minutes they need updating live. Use this when those values are unknown, when the user wants to change them, or instead of asking for them one at a time in conversation. Whatever the user picks comes back into the conversation; pass those values explicitly to the other tools afterwards.
  • get_current_statusWhether RIGHT NOW is a good moment for vitamin D synthesis at a location, using live Open-Meteo UV/cloud data when reachable (clear-sky model otherwise): current UV index, minutes …No findings

    Why it is in this group

    • The name "get_current_status" says "get": a word for reading.
    Description, as the server wrote it
    Whether RIGHT NOW is a good moment for vitamin D synthesis at a location, using live Open-Meteo UV/cloud data when reachable (clear-sky model otherwise): current UV index, minutes needed now, and when today's window opens or closes.
  • get_my_citiesThe signed-in user's current city and favorite cities with coordinates and timezones, ready to feed into the public tools.No findings

    Why it is in this group

    • The name "get_my_cities" says "get": a word for reading.
    Description, as the server wrote it
    The signed-in user's current city and favorite cities with coordinates and timezones, ready to feed into the public tools. Requires OAuth (scope profile:read).
  • get_my_historyThe signed-in user's sun history from the app's calendar: which recent days had viable sun, which they confirmed going outside, and their current streak.No findings

    Why it is in this group

    • The name "get_my_history" says "get": a word for reading.
    Description, as the server wrote it
    The signed-in user's sun history from the app's calendar: which recent days had viable sun, which they confirmed going outside, and their current streak. Covers the calendar days from `from` to `to`; records exist only for days the app was open, so a date missing from `records` means nothing was measured, not that the sun was insufficient. Requires OAuth (scope history:read). Renders as a calendar the user can tap to confirm a day.
  • get_my_profileThe signed-in user's saved Vitamin D profile: skin type, exposed-skin default, age, target IU and their current city.No findings

    Why it is in this group

    • The name "get_my_profile" says "get": a word for reading.
    Description, as the server wrote it
    The signed-in user's saved Vitamin D profile: skin type, exposed-skin default, age, target IU and their current city. Requires connecting with OAuth (scope profile:read). Call this FIRST for any personal question, then pass its values to the public tools instead of asking the user.
  • get_sun_forecastThe NEXT FEW DAYS of vitamin D sun at a location, using the live Open-Meteo forecast: per day the peak UV, average cloud cover, the synthesis window and the minutes needed, plus be…No findings

    Why it is in this group

    • The name "get_sun_forecast" says "get": a word for reading.
    Description, as the server wrote it
    The NEXT FEW DAYS of vitamin D sun at a location, using the live Open-Meteo forecast: per day the peak UV, average cloud cover, the synthesis window and the minutes needed, plus bestDay. Use this for any question spanning several days — 'which day this week should I go out', 'will it be better tomorrow', 'when's my next chance' — instead of calling get_vitamin_d_window once per date.
  • get_sun_timesSunrise, sunset, solar noon, civil dawn/dusk, morning AND evening golden hour, and day length (with day-over-day trend) for a location and date.1 finding

    Why it is in this group

    • The name "get_sun_times" says "get": a word for reading.

    Findings

    • Warn

      The description names a tool "vitamin_d" that this server does not list.

      Matched text

      description: "...times — for vitamin D questions use the vitamin_d tools instead."

      What this check looks for
    Description, as the server wrote it
    Sunrise, sunset, solar noon, civil dawn/dusk, morning AND evening golden hour, and day length (with day-over-day trend) for a location and date. Handles midnight sun and polar night. Pure sun times — for vitamin D questions use the vitamin_d tools instead.
  • get_vitamin_d_windowThe solar vitamin D synthesis window for ONE specific day at a location, for a personal profile: when UV is strong enough (index ≥ 3), the best hour, the clear-sky minutes needed t…No findings

    Why it is in this group

    • The name "get_vitamin_d_window" says "get": a word for reading.
    Description, as the server wrote it
    The solar vitamin D synthesis window for ONE specific day at a location, for a personal profile: when UV is strong enough (index ≥ 3), the best hour, the clear-sky minutes needed to reach the target IU, and (with atTime) the minutes at the specific hour the user plans to go out. Returns synthesisPossible=false when the sun never gets high enough that day. Only for single-day questions — for months, seasons or 'when during the year', call get_vitamin_d_year instead of calling this once per date.
  • get_vitamin_d_yearThe WHOLE YEAR of solar vitamin D for a location in a single call.No findings

    Why it is in this group

    • The name "get_vitamin_d_year" says "get": a word for reading.
    Description, as the server wrote it
    The WHOLE YEAR of solar vitamin D for a location in a single call. monthsWithSun lists every month with at least one viable day (season edges count as partial months, see byMonth[].viableDays); solidMonths lists months where most days work; exactViableSpan gives the exact season boundaries; summary carries per-year aggregates for comparing places. Use this for any question about months, seasons, winter/summer or 'when during the year can I…' — never probe individual dates with get_vitamin_d_window for that.
  • search_cityFind a city in the app's database by name (any of the app's six languages works) and get its coordinates, IANA timezone and elevation — feed those into the other tools.No findings

    Why it is in this group

    • The name "search_city" says "search": a word for reading.
    Description, as the server wrote it
    Find a city in the app's database by name (any of the app's six languages works) and get its coordinates, IANA timezone and elevation — feed those into the other tools.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http vitamind https://getvitamind.app/api/mcp/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__vitamind__search_city",
      "mcp__vitamind__get_sun_times",
      "mcp__vitamind__get_vitamin_d_window",
      "mcp__vitamind__get_vitamin_d_year",
      "mcp__vitamind__configure_sun_profile",
      "mcp__vitamind__get_sun_forecast",
      "mcp__vitamind__compare_vitamin_d_year",
      "mcp__vitamind__get_current_status",
      "mcp__vitamind__get_my_profile",
      "mcp__vitamind__get_my_cities",
      "mcp__vitamind__get_my_history"
    ],
    "ask": [
      "mcp__vitamind__estimate_sun_session",
      "mcp__vitamind__update_my_profile",
      "mcp__vitamind__log_sun_session",
      "mcp__vitamind__set_history_location"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as vitamind. Review it before you use it.