get_charm
Get a personal birth charm based on birthday — returns patron deity, ornament name, and protection description from Ukrainian pagan tradition.
LABSCO SUMMARY
A dataset with a query surface that runs the way people actually ask: from a date to the holiday, and from a remembered custom back to the day it belongs to.
Holiday entries carry traditions and preparation rituals rather than names alone, which is what makes search_holidays worth having — it matches on descriptions and traditions, so the ritual finds the date. The mythology side is attributed to one named source, the Voytovych encyclopedia, and search_deities narrows by group (supreme, warrior, fertility, underworld, nature, household) instead of leaving you to free text. get_charm is the outlier: it maps a birthday to a patron deity and an ornament, which is a tradition being served rather than a record being looked up.
What it is
A reference server over a Ukrainian pagan calendar and a Slavic mythology dataset, answering by date, by season, by keyword and by deity, with the mythological entries drawn from the Voytovych encyclopedia.
What you get
- get_today_holiday returns the holiday for today or a given date with its name, description, traditions and preparation rituals, and get_holiday_details returns that same depth for a holiday addressed by name or slug.
- get_upcoming_holidays looks ahead across a days window, and get_season_holidays returns a whole season's holidays at once.
- search_holidays matches a keyword against holiday names, descriptions and traditions, so a remembered custom or ritual can find the day it belongs to rather than the other way round.
- get_deity returns a Ukrainian or Slavic deity or mythological figure from the Voytovych encyclopedia, and search_deities searches by name or filters by group — supreme, warrior, fertility, underworld, nature or household.
- get_folk_wisdom returns a Ukrainian weather proverb or agricultural saying for today or a specific date.
- get_charm takes a birthday and returns a patron deity, an ornament name and a protection description from Ukrainian pagan tradition.
Requirements
Nothing — no account, no key.
Setup effort
One command — npx -y mcp-ukrainian-calendar
USE CASES
01
Writing something that has to land on the right day
Check what today carries, look far enough ahead to plan, and read the full entry before you commit to a framing.
02
Tracing a remembered custom back to its day
Search on the ritual or the phrase rather than the holiday name, then open the entry it belongs to.
03
Checking who a Slavic figure actually was before you write them into something
Look the figure up directly, or narrow by the role they played when you know the type but not the name.
04
Planning a season of posts in one sitting
Pull the season's holidays together and pick up the proverb attached to each date you intend to publish on.
05
Building a personal charm from someone's birthday
Get the patron deity and ornament the tradition assigns to that date, then read the figure's own entry.
9 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_deity
Get information about a Ukrainian/Slavic deity or mythological figure from the Voytovych encyclopedia.
get_folk_wisdom
Get Ukrainian folk wisdom (weather proverb or agricultural saying) for today or a specific date.
get_holiday_details
Get detailed information about a specific Ukrainian pagan holiday by name or slug.
get_season_holidays
Get all Ukrainian pagan holidays for a specific season.
get_today_holiday
Get Ukrainian pagan holidays for today or a specific date. Returns holiday name, description, traditions, and preparation rituals.
get_upcoming_holidays
Get upcoming Ukrainian pagan holidays within the next N days.
search_deities
Search Ukrainian/Slavic deities by name or filter by group (supreme, warrior, fertility, underworld, nature, household).
search_holidays
Search Ukrainian pagan holidays by keyword in name, description, or traditions.
BEFORE YOU INSTALL
What to know first
Tools you get
9 tools when we connected.
Requires
npx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the 9 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"mcp-ukrainian-calendar": {
"command": "npx",
"args": [
"-y",
"mcp-ukrainian-calendar"
]
}
}
}npx
TERMINAL
npx -y mcp-ukrainian-calendar
