korean-tax-calc-mcp — Korea Tax Calculator MCP (한국 세금 계산)

· English

0.3.0부터 업스테이지 Solar Pro 4로 개발합니다. (0.2.1까지는 그 이전 개발분) 2026 법인세율·비거주자 원천징수·과소자본(0.3.0), 세무조사 판정 도구 11개(0.4.0), 사실관계를 받아 세무조정까지 돌려주는 끝에서 끝까지 계산기 9종과 사실관계 어휘(0.6.00.7.0), 조정명세서 모양 결과·원장형 입력(0.8.00.9.0)은 Solar Pro 4가 코드를 쓰고 Solar Pro 4 기반 코드 리뷰(CodeSolar)가 PR을 검토했으며, Claude가 테스트로 교차 검증했습니다. 50개 도구, 상세는 CHANGELOG.

Korean tax calculations for AI agents — code, not guesses. Corporate tax, entertainment limits, deemed interest, penalties, limitation periods, withholding, income tax and VAT, using year-by-year rate tables (2016–2026). Each result cites its statute. Years without a verified table stop with an error instead of estimating. 50 tools (38 computation + 12 tax audit judgment) — → English README

세금 계산은 AI가 자주 틀립니다. 이 서버는 계산을 코드로 하고, 결과마다 근거 조문을 붙입니다. 연도표가 없는 해는 추정하지 않고 멈춥니다.

이렇게 물어보세요

• "2025 사업연도 과세표준 5억 법인세 산출세액은?"
• "과소신고 1천만 원을 10월 7일에 납부하면 가산세는?"
• "가지급금 3월 1일 2억 대여, 9월 30일 1억 회수 — 인정이자 계산해줘"
• "중소기업 매출 100억, 기업업무추진비 5천만 원이면 한도초과액은?"
• "2018년 3월 31일 신고기한인 법인세 부과제척기간 만료일은? 부정행위면?"
• "퇴직금 1억, 근속 15년 퇴직소득세"
• "세금계산서 미발급 공급가액 5천만 원 가산세"
• "보증금 3억 상가 간주임대료 (184일)"
• "기업업무추진비 원장 5건 그대로 줄게 — 2025 사업연도 세무조정(손금불산입·소득처분) 뽑아줘"
• "대손: 소멸시효 800만·부도 3개월 어음 500만, 충당금 기초 2천만·설정 2,500만 — 한도초과와 유보 조정은?"
• "중견기업 매출 500억 중 특수관계법인 400억, 지배주주 60% — 2026 신고안내 산식으로 일감몰아주기 증여의제이익"

설치 한 줄 — claude mcp add korean-tax-calc -- uvx korean-tax-calc-mcp

• 연도별 세율표 — 2016~2026 사업연도·귀속연도별 세율·한도율, 없는 해는 추정하지 않고 오류
• 근거 조문 — 모든 결과에 법·시행령 조문 표시
• 날짜 계산 — 가산세 이율 변경일 안분, 제척기간 만료일, 인정이자 적수
• 원장 그대로 입력 — 기업업무추진비·대손·간이과세·공통매입세액 등은 원장 항목을 그대로 주면 항목 판단 → 세법상 조정 → 조정명세서 모양 결과까지
• 계산은 코드로만 — 생성형 AI 없이 설치한 컴퓨터 안에서 계산. PDF 검토 도구 3개만 키를 설정했을 때 Upstage API를 씁니다

설치

uv가 있으면 설치 없이 바로 실행됩니다.

{
  "mcpServers": {
    "korean-tax-calc": { "command": "uvx", "args": ["korean-tax-calc-mcp"] }
  }
}

Claude Code: claude mcp add korean-tax-calc -- uvx korean-tax-calc-mcp

근거 조문·해석은 korean-tax-mcp와 함께 쓰면 "근거 찾기 → 계산"이 이어집니다.

도구

세무조사 판정 (11개)

원장형 입력 (0.9.0)

기업업무추진비·간이과세·공통매입세액 계산기는 장부·전표에 적힌 모양 그대로 항목 이름 + 금액 + 속성 목록을 받습니다. 어느 칸에 들어가는지, 포함인지 제외인지는 계산기가 어휘(data/facts_vocab.json)로 판단합니다. 항목 이름이 어휘에 없으면 계산하지 않고 허용값을 돌려줍니다.

{"year": 2026, "sme": false,
 "revenue": {"매출액": 25000000000, "특수관계매출": 4000000000, "매출할인등": {"특수관계": 200000000}},
 "ledger": [
   {"항목": "기업업무추진비(증빙 없음)", "금액": 7000000, "증빙": "없음"},
   {"항목": "기업업무추진비", "금액": 50000000, "증빙": "적격"},
   {"항목": "광고비 — 거래처 교제 목적", "금액": 13000000, "증빙": "적격", "성격": "교제목적"},
   {"항목": "복리후생비 — 직원 단체(법인) 복리시설비", "금액": 12000000, "성격": "직원단체_법인"},
   {"항목": "제품 사례 제공", "성격": "현물", "시가": 15000000, "장부가액": 11000000}]}

결과는 맨 앞에 세무조정(구분·금액·소득처분 목록), 소득처분별_합계, 손금불산입_합계가 오고 그 뒤에 한도·판단·산식·근거가 따릅니다. 같은 입력으로 다시 부르면 결과 맨 앞에 "같은 입력으로 N번째 계산입니다" 안내가 붙습니다.

쟁점 표시

비거주자·외국법인 원천징수(nonresident_withholding)와 과소자본(thin_capitalization) 결과는 계산된 세액과 함께 쟁점 리스트를 반환할 수 있습니다. 쟁점은 "이 소득 구분이 맞는지", "이 조약 세율이 그대로 적용되는지"처럼 실무에서 다툼이 될 수 있는 지점을 정리한 것으로, 도구는 결론을 내리지 않고 **확인할 자료와 참고 근거(조문·적부·판례 번호)**만 제시합니다. 각 쟁점 항목의 판단 필드는 항상 "세무사 확인 필요"로 고정되어 있으며, 도구가 "사업소득임", "사용료임" 같은 단정 문구를 결과 어디에도 쓰지 않습니다. 쟁점 데이터는 코드 하드코딩 없이 korean_tax_calc_mcp/data/issues.json에서 읽어옵니다.

면책 및 고지

• 면책: 이 도구의 결과는 세무 자문이 아닙니다. 법령·해석을 바탕으로 계산·판정 과정을 보여 주는 참고 자료이며, 실제 신고·세무조사·불복 판단은 세무사·회계사·변호사 등 전문가에게 확인하세요. 근거 조문·판례는 원문으로 확인하세요.
• 세무대리 아님: 이 도구는 세무사법 제2조의 세무대리(세무조정계산서 작성, 신고 대리, 세무상담 등)를 수행하지 않으며, 그 업무는 세무사와 등록한 공인회계사·변호사만 할 수 있습니다(세무사법 제20조). 법령에 적힌 산식을 코드로 옮겨 입력값에 대한 계산 과정을 보여 주는 소프트웨어이고, 입력 사실관계의 확인과 최종 판단은 세무 전문가(세무사·회계사·변호사)와 함께 해 주세요.
• AI 사용 고지: 계산·판정 도구 32개는 코드로 동작하며 생성형 AI를 쓰지 않습니다. PDF 검토 도구 3개(extract_relations, tunnelling_from_pdf, return_precheck_pdf)는 UPSTAGE_API_KEY가 있으면 생성형 AI(Upstage Solar Pro 4)로 표를 추출하며 결과에 그 사실을 표시합니다. 키가 없으면 pypdf로 로컬 텍스트 추출(host_ai 모드) 후 정리 안내에 따라 다음 도구 입력으로 직접 정리할 수 있습니다.
• 데이터 전송: UPSTAGE_API_KEY를 설정해 PDF 도구를 사용할 때만 문서 내용이 Upstage API(api.upstage.ai)로 전송됩니다. 키 없이 사용하면(pypdf 로컬 추출) 외부 전송이 없습니다. 민감정보가 담긴 문서는 API 전송 시 넣지 마세요.

유의

• 계산 결과는 검토 보조 자료이며 세무 자문이 아닙니다. 신고 전 원문 조문과 확인하세요.
• 지방소득세는 별도입니다.
• 세율표가 검증되지 않은 연도는 계산하지 않고 오류를 돌려줍니다.
• 데이터 전송 안내 — 계산·판정 도구 32개는 설치한 컴퓨터 안에서 코드로 처리하며 외부 API로 전송하는 내용은 없습니다. PDF 도구 3개만 Upstage API로 문서를 전송합니다.

지원 연도

세목별 연도표는 2016~2026을 지원하며, 표에 없는 연도는 추정 계산하지 않고 오류로 멈춘다. 연도는 사업연도·귀속연도·지급연도·과세기간 기준으로 세목마다 적용 기간이 다르다.

함께 쓰면 좋은 MCP

• korean-tax-mcp — 국세청 해석·판례·통칙·시점별 조문

라이선스

MIT © 2026 Upstage

Created by Mia(윤승미)