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

korean-tax-calc-mcp

entertainment_adjustment

Read-onlyIdempotent

Calculate non-deductible Korean corporate tax entertainment expenses by item, including pre-2024 fiscal years, and return tax adjustment and income disposition results.

Instructions

Entertainment expense tax adjustment for corporate tax, incl. pre-2024 years (기업업무추진비 세무조정). 기업업무추진비 세무조정 — 2023년 이전 사업연도의 "접대비"와 같은 항목(2024.1.1. 명칭 변경, 법률 19193). 접대비 문제·장부도 이 도구로 계산한다(법인세법 제25조, 시행령 제40조·제41조·제42조). 언제: 법인세 신고에서 기업업무추진비 손금불산입을 항목별로 계산할 때. 입력: · 사업연도(20162026) → year, 중소기업 여부 → sme, 사업연도 월수(112, 기본 12) → months, 현물 평가 시 부가가치세 포함 여부(기본 True) → include_vat. · 사업연도 개시일·종료일 → fy_start·fy_end, 과세표준 신고일 → filing_date(선택 — 사업연도가 역년과 다르거나 신고일 기준 부칙을 정확히 고를 때). · 원장: ledger=[{항목, 금액, 증빙:'없음'|'영수증 등'|'적격'(기본 '적격'), 성격?:'교제목적'|'직원단체_법인'|'직원단체_비법인'|'임직원부담'|'현물'|'경조금'|'문화', 시가?, 장부가액?, 건당기준초과?:(기본 true), 지출일?:YYYY-MM-DD}], 지출일을 주면 적격증빙 기준금액(영 제41조제1항)을 그날로 고름(2021.1.1. 이후 지출분부터 상향, 대통령령 제31443호 부칙 제9조). revenue={매출액, 특수관계매출?(기본 0), 매출할인등:{일반?, 특수관계?}(기본 0)}. 증빙 허용값(어휘 기반): · 없음 — 지출 증빙이 전혀 없는 건(손금불산입·상여, 귀속 대표자) · 영수증 등 — 영수증 등은 있으나 적격증명서류가 아닌 건(건당 기준 초과 시 손금불산입·기타사외유출) · 적격 — 적격증명서류(세금계산서·계산서·신용카드·현금영수증) 수취 건(한도 시부인 대상) 성격 판단(어휘 기업업무추진비_포함항목.판단.성격별): · 없음·교제목적 → 포함(법 제25조제1항) / 직원단체_법인 → 포함(영 제40조제2항) / 직원단체_비법인 → 제외(복리후생비) · 임직원부담 → 제외(영 제40조제1항) / 현물 → 포함(max(시가, 장부가액) + 부가세, include_vat 기본 True, 영 제42조제6항·법 제36조제1항제3호) / 경조금·문화·전통시장 → 기존과 동일 · 사적사용 → 시부인 대상 제외, 직접 손금불산입(상여, 법인세법 제19조제2항·시행령 제40조제1항) · 전통시장 → 포함(「전통시장 및 상점가 육성을 위한 특별법」상 전통시장에서 쓴 적격 기업업무추진비, 조특법 제136조제6항, 전통시장등 추가한도 대상) · 지역사랑상품권 → 포함(지역사랑상품권으로 지급한 적격 기업업무추진비, 조특법 제136조제6항, 2026.1.1. 이후 신고분부터 전통시장등 추가한도 대상 — 법률 제21223호 부칙 제31조) · 온누리상품권 → 포함(온누리상품권으로 지급한 적격 기업업무추진비, 조특법 제136조제6항, 2026.5.12.이 속하는 사업연도 지출분부터 전통시장등 추가한도 대상 — 법률 제21612호 부칙 제4조) 기준일: 전통시장등 비율은 신고일로 고름 — 2024.1.1. 이후 신고분 10%(전통시장), 2026.1.1. 이후 신고분 20%(+지역사랑상품권). 날짜를 주지 않으면 사업연도 표(역년 가정)로 고르고 경계 연도면 주의를 붙임. 2020 수입금액 특례는 2020년이 두 사업연도에 걸치면 일할(조특법 제136조제5항). · 원장 합계: ledger_total(원장·계정 합계)을 주면 ledger 금액 합계와 대조. ledger는 원장 행을 직접 더해 한 줄로 합치지 말고 행마다 넣는다. 결과: 판단(항목별·근거)·결과(한도·한도초과)·세무조정(구분·금액·소득처분)·소득처분별_합계·손금불산입_합계·계산(원장 합계 대조 포함). 기업업무추진비 세액공제.

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>",
      "sme": "<sme>",
      "ledger": "<ledger>"
    },
    "name": "entertainment_adjustment"
  }
}

Input Schema

NameRequiredDescriptionDefault
smeYes중소기업 여부
yearYes사업연도·귀속연도(2016~2026)
fy_endNo사업연도 종료일 YYYY-MM-DD(선택) — 신고기한(종료일이 속하는 달의 말일부터 3개월) 추정과 지출분 부칙 판정에 씀
ledgerYes원장형 입력 [{항목, 금액, 증빙:'없음'|'영수증 등'|'적격'(기본 '적격'), 성격?:'교제목적'|'직원단체_법인'|'직원단체_비법인'|'임직원부담'|'현물'|'경조금'|'문화'|'사적사용', 시가?, 장부가액?, 건당기준초과?}] — 성격별 포함·제외는 어휘 기업업무추진비_포함항목으로 판단. '사적사용'은 시부인 대상 제외, 직접 손금불산입(상여
monthsNo사업연도 월수(1~12)
revenueNo수입금액 원장형 입력 {매출액, 특수관계매출?(기본 0), 매출할인등:{일반?, 특수관계?}(기본 0)} — 기업회계기준 매출액 기준(영 제42조제1항). 없으면 수입금액 0
fy_startNo사업연도 개시일 YYYY-MM-DD(선택, year 안의 날짜) — 사업연도가 역년과 다를 때. fy_end만 주면 1년 사업연도로 봄
filing_dateNo과세표준 신고일 YYYY-MM-DD(선택) — '과세표준을 신고하는 경우부터' 적용하는 부칙 판정. 없으면 fy_end 기준 신고기한에 신고한 것으로 봄. 기한후·수정신고일을 넣으면 그 날짜로 고르되, 법정신고기한과 신고일이 서로 다른 부칙 구간에 걸치면 신고기한 기준 결과를 '신고기한기준_결과'에 함께 보여줌(어느 쪽인지 정한 해석이 없음 — 주의에 검색 기록)
include_vatNo현물 접대비 평가 시 부가가치세 포함 여부(기본 True — 사업상 증여는 매출세액 포함, 영 제42조제6항·법 제36조제1항제3호 준용)
ledger_totalNo원장(계정) 합계(원) — 주면 ledger 금액 합계와 대조해 다르면 '확인 필요' 판단을 붙임(행을 옮기다 빠지거나 더하다 틀린 경우). ledger는 원장 행을 합치지 말고 한 줄씩 넣는다

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. Changed3 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"
      +}
  3. Changed1 schema field changedv0.37.0
    • addedInput schema / properties / ledger_total
      Added value: +{
      +  "anyOf": [
      +    {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "원장(계정) 합계(원) — 주면 ledger 금액 합계와 대조해 다르면 '확인 필요' 판단을 붙임(행을 옮기다 빠지거나 더하다 틀린 경우). ledger는 원장 행을 합치지 말고 한 줄씩 넣는다",
      +  "title": "Ledger Total"
      +}
  4. Changed2 schema fields changedv0.21.0
    • changedInput schema / properties / include_vat / description
      Previous value: -"현물 접대비 평가 시 부가가치세 포함 여부(기본 True — 사업상 증여는 매출세액 포함, 영 제42조⑥·법 제36조①3호 준용)"New value: +"현물 접대비 평가 시 부가가치세 포함 여부(기본 True — 사업상 증여는 매출세액 포함, 영 제42조제6항·법 제36조제1항제3호 준용)"
    • changedInput schema / properties / revenue / description
      Previous value: -"수입금액 원장형 입력 {매출액, 특수관계매출?(기본 0), 매출할인등:{일반?, 특수관계?}(기본 0)} — 기업회계기준 매출액 기준(영 제42조①). 없으면 수입금액 0"New value: +"수입금액 원장형 입력 {매출액, 특수관계매출?(기본 0), 매출할인등:{일반?, 특수관계?}(기본 0)} — 기업회계기준 매출액 기준(영 제42조제1항). 없으면 수입금액 0"
  5. Changed2 schema fields changedv0.19.1
    • addedInput schema / properties / include_vat
      Added value: +{
      +  "default": true,
      +  "description": "현물 접대비 평가 시 부가가치세 포함 여부(기본 True — 사업상 증여는 매출세액 포함, 영 제42조⑥·법 제36조①3호 준용)",
      +  "title": "Include Vat",
      +  "type": "boolean"
      +}
    • removedInput schema / properties / 부가세별도
      Removed value: -{
      -  "default": true,
      -  "description": "현물 접대비 평가 시 부가가치세 포함 여부(기본 True — 사업상 증여는 매출세액 포함, 영 제42조⑥·법 제36조①3호 준용)",
      -  "title": "부가세별도",
      -  "type": "boolean"
      -}
  6. Changed2 schema fields changedv0.11.0
    • changedInput schema / properties / ledger / description
      Previous value: -"원장형 입력 [{항목, 금액, 증빙:'없음'|'영수증 등'|'적격'(기본 '적격'), 성격?:'교제목적'|'직원단체_법인'|'직원단체_비법인'|'임직원부담'|'현물'|'경조금'|'문화', 시가?, 장부가액?, 건당기준초과?}] — 성격별 포함·제외는 어휘 기업업무추진비_포함항목으로 판단"New value: +"원장형 입력 [{항목, 금액, 증빙:'없음'|'영수증 등'|'적격'(기본 '적격'), 성격?:'교제목적'|'직원단체_법인'|'직원단체_비법인'|'임직원부담'|'현물'|'경조금'|'문화'|'사적사용', 시가?, 장부가액?, 건당기준초과?}] — 성격별 포함·제외는 어휘 기업업무추진비_포함항목으로 판단. '사적사용'은 시부인 대상 제외, 직접 손금불산입(상여"
    • addedInput schema / properties / 부가세별도
      Added value: +{
      +  "default": true,
      +  "description": "현물 접대비 평가 시 부가가치세 포함 여부(기본 True — 사업상 증여는 매출세액 포함, 영 제42조⑥·법 제36조①3호 준용)",
      +  "title": "부가세별도",
      +  "type": "boolean"
      +}
  7. First observedv0.9.1

TDQS

A4.4/5.0
Behavior5/5

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

Annotations already declare read-only, idempotent, non-destructive behavior, and the description adds substantive context beyond them: ledger rows must be entered individually rather than summed, a supplied ledger_total triggers a '확인 필요' reconciliation judgment, and dates silently default to calendar-year assumptions with a warning at boundary years. It also flags an unresolved legal interpretation (신고기한 vs actual filing date) and states that both results are returned in that case.

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?

Content is front-loaded and sectioned (언제 / 입력 / 기준일 / 결과), so an agent can locate what it needs quickly. It is nonetheless dense and citation-heavy, and the allowed 성격 values are split between the 입력 list and the later 성격 판단 section, forcing the reader to merge two lists.

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?

With no output schema, the description does describe the return structure (판단·결과·세무조정·소득처분별_합계·손금불산입_합계·계산), which satisfies the main gap for a 10-parameter computation tool. A minor incompleteness: 성격 values 전통시장, 지역사랑상품권, 온누리상품권, 사적사용 appear only in the judgment section and are missing from the input enumerations given in the description and schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, but the ledger item schema is an empty object, so the description carries the entire record shape and maps each 증빙 value to its tax consequence (손금불산입·상여, 기타사외유출, 한도 시부인). It also supplies the 성격 classification rules with statutory citations, which the schema does not enumerate.

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 states a specific verb and resource — computing entertainment expense (기업업무추진비) tax adjustment for corporate tax, including pre-2024 years and the renamed 접대비 item — so the purpose is unambiguous. It stops short of naming or differentiating the sibling entertainment_limit, even though the described output (한도·한도초과) overlaps with what a limit tool would produce.

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 "언제" line gives an explicit trigger: filing a corporate tax return where entertainment expense must be excluded item by item. There is no when-not guidance and no alternative tool is named, so the agent must infer that overlapping sibling tools are out of scope.

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