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

korean-tax-calc-mcp

tunnelling_gift

Read-onlyIdempotent

Calculate deemed gift profit from intra-group business transfers using a simplified formula with sales, ownership, family, and fiscal-year inputs. Use it for preliminary Korean gift tax review.

Instructions

Gift tax: deemed gift profit from intra-group business transfer, simplified formula (일감몰아주기 증여의제이익). 일감몰아주기 증여의제이익(상증법 제45조의3, 제10항 과세제외매출액 직접 입력, 제14항·제15항 미반영). 언제: 일감몰아주기 검토에서 증여의제이익을 간단히 계산할 때(국세청 신고안내 전체 산식은 tunnelling_gift_nts 사용). 입력: 수혜자(이름) → beneficiary, 기업 규모(중소|중견|일반) → size, 총 매출액 → sales_total, sales_by_corp={거래처 법인: 매출액} → sales_by_corp, 세후영업이익 → after_tax_op_profit, people={이름: {구분: "개인"|"법인"}} → people, family=[[a, b, "부모자녀"|"배우자"]] → family, stakes=[[보유자, 법인, 지분율(01)]] → stakes, 제10항·제14항 과세제외매출액 → excluded_sales. 사업연도: 수혜법인 사업연도 종료일 → fiscal_year_end(개시일 → fiscal_year_start). 2017.12.31. 이전 종료분은 종전 계산식(일반: 정상거래비율의 1/2인 15% 초과 거래비율 × 3% 초과 보유비율, 중소·중견: 정상거래비율 초과 × 10% 초과), 중견 정상거래비율은 2017년 개시 사업연도부터 40%(그 전 50%). 2018.1.1. 이후 종료분은 현행식. 친족 범위는 2023.2.28.까지 6촌 혈족·4촌 인척. 20162026 종료 사업연도만 지원. 결과: 증여의제이익, 근거(상증법 제45조의3, 시행령 제34조의3 — 2020.2.10.까지는 제34조의2). 일감몰아주기 증여의제이익(상증법 제45조의3).

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": {
      "beneficiary": "<beneficiary>",
      "size": "<size>",
      "sales_total": "<sales_total>",
      "sales_by_corp": "<sales_by_corp>",
      "after_tax_op_profit": "<after_tax_op_profit>",
      "people": "<people>",
      "family": "<family>",
      "stakes": "<stakes>"
    },
    "name": "tunnelling_gift"
  }
}

Input Schema

NameRequiredDescriptionDefault
sizeYes기업 규모('중소'|'중견'|'일반')
familyYes친족 관계 [[a, b, "부모자녀"|"배우자"]]
peopleYes사람·법인 목록 {이름: {"구분": "개인"|"법인"}}
stakesYes직접보유비율 [[보유자, 법인, 지분율(0~1)]]
beneficiaryYes수혜자(이름)
sales_totalYes총 매출액(원)
sales_by_corpYes거래처 법인별 매출액 {법인: 매출액(원)}. 예: {"A": 300000000}
excluded_salesNo제10항·제14항 과세제외매출액(원)
fiscal_year_endNo수혜법인 사업연도 종료일(YYYY-MM-DD, 증여시기). 비율·계산식이 사업연도마다 다름 — 2017.12.31. 이전 종료분은 종전 계산식. 생략하면 2018.1.1. 이후 종료 사업연도 규정으로 계산하고 주의에 표시
fiscal_year_startNo사업연도 개시일(YYYY-MM-DD, 선택). 중견기업 정상거래비율 40%는 2017년 개시 사업연도부터 — 생략하면 종료일 1년 전 다음 날
after_tax_op_profitYes세후영업이익(원)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.37.0
    • addedInput schema / properties / fiscal_year_end
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "수혜법인 사업연도 종료일(YYYY-MM-DD, 증여시기). 비율·계산식이 사업연도마다 다름 — 2017.12.31. 이전 종료분은 종전 계산식. 생략하면 2018.1.1. 이후 종료 사업연도 규정으로 계산하고 주의에 표시",
      +  "title": "Fiscal Year End"
      +}
    • addedInput schema / properties / fiscal_year_start
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "사업연도 개시일(YYYY-MM-DD, 선택). 중견기업 정상거래비율 40%는 2017년 개시 사업연도부터 — 생략하면 종료일 1년 전 다음 날",
      +  "title": "Fiscal Year Start"
      +}
  2. Changed1 schema field changedv0.21.0
    • changedInput schema / properties / excluded_sales / description
      Previous value: -"⑩·⑭항 과세제외매출액(원)"New value: +"제10항·제14항 과세제외매출액(원)"
  3. First observedv0.9.1

TDQS

A4.7/5.0
Behavior5/5

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

Annotations already establish this as a safe, idempotent, closed-world read-only computation, and the description adds substantive behavior beyond them: which statute paragraphs are omitted (제14항·제15항 미반영), what the tool does when fiscal_year_end is omitted (falls back to post-2018 rules and flags a warning), the historical formula/threshold changes, the legal citation change at 2020.2.10., and the output contents. This is exactly the extra context the annotations cannot carry.

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?

The text is dense but clearly front-loaded and organized with 언제/입력/사업연도/결과 labels, fitting a parameter-heavy tax tool. There is some waste: the term 일감몰아주기 증여의제이익 and the statutory citation are repeated in the opening line and the closing sentence, and the 제10항 exclusions are mentioned twice.

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 an 11-parameter tool with no output schema, the definition covers inputs, default behavior, historical variants, supported year range, and what the result contains (증여의제이익 plus legal basis). It does not spell out the actual simplified formula or how the deemed profit is apportioned across beneficiaries, which leaves some interpretive burden on the agent.

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 description coverage is 100%, so the schema already defines every parameter, including the 0–1 stake ratio and excluded_sales. The description's '입력' line largely restates that mapping, but it does add rule-level meaning for the date parameters (the 中堅 normal-transaction ratio applying from fiscal years beginning in 2017, default start date derived from the end date), which is not fully captured by the schema alone.

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

Purpose5/5

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

The description states a specific verb and resource ('deemed gift profit from intra-group business transfer, simplified formula') and pins it to the relevant statute (상증법 제45조의3). It also positions the tool against its sibling by name, noting the full NTS formula belongs to tunnelling_gift_nts, so an agent can distinguish the two without inspecting schemas.

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

Usage Guidelines5/5

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

The '언제' section gives an explicit trigger ('간단히 계산할 때' for a 일감몰아주기 review) and an explicit alternative with the condition that selects it (국세청 신고안내 전체 산식 → tunnelling_gift_nts). Scope limits are also stated: only fiscal years 2016–2026 are supported.

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