Tools
Everything Date Calculator exposes to your AI client: tools, resources and prompts.
Tool docs quality: B — 4 tools graded
Average 79/100 for how clearly each description tells an AI client what the tool does, what it needs, and what it changes. It is not a security audit.
- Grade A: 2
- Grade B: 1
- Grade C: 1
- Grade D: 0
- Grade F: 0
count_daystoolCount days between two dates, optionally excluding selected weekdays and public holidays.
Description quality grade A, 90/100 · 1 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: passed20/20
The description mentions what the tool takes.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
get_holidaystoolList public holidays, including observed dates, for a country and optional region, for up to 11 years per request.
Description quality grade A, 90/100 · 1 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: passed20/20
The description mentions what the tool takes.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
list_locationstoolFind supported countries, regions and available years.
Description quality grade C, 60/100 · 3 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
shift_datetoolAdd or subtract years, months, weeks and days, with optional weekday and holiday exclusions.
Description quality grade B, 75/100 · 2 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: passed20/20
The description mentions what the tool takes.
- Explains side effects: not passed0/15
This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.