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

korean-tax-calc-mcp

sme_status

Read-onlyIdempotent

Determine whether a company qualifies as a small or medium enterprise for Korean tax rules by tax year, checking industry revenue thresholds, total assets, independence, and grace periods.

Instructions

SME status test: small and medium enterprise, small enterprise, grace period (중소기업 해당 여부). 중소기업·소기업 해당 여부 — 업종별 매출 기준, 자산총액, 독립성, 유예기간으로 세법상 중소기업인지와 소기업·중기업 구분(조세특례제한법 시행령 제2조). 언제: 매출이 빠르게 커진 회사가 창업감면·특별세액감면·결손금 소급공제·최저한세 7% 같은 중소기업 규정을 그 해에도 적용받는지 볼 때. 입력: 과세연도 → year, 업종 기호 → industry_code, 매출액 → revenue, 자산총액 → total_assets, 국내 관계기업 → domestic_affiliates, 독립성 → in_disclosure_group·large_corp_owner, 처음 넘은 해 → first_exceeded_year, 창업일 → founded_on. 계산: 매출액(국내 관계기업 합산 — 50% 이상 소유는 전액, 미만은 소유비율만큼)이 업종별 기준(중소기업기본법 시행령 별표 1) 이내이고 자산총액 5천억원 미만이면 중소기업. 기준을 넘으면 처음 넘은 과세연도와 그 다음 5개 과세연도(2023년까지 처음 넘었으면 3개)는 유예기간. 독립성을 잃거나 창업 후 2년 안에 넘으면 유예 없음. 소기업은 매출액이 별표 3 기준 이내. 2025 과세연도부터 2025.9.1. 개정 기준(예: 화학제품 제조업·도소매 1,200억원, 소기업 120억원·60억원). 2016 과세연도는 2015.6.30. 개정 별표(제9차 분류 기호)와 업종 열거 방식, 2017 과세연도부터 2017.10.17. 개정 별표. 2016.1.1. 전 기준 소기업은 2019 과세연도까지 소기업. 결과: 중소기업(참·거짓), 구분(소기업·중기업·유예기간 중·중소기업 아님), 계산(기준 금액·합산 매출액·유예기간), 판단·근거·주의. 범위 밖: 2015년 이전, 주된 업종 판정, 해외 자회사(합산 대상 아님), 손자기업 간접 지배, 상장법인 유예 7년, 합병에 따른 유예 배제, 1년 미만 과세연도 환산.

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>",
      "industry_code": "<industry_code>",
      "revenue": "<revenue>",
      "total_assets": "<total_assets>"
    },
    "name": "sme_status"
  }
}

Input Schema

NameRequiredDescriptionDefault
yearYes과세연도(2016~2026)
revenueYes해당 과세연도 손익계산서 매출액(원)
founded_onNo창업일 YYYY-MM-DD(선택) — 창업 후 2년 안에 기준을 넘으면 유예기간이 없음
total_assetsYes과세연도 종료일 재무상태표 자산총액(원)
industry_codeYes주된 업종의 한국표준산업분류 기호 — 제조업은 중분류(C10~C34, 화장품·화학제품 C20), 도매 및 소매업 G, 정보통신업 J, 수도업 E36, 임대업 N76 등. 2016 과세연도는 제9차 분류 기호(수도사업 D, 임대업 L)
large_corp_ownerNo자산총액 5천억원 이상 법인이 주식의 30% 이상을 소유한 최다출자자인지
excluded_businessNo부동산임대업 또는 소비성서비스업이 주된 사업인지(2017 과세연도는 소비성서비스업, 2016 과세연도는 시행령 제2조제1항에 열거된 업종이 아닌 사업)
domestic_affiliatesNo관계기업(국내기업만) [{revenue(원), ownership(소유비율 0.3~1)}] — 30% 이상 소유하면서 최다출자자인 지배·종속 관계
first_exceeded_yearNo규모 기준을 처음 넘은 과세연도(이전에 이미 넘었으면). 비우면 해당 과세연도
in_disclosure_groupNo공시대상기업집단 소속(계열 편입 통지 포함) 여부
small_under_pre2016_ruleNo2016.1.1. 전 기준(상시근로자 수)으로 소기업이던 기업이면 true — 2019 과세연도까지 소기업으로 봄(2016~2019 과세연도만)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changedv0.57.1
    • changedInput schema / properties / excluded_business / description
      Previous value: -"부동산임대업 또는 소비성서비스업이 주된 사업인지"New value: +"부동산임대업 또는 소비성서비스업이 주된 사업인지(2017 과세연도는 소비성서비스업, 2016 과세연도는 시행령 제2조제1항에 열거된 업종이 아닌 사업)"
    • changedInput schema / properties / industry_code / description
      Previous value: -"주된 업종의 한국표준산업분류 기호 — 제조업은 중분류(C10~C34, 화장품·화학제품 C20), 도매 및 소매업 G, 정보통신업 J, 수도업 E36, 임대업 N76 등"New value: +"주된 업종의 한국표준산업분류 기호 — 제조업은 중분류(C10~C34, 화장품·화학제품 C20), 도매 및 소매업 G, 정보통신업 J, 수도업 E36, 임대업 N76 등. 2016 과세연도는 제9차 분류 기호(수도사업 D, 임대업 L)"
    • addedInput schema / properties / small_under_pre2016_rule
      Added value: +{
      +  "default": false,
      +  "description": "2016.1.1. 전 기준(상시근로자 수)으로 소기업이던 기업이면 true — 2019 과세연도까지 소기업으로 봄(2016~2019 과세연도만)",
      +  "title": "Small Under Pre2016 Rule",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / year / description
      Previous value: -"과세연도(2018~2026)"New value: +"과세연도(2016~2026)"
  2. Addedv0.37.0

TDQS

A4.4/5.0
Behavior3/5

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

Annotations already establish that this is a pure read-only, idempotent, non-destructive calculation, so the description does not need to re-declare safety. It adds substantial domain behavior beyond the annotations — the threshold test, the 5-year (3-year pre-2023) grace period, loss of grace on independence failure or exceeding within 2 years of founding, and the 2025.9.1 revised thresholds. It does not state output format or failure behavior, but given the annotations the remaining gap is minor.

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?

Despite its density, the text is deliberately structured with labeled sections (언제, 입력, 계산, 결과, 범위 밖) and front-loads the purpose before the rules. The '입력:' mapping largely restates parameter names already in the schema, which is the only clearly redundant block.

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?

For an 11-parameter statutory calculation with no output schema, the description supplies the decision logic, historical rule versions by tax year, the grace-period mechanics, and the enumerated result components (중소기업 여부, 구분, 계산, 판단·근거·주의). An agent can call this correctly without external knowledge.

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 baseline is 3; the description earns a 4 by adding the aggregation rule that domestic affiliate revenue counts fully at 50%+ ownership and pro-rata below that, and by mapping each input to its tax concept. Note a tension: the schema describes affiliates as 30%+ ownership while the description's aggregation cutoff is 50%, which an agent may find ambiguous.

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 names a specific determination ('세법상 중소기업인지와 소기업·중기업 구분') with the governing statute (조세특례제한법 시행령 제2조), which is far more precise than the bare name sme_status. It is clearly distinguishable from the sibling sme_special_tax_reduction because this tool classifies the entity rather than computing a credit.

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?

An explicit '언제:' line gives the triggering scenario (a fast-growing company checking whether SME provisions such as 창업감면, 결손금 소급공제, 최저한세 7% still apply for that year). A dedicated '범위 밖:' section lists what the tool will not handle (pre-2015 years, 주된 업종 판정, 해외 자회사, 상장법인 7년 유예, 합병 유예 배제), which is exactly the when-not guidance an agent needs.

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