MCP server for Taiwan holiday information. Provides tools to check holidays, query holiday ranges, and retrieve statistics about Taiwan holidays.
The Taiwan Holiday MCP Server provides three well-defined tools with complete input schemas and descriptions in Traditional Chinese. All tools are read-only operations on holiday data. Naming follows verb_noun convention (check_holiday, get_holidays_in_range, get_holiday_stats). Input schemas are properly defined with JSON Schema including type, properties, required fields, and regex patterns for date validation. Descriptions are present in Chinese and convey purpose clearly. However, there are gaps: (1) Output schemas are not documented in tool definitions, callers cannot know the response structure; (2) Parameter descriptions lack detail about format constraints and expected behavior; (3) No error handling guidance is provided to help agents recover from failures; (4) No batch operations despite potential for common multi-year queries. The codebase shows clean TypeScript implementation with error types and health monitoring, but the tool interface itself lacks the production-grade detail needed for reliable agent operation.
檢查指定日期是否為台灣假期
獲取指定年份或年月的台灣假期統計資訊
獲取指定日期範圍內的所有台灣假期
Output schemas not documented. Tools return structured data but callers cannot see what fields to expect. This violates pattern:tool which requires documenting return types.
Parameter descriptions lack actionable constraint details. 'date' parameter states format support but does not explain what happens if format is invalid, whether dates must be future/past, or range boundaries (e.g., 'Supports YYYY-MM-DD or YYYYMMDD format. Dates must be 2017 or later.' is missing).
No error recovery guidance. Error handling in code returns JSON error messages, but tool descriptions do not tell the LLM how to recover from common failures (out-of-range date, malformed input, no holidays in range).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 62 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 0 | - | v1 |
get_holiday_stats schema has unbounded year maximum (maximum:null). This is incomplete and may cause validation surprises. Should set explicit maximum (e.g., current year + 5 or 2100).
No batch or pagination support. Tools could benefit from accepting arrays or returning paginated results, especially get_holidays_in_range which might return 50+ holidays. No limit parameter or next_cursor documented.
Descriptions are in Traditional Chinese only. While culturally appropriate, English descriptions would broaden accessibility for non-Chinese-speaking agents and integrators. Multilingual descriptions are best practice.