Know when the sun can make vitamin D where you are, for your skin type. Live UV data.
| Endpoint | https://getvitamind.app/api/mcp/mcp (streamable-http) |
|---|---|
| Registry version | 1.0.0 |
| Now | 15 tools · grade C (71) · pin ts_20b8c0046ab4b020163aac05cf968ac5 · protocol 2025-06-18 |
| First / last listed | 2026-11-08 01:56 UTC / 2026-11-08 01:56 UTC |
| Grade over time | 2026-11-08: C (71), 15 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: search_city get_sun_times get_vitamin_d_window get_vitamin_d_year configure_sun_profile get_sun_forecast compare_vitamin_d_year get_current_status estimate_sun_session get_my_profile get_my_cities update_my_profile get_my_history log_sun_session set_history_location
search_city | 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. params: query* |
get_sun_times | 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. params: lat*, lon*, date, timezone |
get_vitamin_d_window | 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 params: lat*, lon*, date, timezone, skinType, exposedSkinFraction, age, targetIU, elevationM, atTime |
get_vitamin_d_year | 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, w params: lat*, lon*, timezone, skinType, exposedSkinFraction, age, targetIU, elevationM, placeName |
configure_sun_profile | 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 va params: lat, lon, timezone, placeName, skinType, exposedSkinFraction, age, targetIU |
get_sun_forecast | 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. params: lat*, lon*, timezone, skinType, exposedSkinFraction, age, targetIU, elevationM, days |
compare_vitamin_d_year | 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. params: places*, skinType, exposedSkinFraction, age, targetIU |
get_current_status | 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. params: lat*, lon*, timezone, skinType, exposedSkinFraction, age, targetIU, elevationM |
estimate_sun_session | 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 params: lat*, lon*, date, timezone, skinType, exposedSkinFraction, age, elevationM, startTime, minutes* |
get_my_profile | 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. params: none |
get_my_cities | 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). params: none |
update_my_profile | 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. params: skinType, exposedSkinFraction, age, targetIU |
get_my_history | 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 params: days |
log_sun_session | 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). params: date, minutes, confirmed |
set_history_location | 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 (s params: from*, to*, cityId, lat, lon |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.