MCP server for Japanese business days, public holidays, imperial-era (wareki) dates and tax arithmetic. Zero dependencies.
Solid domain-specific tool set with clear, consistent naming and good descriptions. All 11 tools have explicit schemas and descriptions. However, parameter descriptions lack depth (missing format constraints, ranges, and error guidance), output schemas are undocumented, and error handling is minimal. Tool names follow verb_noun pattern well (jp_check_date, jp_shift_days, tse_is_trading_day). Descriptions average ~150 chars, within baseline (194 chars p50). No security issues detected (read-only tools, no secrets). Main gaps: parameter constraints (e.g., date format validation, numeric ranges), output structure documentation, and recovery guidance for invalid inputs.
Check whether a Japanese calendar date is a business day. Returns weekday, weekend/public-holiday flags and a business-day flag. Public holidays are bundled for 2020-2031.
Count calendar days and business days between two dates (Japanese holidays excluded from business days). Order of the two dates does not matter.
Convert a Japanese era date to the Gregorian calendar. Warns when the given month/day falls outside that era.
Calculate the furusato-nozei (hometown tax donation) limit where the out-of-pocket cost stays at 2,000 yen, using the residence-tax income levy from the annual tax notice.
Calculate the annual income-tax and residence-tax reduction from iDeCo contributions in Japan (contributions are fully deductible). Deduction effect only.
Move a date forward or backward by N days, either in business days (skipping weekends and Japanese public holidays) or calendar days. Negative values move backward.
Output schemas undocumented. Tools return results but LLMs cannot see what fields to expect. E.g., jp_check_date returns weekday/holiday flags but structure is invisible in schema.
Parameter descriptions lack format constraints and ranges. 'date' param says 'YYYY-MM-DD' but no validation guidance. 'days' param unbounded, LLM could pass 999999. 'taxable_income' has no range or unit clarity.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 66 | 2026-07-28+ | v2 |
Convert a Gregorian date to the Japanese imperial era format (令和/平成/昭和/大正/明治). Era boundaries are handled to the day.
Count Tokyo Stock Exchange trading days between two dates. Useful for annualising returns and sizing backtest samples.
Check whether the Tokyo Stock Exchange is open on a date. Exchange closures are a SUPERSET of Japanese public holidays: TSE also closes 31 Dec - 3 Jan. Returns the closure reason and session hours. Covers 2020-2031.
Move forward or backward by N Tokyo Stock Exchange trading days (skipping weekends, public holidays and the year-end break). Negative values move backward. Use this for settlement dates and backtest windows.
Number of Tokyo Stock Exchange sessions in a year plus its first and last trading day (daihakkai / dainokai), which shift year to year because of the new-year break.
No error recovery guidance. If date is invalid or out of range (2020-2031 for holidays), tool returns error but LLM has no hint what to do next. Missing actionable error messages.
jp_from_wareki parameter 'era' accepts both Japanese (令和) and Roman (R) abbreviations but description does not clarify which is preferred or if both are always valid.
No batch operations. Tools like jp_shift_days operate on single dates. If agent needs to shift 100 dates, it must call the tool 100 times, wasting tokens and latency.