Skip to main content
Glama

日本の給与・社会保険・労働法

祝日・営業日計算(銀行カレンダー対応)

business_days

Count business days in a range, shift a date by N business days, or check one date. Covers 1955-2027 including substitute holidays, 国民の休日 (a weekday that is a holiday only because it sits between two others) and one-off imperial events, so the awkward years are right and not only the tidy ones.

Set calendar to "bank" for the statutory banking calendar (銀行法施行令第5条), which is also closed 31 December to 3 January — relevant for payment due dates.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
toNoEnd date, YYYY-MM-DD. For count and list.
dateNoThe date, YYYY-MM-DD. For shift and check.
daysNoBusiness days to move; negative goes back. For shift.
fromNoStart date, YYYY-MM-DD. For count and list.
yearNoYear. For list.
calendarNoDefaults to standard.
operationYescount = business days between two dates; shift = move a date by N business days; check = classify one date; list = holidays in a year or range.

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. First observed

TDQS

A3.9/5.0
Behavior4/5

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

With no annotations provided, the description carries the full disclosure burden, and it does substantive work: it reveals handling of substitute holidays, 国民の休日, one-off imperial events, and the bank calendar's Dec 31-Jan 3 closure — behaviors un-inferable from the schema. It stops short of disclosing return shapes or out-of-range behavior, which keeps it from a 5.

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?

Two dense paragraphs with the core operations front-loaded; the later sentences justify edge-case coverage and the calendar default rather than repeating schema content. Each sentence earns its place, though the rhetorical 'awkward years' clause is slightly expansive.

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

Completeness3/5

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

For a four-operation tool with no output schema and no annotations, the description leaves the return side unspecified — what 'check' classifies a date as, what 'list' emits, and how count/shift results are shaped. The 'list' operation is absent from the prose entirely. Inputs are well covered, but the output side and per-operation behavior have clear gaps.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, and the description need only add value beyond the schema. It does so for the least obvious parameter, 'calendar', explaining what 'bank' means (statutory calendar plus year-end closure) beyond the schema's bare 'Defaults to standard.' This is meaningful added semantics for exactly the parameter an agent would be unsure about.

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

Purpose4/5

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

The first sentence names the resource (business days) with three specific verbs (count, shift, check), and the coverage statement (1955-2027) plus the calendar distinction pins down the tool's scope precisely. The prose omits the fourth operation 'list' (which appears only in the schema enum), a small completeness gap. No sibling tool performs date arithmetic, so differentiation is not a concern.

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

Usage Guidelines4/5

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

The description gives concrete guidance for the main mode-selection decision: when to set calendar='bank', with a legal reference (銀行法施行令第5条) and a practical use case ('relevant for payment due dates'). It sets expectations about the covered year range (1955-2027), which implicitly bounds applicability. No sibling tools are named, but the sibling set is entirely monetary/payroll calculations, so there are no real alternatives to route between.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A3.8/5.0
Disambiguation4/5

Most tools have distinct, well-defined jobs—payroll calculations, revision judgments, eligibility checks, and data lookups are clearly separated. The main remaining risk is among the standard-remuneration judgment tools and the batch/singleton pairs, but their descriptions are detailed enough to prevent serious misselection.

Naming Consistency3/5

There is a reasonably recognizable pattern with calculate_, judge_, check_, get_, and validate_ groups. However, several noun-phrase names (business_days, consumption_tax, national_insurance, commuting_allowance_exemption) and overlapping verb choices (decide_ vs judge_ vs check_) prevent a fully consistent verb_noun convention.

Tool Count2/5

At 30 tools, the surface is materially larger than the 3–15 range that keeps an agent's selection burden low. Batch variants and three separate standard-remuneration revision tools add complexity, and although the domain is broad, the count feels heavy for an assistant to choose from confidently.

Completeness4/5

The core workflows are well covered: monthly pay, bonuses, overtime, standard-remuneration determination, year-end adjustment, resident tax, leave, worker classification, and invoice validation. Gaps exist around statutory benefit payments such as sickness or maternity allowances and retirement-specific processing, but most payroll and social insurance tasks can be completed without dead ends.