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

· English

0.3.0부터 업스테이지 Solar Pro 4로 개발합니다. (0.2.1까지는 Solar Pro 4 이전 개발분) 2026년 법인세율, 비거주자 원천징수(nonresident_withholding), 과소자본(thin_capitalization)은 Solar Pro 4(Solar Code CLI)가 코드를 작성하고, Solar Pro 4 기반 코드 리뷰(CodeSolar)가 PR을 검토했으며, Claude가 테스트로 교차 검증했습니다. 0.4.0: 세무조사 판정 도구 11개 통합. 0.5.1: precheck_schema 추가·41개 도구로 확대, description·인자 설명 전면 정비.

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. 41 tools (29 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일)"

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

• 연도별 세율표 — 2016~2026 사업연도·귀속연도별 세율·한도율, 없는 해는 추정하지 않고 오류
• 근거 조문 — 모든 결과에 법·시행령 조문 표시
• 날짜 계산 — 가산세 이율 변경일 안분, 제척기간 만료일, 인정이자 적수
• 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개)

쟁점 표시

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

면책 및 고지

• 면책: 이 도구의 결과는 세무 자문이 아닙니다. 법령·해석을 바탕으로 계산·판정 과정을 보여 주는 참고 자료이며, 실제 신고·세무조사·불복 판단은 세무사·회계사·변호사 등 전문가에게 확인하세요. 근거 조문·판례는 원문으로 확인하세요.
• AI 사용 고지: 계산·판정 도구 29개는 코드로 동작하며 생성형 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 전송 시 넣지 마세요.

유의

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

지원 연도

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

함께 쓰면 좋은 MCP

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

라이선스

MIT © 2026 Upstage

Created by Mia(윤승미)