Skip to main content
Glama
korean-tax-calc-mcp

korean-tax-calc-mcp

donation_limit

Read-onlyIdempotent

Calculate corporate donation deduction limits (special 50%, general 10%), excess amounts, and carryforwards to determine how much of a donation is deductible for Korean corporate tax.

Instructions

Corporate donation limit (special 50%, general 10%), excess and carryforward (기부금 한도). 기부금 손금산입 한도(특례기부금 50%, 일반기부금 10%)와 한도초과·이월. 언제: 기부금을 손금산입할 때 한도와 한도초과액을 구한다. 입력: 기준소득(과세표준 계산 전 소득금액, 원) → base_income, 특례기부금 지출액(원) → special, 일반기부금 지출액(원) → general, 결손금(원) → carried_loss, 특례 이월액(원) → special_carry, 일반 이월액(원) → general_carry, 중소기업 여부 → sme, 사회적기업 여부 → social_enterprise, 사업연도(2016~2026, 개시일이 속하는 해) → year, 사업연도 개시일·종료일 → fy_start·fy_end, 신고일 → filing_date(선택). 기준일: 이월분 먼저 공제(제24조제6항)는 2020.1.1. 이후 과세표준 신고분(법률 제16833호 부칙 제4조), 사회적기업 20%는 2019.1.1. 이후 신고분(법률 제16008호 부칙 제4조제1항), 30%는 2026.1.1. 이후 개시 사업연도 지출분(법률 제21217호 부칙 제3조), 결손금 차감 한도는 2021.1.1. 이후 개시 사업연도 지출분(법률 제17652호 부칙 제6조). 신고일은 filing_date, 없으면 fy_end(없으면 역년 종료일)의 신고기한으로 봄. 날짜를 주지 않고 경계 연도면 주의를 붙임. 결과: 한도·한도초과·이월 손금산입, 근거(법인세법 제24조).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "year": "<year>",
      "base_income": "<base_income>"
    },
    "name": "donation_limit"
  }
}

Input Schema

NameRequiredDescriptionDefault
smeNo중소기업 여부
yearYes사업연도·귀속연도(2016~2026)
fy_endNo사업연도 종료일 YYYY-MM-DD(선택) — 신고기한(종료일이 속하는 달의 말일부터 3개월) 추정과 지출분 부칙 판정에 씀
generalNo금액(원)
specialNo금액(원)
fy_startNo사업연도 개시일 YYYY-MM-DD(선택, year 안의 날짜) — 사업연도가 역년과 다를 때. fy_end만 주면 1년 사업연도로 봄
base_incomeYes금액(원)
filing_dateNo과세표준 신고일 YYYY-MM-DD(선택) — '과세표준을 신고하는 경우부터' 적용하는 부칙 판정. 없으면 fy_end 기준 신고기한에 신고한 것으로 봄. 기한후·수정신고일을 넣으면 그 날짜로 고르되, 법정신고기한과 신고일이 서로 다른 부칙 구간에 걸치면 신고기한 기준 결과를 '신고기한기준_결과'에 함께 보여줌(어느 쪽인지 정한 해석이 없음 — 주의에 검색 기록)
carried_lossNo금액(원)
general_carryNo금액(원)
special_carryNo금액(원)
social_enterpriseNo사회적기업 여부 — 일반한도율: 2019.1.1. 이후 신고분 20%(법률 제16008호 부칙 제4조제1항, 역년이면 2018 사업연도부터), 2026.1.1. 이후 개시 사업연도 30%, 그 전 10%

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.57.1
    • changedInput schema / properties / filing_date / description
      Previous value: -"과세표준 신고일 YYYY-MM-DD(선택) — '과세표준을 신고하는 경우부터' 적용하는 부칙 판정. 없으면 fy_end 기준 신고기한에 신고한 것으로 봄. 기한후·수정신고가 이 부칙의 신고에 들어가는지는 판단하지 않음"New value: +"과세표준 신고일 YYYY-MM-DD(선택) — '과세표준을 신고하는 경우부터' 적용하는 부칙 판정. 없으면 fy_end 기준 신고기한에 신고한 것으로 봄. 기한후·수정신고일을 넣으면 그 날짜로 고르되, 법정신고기한과 신고일이 서로 다른 부칙 구간에 걸치면 신고기한 기준 결과를 '신고기한기준_결과'에 함께 보여줌(어느 쪽인지 정한 해석이 없음 — 주의에 검색 기록)"
  2. Changed4 schema fields changedv0.51.0
    • addedInput schema / properties / filing_date
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "과세표준 신고일 YYYY-MM-DD(선택) — '과세표준을 신고하는 경우부터' 적용하는 부칙 판정. 없으면 fy_end 기준 신고기한에 신고한 것으로 봄. 기한후·수정신고가 이 부칙의 신고에 들어가는지는 판단하지 않음",
      +  "title": "Filing Date"
      +}
    • addedInput schema / properties / fy_end
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "사업연도 종료일 YYYY-MM-DD(선택) — 신고기한(종료일이 속하는 달의 말일부터 3개월) 추정과 지출분 부칙 판정에 씀",
      +  "title": "Fy End"
      +}
    • addedInput schema / properties / fy_start
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "사업연도 개시일 YYYY-MM-DD(선택, year 안의 날짜) — 사업연도가 역년과 다를 때. fy_end만 주면 1년 사업연도로 봄",
      +  "title": "Fy Start"
      +}
    • changedInput schema / properties / social_enterprise / description
      Previous value: -"사회적기업 여부 — 일반한도율을 연도별 적용: 2017 이전 10%, 2018~2025 사업연도 20%, 2026 사업연도부터 30%"New value: +"사회적기업 여부 — 일반한도율: 2019.1.1. 이후 신고분 20%(법률 제16008호 부칙 제4조제1항, 역년이면 2018 사업연도부터), 2026.1.1. 이후 개시 사업연도 30%, 그 전 10%"
  3. Changed1 schema field changedv0.37.0
    • changedInput schema / properties / social_enterprise / description
      Previous value: -"사회적기업 여부(일반한도 20% 적용)"New value: +"사회적기업 여부 — 일반한도율을 연도별 적용: 2017 이전 10%, 2018~2025 사업연도 20%, 2026 사업연도부터 30%"
  4. First observedv0.9.1

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already cover the read-only, idempotent, non-destructive profile, yet the description adds real behavioral context: which statutory amendment applies to which fiscal year, the filing_date fallback to fy_end/calendar-year end, and a flag when a boundary year lacks dates. It also states the return contents (limit, excess, carryforward, legal basis).

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

Conciseness3/5

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

Purpose is front-loaded, but the same content is duplicated across English and Korean, and the effective-date sentence is a long comma-chained clause that is hard to scan. The input enumeration is useful but could be tightened.

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 12-parameter, output-schema-less computation tool, the definition supplies inputs, effective-date rules, fallback behavior for optional dates, and an outline of the result and legal basis. Only the exact output field names (e.g. the 신고기한기준_결과 field) are left undeclared.

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?

Although schema coverage is 100%, the description adds meaning beyond the schema by glossing base_income as income before taxable-base computation and mapping each Korean input label to its parameter name, including the effective-date logic tied to year/filing_date.

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 line names the specific resource and computation: corporate donation deduction limit (special 50%, general 10%) plus excess and carryforward. This is enough to distinguish it from the individual-oriented sibling, but the routing contrast (e.g. individual_donation_expense) is never stated 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?

The '언제' clause gives a clear trigger: when computing the donation deduction limit and the excess amount for a corporate tax return. No exclusions or named alternatives are provided, so the agent knows when to use it but not when not to.

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