Lunar Calendar Service FAQs

Question 1

Can the service help find auspicious days for specific purposes?

Accepted Answer

Absolutely. It includes a `get_lucky_days` tool that allows you to query for auspicious (黄道吉日) days within a specified date range, with the flexibility to filter and specify the purpose for which you need the lucky day (e.g., opening a business, travel).

Question 2

What is the Lunar Calendar Service?

Accepted Answer

The Lunar Calendar Service is a comprehensive API designed for AI agents, providing traditional Chinese calendar data. It includes lunar-solar conversions, all 24 solar terms, statutory holidays, daily almanac details, and advanced astrological information.

Question 3

How can I integrate this service with my AI agent?

Accepted Answer

The service is built as an MCP (Multi-Modal Communication Protocol) server, facilitating easy integration with AI agents such as Claude Desktop, Cursor, and Windsurf. You simply configure the provided SSE URL in your agent's settings.

Question 4

Does it provide information about Chinese traditional holidays?

Accepted Answer

Yes, the service offers extensive access to statutory Chinese holiday information, including annual schedules and the ability to check if a specific date is a holiday or a compensatory workday. It supports current and upcoming years' holiday data.

Question 5

What specific calendar data can I access through the API?

Accepted Answer

You can access Gregorian-Lunar date conversions, query all 24 solar terms for any year, retrieve statutory holiday information and schedules, get daily almanac details (auspicious/inauspicious activities, lucky directions), and advanced astrological data like Bazi, Wuxing, and auspicious day calculations.

Lunar Calendar Service

Lunar Calendar Service

Key Features

Use Cases

Key Features

Use Cases