Jalali MCP Server

Overview

The Jalali MCP Server is a lightweight Node.js service that exposes the Persian (Jalali) calendar to AI assistants following the Model Context Protocol. It addresses a common pain point for developers building regionalized applications: converting between Gregorian and Jalali dates, determining public holidays, and tracking culturally significant events without relying on external APIs or bulky libraries. By running locally or as a UVX server, it guarantees low latency and full control over the data set.

For developers using Claude or other MCP‑compatible assistants, this server offers a straightforward way to enrich conversational contexts with accurate date information. An AI can query the server for “What is tomorrow’s Persian date?” or “Is today a holiday in Iran?” and receive instant, deterministic answers. This eliminates the need to embed complex calendar logic inside the assistant or perform expensive network calls, thereby improving reliability and reducing costs.

Key capabilities include:

• Bidirectional date conversion between Gregorian and Jalali calendars, supporting both forward and reverse lookups.
• Holiday detection for major Persian holidays such as Nowruz, Eid al-Fitr, and others, with optional regional variations.
• Event tracking for special days (e.g., national commemorations) that can be leveraged in content generation or scheduling workflows.
• Fast, stateless API endpoints that fit neatly into existing MCP toolchains, allowing seamless integration with prompt templates and sampling strategies.

Typical use cases span from chatbots that provide local calendar information, to scheduling assistants that need to respect Persian holidays when proposing meeting times. Content creators can generate culturally relevant timelines, while developers building event‑driven systems can avoid hard‑coding date logic. Because the server is open source and self‑hosted, teams can audit the algorithmic rules for compliance with local regulations or update holiday lists as needed.

Overall, the Jalali MCP Server gives AI workflows a reliable, low‑overhead bridge to Persian calendar data, enabling richer user experiences for audiences in Iran and other regions that use the Jalali system.