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

korean-tax-calc-mcp

thin_capitalization

Read-onlyIdempotent

Computes non-deductible interest on excess debt owed to foreign controlling shareholders, allocating disallowed interest by loan and recalculating withholding tax with statutory citations.

Instructions

Thin capitalization: non-deductible interest on excess debt from foreign controlling shareholders (과소자본). 과소자본 손금불산입(국제조세조정에 관한 법률 제22조, 2020 사업연도까지 제14조). 언제: 국외지배주주로부터 차입한 금액이 출자금액의 기준 배수(기본 2배, 금융업 6배)를 초과할 때 초과분 지급이자를 손금불산입한다. 직접 차입·지급보증 차입이 섞여 있거나 이자율이 다른 차입금이 여럿이면 loans로 차입금별로 넣는다. 입력: 국외지배주주 출자금액(원) → equity, 차입금액(원) → borrowings, 지급이자 총액(원) → total_interest, 적용 배수(기본 2) → ratio, 사업연도(20162026) → year, 수취인 거주지국 → recipient_residence_country, 이자 조세조약 제한세율(소수) → interest_treaty_rate, 배당 조세조약 제한세율(소수) → dividend_treaty_rate, 수취인 구분(개인/법인) → recipient_type, 차입금별 목록 → loans(이때 borrowings·total_interest 생략), 연중 일수 → days_in_year. 출자금액(equity): 사업연도 종료일 현재 max(자산 − 부채(충당금 포함, 미지급 법인세 제외), 납입자본금) × 국외지배주주 납입자본금비율(시행령 제47조, 2020년까지 구 시행령 제25조제3항). 사업연도 중 자본이 변동했으면 나누어 계산한 적수 ÷ 연중 일수를 넣는다. loans 없이: 손금불산입 이자 = 지급이자 × 초과차입금 ÷ 총차입금(평균 이자율), 처분은 전부 배당으로 봄(종전 계산). loans로: 초과차입금적수 = 차입금 적수 합계 − 출자금액 적수 × 배수를 이자율 높은 차입금부터(같은 이자율이면 차입일이 늦은 것부터, 2021년부터는 이자율·차입일이 모두 같으면 적수 비율 안분) 채우고 차입금별 손금불산입 이자 = 배정 적수 × 이자율 ÷ 연중 일수(시행령 제48조, 시행규칙 별지 제24호서식(갑); 2020년까지 구 시행령 제25조제1항). 처분은 직접 차입분 배당, 특수관계인·지급보증 차입분 기타사외유출(시행령 제49조, 2020년까지 구 시행령 제25조제6항). 세무조정 항목을 함께 돌려줌(income_adjustment_total에 그대로). 결과: 초과차입금·손금불산입 이자·처분(배당/기타사외유출), loans를 넣으면 차입금별 배정·배당/기타사외유출 처분액·세무조정, recipient_residence_country 지정 시 배당 처분액의 원천징수 재계산(수취인 법인이면 '법인세 차액', 개인이면 '소득세 차액'), 근거(그해 조문 — 2021년부터 국제조세조정에 관한 법률 제22조·시행령 제46조제50조, 2020년까지 전부개정 전 제14조·시행령 제24조~제26조). 다루지 않음: 소득 대비 과다이자(제24조) 금액, 정상 차입조건 증명(제22조제4항)에 따른 제외. Thin capitalization disallowance.

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": {
      "equity": "<equity>"
    },
    "name": "thin_capitalization"
  }
}

Input Schema

NameRequiredDescriptionDefault
yearNo사업연도·귀속연도(2016~2026)
loansNo차입금별 목록(선택) [{name?, kind: '직접'(국외지배주주 차입)|'특수관계인'(국외지배주주의 특수관계인 차입)|'보증'(국외지배주주 지급보증 제3자 차입), rate: 연 이자율(소수), jeoksu(차입금 적수, 원·일) | average_balance(적수 ÷ 연중 일수) | balance(잔액 — 변동 없다고 보고 계산) 중 하나, borrowed_on?: 차입일 YYYY-MM-DD(같은 이자율이면 필수), interest?: 지급이자(대조용)}]. 넣으면 이자율 높은 차입금부터 초과분에 배정하고 직접분 배당·나머지 기타사외유출로 나눔
ratioNo적용 배수(기본적으로 2, 금융업 등 업종 배수는 별도 확인)
equityYes금액(원)
borrowingsNo국외지배주주등 차입금 합계(원). loans를 넣으면 생략(넣으면 loans 평균잔액 합계와 대조)
days_in_yearNo연중 일수(선택, loans 계산용). 생략 시 역년 사업연도로 보고 365일(윤년 366일)
recipient_typeNo수취인 구분 — 개인(비거주자) / 법인(외국법인)개인
total_interestNo그 차입금의 지급이자 총액(원). loans를 넣으면 생략(넣으면 loans의 interest 합계와 대조)
dividend_treaty_rateNo배당 조세조약 제한세율(소수, 예: 0.15 = 15%). 생략 시 국내세율 적용
interest_treaty_rateNo이자 조세조약 제한세율(소수, 예: 0.12 = 12%). 생략 시 국내세율 적용
recipient_residence_countryNo수취인 거주지국(ISO 2자 코드 또는 국명). 지정 시 배당 처분에 따른 원천징수 재계산 제공

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed14 schema fields changedv0.67.0
    • addedInput schema / $defs
      Added value: +{
      +  "ThinCapLoan": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "average_balance": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Average Balance"
      +      },
      +      "balance": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Balance"
      +      },
      +      "borrowed_on": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Borrowed On"
      +      },
      +      "interest": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Interest"
      +      },
      +      "jeoksu": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Jeoksu"
      +      },
      +      "kind": {
      +        "title": "Kind",
      +        "type": "string"
      +      },
      +      "name": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null,
      +        "title": "Name"
      +      },
      +      "rate": {
      +        "title": "Rate",
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "rate"
      +    ],
      +    "title": "ThinCapLoan",
      +    "type": "object"
      +  }
      +}
    • addedInput schema / properties / borrowings / anyOf
      Added value: +[
      +  {
      +    "minimum": 0,
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / borrowings / default
      Added value: +null
    • changedInput schema / properties / borrowings / description
      Previous value: -"금액(원)"New value: +"국외지배주주등 차입금 합계(원). loans를 넣으면 생략(넣으면 loans 평균잔액 합계와 대조)"
    • removedInput schema / properties / borrowings / minimum
      Removed value: -0
    • removedInput schema / properties / borrowings / type
      Removed value: -"integer"
    • addedInput schema / properties / days_in_year
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maximum": 366,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "연중 일수(선택, loans 계산용). 생략 시 역년 사업연도로 보고 365일(윤년 366일)",
      +  "title": "Days In Year"
      +}
    • addedInput schema / properties / loans
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "$ref": "#/$defs/ThinCapLoan"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "차입금별 목록(선택) [{name?, kind: '직접'(국외지배주주 차입)|'특수관계인'(국외지배주주의 특수관계인 차입)|'보증'(국외지배주주 지급보증 제3자 차입), rate: 연 이자율(소수), jeoksu(차입금 적수, 원·일) | average_balance(적수 ÷ 연중 일수) | balance(잔액 — 변동 없다고 보고 계산) 중 하나, borrowed_on?: 차입일 YYYY-MM-DD(같은 이자율이면 필수), interest?: 지급이자(대조용)}]. 넣으면 이자율 높은 차입금부터 초과분에 배정하고 직접분 배당·나머지 기타사외유출로 나눔",
      +  "title": "Loans"
      +}
    • addedInput schema / properties / total_interest / anyOf
      Added value: +[
      +  {
      +    "minimum": 0,
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / total_interest / default
      Added value: +null
    • changedInput schema / properties / total_interest / description
      Previous value: -"금액(원)"New value: +"그 차입금의 지급이자 총액(원). loans를 넣으면 생략(넣으면 loans의 interest 합계와 대조)"
    • removedInput schema / properties / total_interest / minimum
      Removed value: -0
    • removedInput schema / properties / total_interest / type
      Removed value: -"integer"
    • changedInput schema / required
      Previous value: -[
      -  "equity",
      -  "borrowings",
      -  "total_interest"
      -]New value: +[
      +  "equity"
      +]
  2. 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 only declare it as a read-only, idempotent calculation, but the description adds substantive behavior beyond that: the result fields returned (excess debt, disallowed interest, 배당 vs 기타사외유출 disposition, per-loan allocation, income_adjustment_total, withholding re-computation as 법인세 차액 or 소득세 차액) and the year-dependent legal regime switch at 2020/2021. No contradiction with the read-only, non-destructive annotations.

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?

It is well-sectioned (purpose / 언제 / 입력 / method / 결과 / 다루지 않음) and front-loads the purpose, but the '입력:' paragraph duplicates the near-identical Korean parameter descriptions already present in the schema, and the trailing English restatement 'Thin capitalization disallowance.' adds nothing. Dense but not wasteful in the methodology sections.

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

Completeness5/5

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

With 11 parameters, no output schema, and no nested-object guidance beyond the schema, the description supplies the missing pieces: both calculation algorithms, the disposition split by loan kind, the return-field list, and the version-specific statutory basis. Nothing needed to invoke or interpret the result is absent.

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 100%, so the schema already carries baseline meaning, yet the description adds real semantics: how equity is derived (max(assets − liabilities, paid-in capital) × foreign shareholder ratio, averaged over the year) and the 적수 ÷ 연중 일수 averaging convention for loans. The '입력:' mapping list largely restates schema descriptions, which limits it to a 4.

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 opening line names the exact computation (non-deductible interest on excess debt from foreign controlling shareholders, 과소자본) and the closing '다루지 않음' section explicitly excludes the sibling-adjacent topics (제24조 excess-interest limit, 제22조제4항 arm's-length proof). An agent can distinguish this from deemed_interest/arm_length_range without inspecting any schema.

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?

'언제:' states the trigger condition precisely (borrowings from foreign controlling shareholders exceed the 2x/6x multiple of equity). It also gives a routing rule between the two input modes: if direct loans and guaranteed loans are mixed or rates differ, use loans; otherwise use borrowings + total_interest. Exclusions are stated explicitly.

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