Search / io.github.JaviMaligno/vitamind
vitamind
R0· no sign-inKnow when the sun can make vitamin D where you are, for your skin type. Live UV data.
v1.0.0 · active · repository · website · descriptor JSON · versions
Search / io.github.JaviMaligno/vitamind
R0· no sign-inKnow when the sun can make vitamin D where you are, for your skin type. Live UV data.
v1.0.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"vitamind": {
"type": "http",
"url": "https://getvitamind.app/api/mcp/mcp"
}
}
}claude mcp add --transport http vitamind https://getvitamind.app/api/mcp/mcp[mcp_servers.vitamind]
url = "https://getvitamind.app/api/mcp/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"vitamind": {
"type": "remote",
"url": "https://getvitamind.app/api/mcp/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"vitamind": {
"type": "http",
"url": "https://getvitamind.app/api/mcp/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=vitamind&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZ2V0dml0YW1pbmQuYXBwL2FwaS9tY3AvbWNwIn0%3D"
}{
"servers": {
"vitamind": {
"type": "http",
"url": "https://getvitamind.app/api/mcp/mcp"
}
}
}{
"mcpServers": {
"vitamind": {
"httpUrl": "https://getvitamind.app/api/mcp/mcp"
}
}
}extensions:
"vitamind":
enabled: true
name: "vitamind"
type: streamable_http
uri: "https://getvitamind.app/api/mcp/mcp"
timeout: 300
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prmProtected Resource Metadata (RFC 9728) publishedauth.as_metadataauthorization server metadata reachableauth.cimdonly Dynamic Client Registration, deprecated in 2026-07-28 in favour of CIMDauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky onestools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_my_cities (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_vitamin_d_year (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); configure_sun_profile (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …tools.token_costabout 4,484 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changesno tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-85d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://getvitamind.app/api/mcp/mcp streamable-http | none | yes | 100% | 294 ms | 2025-11-25 | 2026-10-19 |
https://getvitamind.app/api/mcp-auth/mcp streamable-http | oauth2 AS: https://getvitamind.app | yes | 100% | 298 ms | – | 2026-10-20 |
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. |
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 values explicitly to the other tools afterwards. |
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 burning' question. |
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. |
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). |
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 the user can tap to confirm a day. |
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. |
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. |
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. |
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, seasons or 'when during the year', call get_vitamin_d_year instead of calling this once per date. |
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, winter/summer or 'when during the year can I…' — never probe individual dates with get_vitamin_d_window for that. |
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). |
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. |
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 (scope history:write). |
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. |
Schemas: list_tools.
{
"name": "io.github.JaviMaligno/vitamind",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://getvitamind.app/api/mcp/mcp",
"type": "streamable-http"
},
{
"url": "https://getvitamind.app/api/mcp-auth/mcp",
"type": "streamable-http"
}
],
"version": "1.0.0",
"repository": {
"url": "https://github.com/JaviMaligno/vitamind",
"source": "github"
},
"websiteUrl": "https://getvitamind.app/connect",
"description": "Know when the sun can make vitamin D where you are, for your skin type. Live UV data."
}