Skip to main content
Glama
smarthr-member-mcp

smarthr-member-mcp

by tunagohan

estimate_income

Calculates estimated annual salary income for year-end adjustment from issued payslips, projecting future months and bonuses so employees can review and adjust figures.

Instructions

年末調整用に、指定した年(省略時は今年)の「給与の収入金額(見込額)」を計算する。

発行済みの明細は実額、最後の給与明細より後の月は最新の給与明細(昇給を反映)と前年同月の賞与で推計する。 rows の estimated=true が推計分。賞与額の変更などが分かっていれば rows を見て補正すること。

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "estimate_income"
  }
}

Input Schema

NameRequiredDescriptionDefault
yearNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

A4.1/5.0
Behavior4/5

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

With no annotations, the description carries the full disclosure burden and does well: it explains the estimation method (actual amounts for issued payslips, latest-payslip-plus-prior-year-bonus for later months, raises reflected) and identifies the estimated=true flag in rows. It falls short of describing the complete return structure or any data-access/permission characteristics.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences, front-loaded with purpose and year default, followed by method and then the corrective action. No filler; every sentence contributes information the agent needs.

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?

For a one-parameter estimation tool with no output schema and no annotations, the description covers purpose, method, the estimated flag, and a correction workflow. The exact shape of the returned rows (fields beyond estimated) is left unspecified, which is a modest gap.

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 0%, but the description compensates by explaining that year selects the target calendar year and defaults to the current year when omitted — meaning the schema's null default does not convey on its own. Only one parameter exists, so this is close to full coverage.

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 description names a specific verb (計算する / calculate) and a specific resource (給与の収入金額(見込額), the estimated salary income amount) scoped to 年末調整 for a given year. This is clearly distinct from merely listing payslips, though it never names the sibling tool explicitly.

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?

It states the scenario the tool serves (year-end tax adjustment for a specified or current year) and gives follow-up guidance: if bonus changes are known, inspect rows and correct. It does not state when NOT to use it or point to list_payslips for actual figures, so the routing guidance is implicit rather than explicit.

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

Deploy Server

Other Tools