D8ly Read

Daily Chinese Almanac / 每日黃曆

get_daily_almanac

Read-onlyIdempotent

Use this when the user asks for Chinese almanac information for a specific calendar date without personal birth data. Returns the day pillar, lunar date, activities, directions, and zodiac clash. Do not use this for a personalized Bazi chart or daily Bazi guidance. No generative AI is used. / 當使用者詢問特定日期的黃曆資料、且不涉及個人出生資料時使用。回傳日柱、農曆、宜忌、吉神方位與生肖相沖。個人八字命盤或八字每日指引請勿使用此工具。本工具不使用生成式 AI。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`date`	Yes	Calendar date in YYYY-MM-DD format / YYYY-MM-DD 格式的日期
`locale`	No	Response display preference; structured technical values include both languages / 回應語言偏好；結構化術語同時包含中英文	en

Output Schema

TableJSON Schema

Name	Required	Description	Default
`data`	Yes
`tool`	Yes
`locale`	Yes
`disclaimer`	Yes
`generated_at`	Yes
`canonical_url`	Yes
`deterministic`	Yes
`schema_version`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed9 schema fields changedSep 8, 2026

addedOutput schema / properties / canonical_url / format
```
Added value: +"uri"
```
changedOutput schema / properties / data / additionalProperties
```
Previous value: -{}New value: +false
```

addedOutput schema / properties / data / properties

Added value: +{
+  "activities": {
+    "additionalProperties": false,
+    "properties": {
+      "suitable": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "en": {
+              "type": "string"
+            },
+            "zh": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "en",
+            "zh"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "unsuitable": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "en": {
+              "type": "string"
+            },
+            "zh": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "en",
+            "zh"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "suitable",
+      "unsuitable"
+    ],
+    "type": "object"
+  },
+  "auspicious_directions": {
+    "additionalProperties": false,
+    "properties": {
+      "fortune": {
+        "additionalProperties": false,
+        "properties": {
+          "en": {
+            "type": "string"
+          },
+          "zh": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "en",
+          "zh"
+        ],
+        "type": "object"
+      },
+      "joy": {
+        "additionalProperties": false,
+        "properties": {
+          "en": {
+            "type": "string"
+          },
+          "zh": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "en",
+          "zh"
+        ],
+        "type": "object"
+      },
+      "wealth": {
+        "additionalProperties": false,
+        "properties": {
+          "en": {
+            "type": "string"
+          },
+          "zh": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "en",
+          "zh"
+        ],
+        "type": "object"
+      },
+      "yang_noble": {
+        "additionalProperties": false,
+        "properties": {
+          "en": {
+            "type": "string"
+          },
+          "zh": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "en",
+          "zh"
+        ],
+        "type": "object"
+      },
+      "yin_noble": {
+        "additionalProperties": false,
+        "properties": {
+          "en": {
+            "type": "string"
+          },
+          "zh": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "en",
+          "zh"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "joy",
+      "wealth",
+      "fortune",
+      "yang_noble",
+      "yin_noble"
+    ],
+    "type": "object"
+  },
+  "date": {
+    "type": "string"
+  },
+  "day_pillar": {
+    "additionalProperties": false,
+    "properties": {
+      "earthly_branch": {
+        "additionalProperties": false,
+        "properties": {
+          "en": {
+            "type": "string"
+          },
+          "zh": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "en",
+          "zh"
+        ],
+        "type": "object"
+      },
+      "five_elements": {
+        "additionalProperties": false,
+        "properties": {
+          "en": {
+            "type": "string"
+          },
+          "zh": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "en",
+          "zh"
+        ],
+        "type": "object"
+      },
+      "gan_zhi": {
+        "type": "string"
+      },
+      "heavenly_stem": {
+        "additionalProperties": false,
+        "properties": {
+          "en": {
+            "type": "string"
+          },
+          "zh": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "en",
+          "zh"
+        ],
+        "type": "object"
+      },
+      "na_yin": {
+        "additionalProperties": false,
+        "properties": {
+          "en": {
+            "type": "string"
+          },
+          "zh": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "en",
+          "zh"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "heavenly_stem",
+      "earthly_branch",
+      "gan_zhi",
+      "five_elements",
+      "na_yin"
+    ],
+    "type": "object"
+  },
+  "lunar_date": {
+    "additionalProperties": false,
+    "properties": {
+      "en": {
+        "type": "string"
+      },
+      "zh": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "en",
+      "zh"
+    ],
+    "type": "object"
+  },
+  "zodiac_clash": {
+    "additionalProperties": false,
+    "properties": {
+      "animal": {
+        "additionalProperties": false,
+        "properties": {
+          "en": {
+            "type": "string"
+          },
+          "zh": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "en",
+          "zh"
+        ],
+        "type": "object"
+      },
+      "description": {
+        "additionalProperties": false,
+        "properties": {
+          "en": {
+            "type": "string"
+          },
+          "zh": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "en",
+          "zh"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "animal",
+      "description"
+    ],
+    "type": "object"
+  }
+}

removedOutput schema / properties / data / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```

addedOutput schema / properties / data / required

Added value: +[
+  "date",
+  "lunar_date",
+  "day_pillar",
+  "activities",
+  "auspicious_directions",
+  "zodiac_clash"
+]

addedOutput schema / properties / generated_at / format
```
Added value: +"date-time"
```

addedOutput schema / properties / generated_at / pattern

Added value: +"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"

changedOutput schema / properties / schema_version / const
```
Previous value: -"2026-08-20"New value: +"2026-09-07"
```
addedOutput schema / properties / tool / const
```
Added value: +"get_daily_almanac"
```

First observedSep 1, 2026

TDQS

A4.4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint, so the safety profile is covered. The description adds meaningful behavioral context beyond the annotations, notably that no generative AI is used and that the tool only works for non-personalized date-based almanac queries. It does not add unnecessarily detailed caveats like rate limits or auth, which are not critical for this tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core English description is concise, front-loaded with the use case, and every sentence adds value. The bilingual format repeats the same content in Chinese, which is justifiable given the zh locale option but does add some redundancy. Overall it remains appropriately sized and scannable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's low complexity, a complete input schema, strong annotations, and an output schema, the description covers everything needed for correct invocation: when to use it, what it returns, what it excludes, and its non-generative behavior. No critical operational detail is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already fully documents both parameters: date in YYYY-MM-DD format and locale as an enum with a default. The description does reinforce that the date is a specific calendar date and that personal birth data is out of scope, but it does not provide substantial additional parameter-level detail beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific resource ('daily Chinese almanac'), a specific verb ('get'), and lists the exact returned data: day pillar, lunar date, activities, directions, and zodiac clash. It also explicitly distinguishes itself from personalized Bazi chart or daily Bazi guidance tools, so an agent can tell it apart from its siblings immediately.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives an explicit trigger condition: use when the user asks for almanac information for a specific calendar date without personal birth data. It also states negative conditions: do not use for personalized Bazi charts or daily Bazi guidance, which map directly to the sibling tools calculate_bazi_chart and get_daily_bazi_guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All D8ly Read tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?