Skip to main content
Glama

ベストカレンダー 暦データ

営業日かどうか

check_business_day
Read-only

日付(または 62 日までの期間)が営業日か休みか(理由と祝日名)。1 日だけなら次の営業日・前の営業日も返す。休みの規則は既定で土日祝、定休の曜日・お盆・年末年始・個別の休業日と営業日を指定できる。

Input Schema

NameRequiredDescriptionDefault
endNoYYYY-MM-DD(1926-01-01〜2080-12-31)
dateNoYYYY-MM-DD(1926-01-01〜2080-12-31)
obonNoお盆 8/13〜16 を休む(既定 false)
startNoYYYY-MM-DD(1926-01-01〜2080-12-31)
nenmatsuNo年末年始 12/29〜1/3 を休む(既定 false)
open_datesNo個別の営業日(祝日や定休日でも営業する日)
closed_datesNo個別の休業日
close_holidaysNo祝日(振替休日・国民の休日を含む)を休む(既定 true)
closed_weekdaysNo定休の曜日(既定は ["土", "日"]。空の配列なら曜日では休まない)

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already establish the read-only, closed-world, non-destructive profile, and the description adds real substance on top: what comes back (休み理由 and 祝日名), the extra previous/next business day output for single dates, and the fact that the closure rule set is configurable with a stated default of weekends plus holidays. It does not cover error behavior or input conflicts, but it clears the lower bar set by the annotations.

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?

Three sentences ordered from core output, to the single-day special case, to rule configuration — front-loaded and free of filler. It is dense but every clause carries information; only the rule enumeration in the last sentence borders on restating parameters.

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

Completeness4/5

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

With 9 optional parameters and no output schema, the description does necessary work by naming the returned fields and the next/previous business day output that an agent could not otherwise predict. It is not fully complete: it is silent on what happens if `date` and `start`/`end` are supplied together, and on any error/limit conditions beyond the 62-day cap.

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 coverage is 100% and the schema already documents each date format, per-flag defaults, and the meaning of closed_weekdays/open_dates/closed_dates, so the description largely restates structured data. The one genuine addition is the 62-day maximum span, a constraint that is absent from the schema; the either/or relationship between `date` and `start`/`end` is only hinted at.

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 states a specific operation (business-day vs. holiday determination) with its scope boundary (a single date or a span up to 62 days) and its return semantics (reason and holiday name). An agent can distinguish it from siblings such as list_holidays or find_dates on the basis of this alone, although no sibling is named explicitly.

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

Usage Guidelines3/5

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

It distinguishes the one-day case (which additionally yields previous/next business day) from the range case, which is useful routing context, and states the default rule set. However, it never says when to prefer this tool over list_holidays or count_days, and gives no exclusion conditions; the usage guidance is implied rather than explicit.

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.

Resources