Skip to main content
Glama
jalali-calendar-mcp

jalali-calendar-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

The Iranian (Jalali, Solar Hijri) calendar: today in Iran, date conversion, months, official holidays and workdays. Works offline with no account. Fixed solar holidays are 'official'. Lunar holidays are 'listed' when the package has that year's list, otherwise 'estimated' and possibly one day off in Iran: say so when it matters, for example for a legal deadline. Fridays are the weekly day off.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
todayA

Today's date in Iran (Asia/Tehran), Jalali and Gregorian, and whether it is a day off.

convert_dateA

Convert a date between the Jalali (Persian) and Gregorian calendars.

Args: value: Gregorian YYYY-MM-DD or Jalali YYYY/MM/DD (Persian digits are fine; any year below 1700 is Jalali).

get_monthB

Every day of a Jalali month with its Gregorian date, weekday, Fridays and holidays.

Args: year: Jalali year, e.g. 1405. month: 1 (Farvardin) to 12 (Esfand).

get_holidaysA

Iran's official holidays in a Jalali year, in date order. Fridays are not listed.

Args: year: Jalali year, e.g. 1405.

is_holidayA

Whether a day is a Friday or an official holiday in Iran, and which.

Args: value: Gregorian YYYY-MM-DD or Jalali YYYY/MM/DD.

count_workdaysA

Count the days from start to end (both included) that are not Fridays or official holidays. Thursdays count as workdays. Not a legal deadline calculator: legal periods have their own rules.

Args: start: First day, Gregorian YYYY-MM-DD or Jalali YYYY/MM/DD. end: Last day, same formats (at most ten years after start).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.9/5.0

Scored across 6 tools

Disambiguation4/5

Each tool targets a distinct query shape: conversion, today's snapshot, month listing, year holiday listing, single-day holiday check, and range workday counting. The mild overlaps (get_holidays vs is_holiday, get_month's holiday annotation vs get_holidays) are resolved by clear differences in granularity (year list vs single day vs full month grid).

Naming Consistency4/5

Five of six tools follow a predictable verb_noun or verb_object pattern (convert_date, get_month, get_holidays, count_workdays, is_holiday). The lone 'today' noun-only name is an understandable exception for a snapshot tool but is a minor deviation.

Tool Count5/5

Six tools is well within the sweet spot, and each one maps to a distinct, non-trivial calendar operation. Nothing feels redundant or padded.

Completeness4/5

Coverage spans conversion, current date, month view, holidays, holiday checking, and workday ranges — the core needs of a Jalali calendar server. Minor gaps remain, such as date arithmetic (add/subtract days), week views, or finding the next holiday/working day, but agents can work around these.

Maintenance

ActivityNo data
ResponsivenessNo recent community issues