Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| data-dir | No | Directory where holiday API responses are cached. Defaults to ~/.mcp-chrono/ |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_current_time | Get the current time in a specified timezone. Returns detailed time information including year, month, day, hour, minute, second, weekday, week of year, day of year, and UTC offset. |
| convert_calendar | Convert between Gregorian (solar) and Chinese Lunar calendar. Includes Ganzhi (天干地支), zodiac animal, solar terms, and festival information. |
| convert_timezone | Convert a datetime from one timezone to another. Input can be an ISO 8601 string. |
| list_timezones | List IANA timezones with current offset and time. Uses the system's full IANA timezone database. Can filter by query text or continent. |
| calculate_time | Add or subtract time from a date. Supports Gregorian mode, Lunar mode, and anchor mode (calculate relative to a named festival). |
| date_diff | Calculate the difference between two dates/times. Returns the difference in years, months, days, hours, minutes and also total days/hours/minutes. |
| parse_timestamp | Parse a Unix timestamp (seconds or milliseconds) or ISO 8601 string into detailed date/time components. |
| get_festivals | Get festivals, solar terms, and public holidays within a date range. Supports Chinese (lunar and solar) festivals and public holidays from various countries. |
| get_month_info | Get detailed information about a specific month including number of days, first/last day weekday, whether it's a leap year, and quarter. |
| countdown | Calculate a countdown from now to a target date/time. Returns remaining days, hours, minutes, seconds and whether the date is in the past. |
| calculate_business_days | Calculate business days between two dates or add/subtract business days from a date. Skips weekends and optionally public holidays. |
| get_almanac | Get Chinese almanac (黄历/老黄历) information for a specific date. Includes suitable activities (宜), things to avoid (忌), conflict zodiac (冲), lucky directions, and more. |
| manage_countdown | Manage persistent countdown timers. Supports CRUD operations: set (create), get (read one), list (read all), delete. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |