AI TOOLS | 세금
세금 용어 몰라도상황만 말하면 계산 끝업스테이지 세금 계산기 쓰는 법
업스테이지가 무료로 푼 한국 세금 계산기(도구 97개)를 클로드에 연결하는 법, 개인이 쓸 계산기만 골라 정리, 퇴직·집·증여·주식·늦게 낸 세금 상황별로 복사해 쓰는 질문, 알아 둘 것
AI한테 세금을 물으면 그럴듯한 숫자가 나오지만, 그 숫자가 맞는지는 알 수 없어요. 한국 AI 회사 업스테이지가 이 문제를 풀려고 세금 계산기 97개를 무료로 공개했어요. 클로드에 연결하면 AI가 어림잡지 않고, 코드가 그해 세법대로 계산하고 근거 조문까지 붙여 줘요. 세금 용어를 몰라도 상황만 말하면 맞는 계산기를 알아서 찾아요.
한눈에
- 무엇클로드에 연결하는 한국 세금 계산 도구 묶음(MCP). 퇴직금·집·증여·상속·주식·가산세 등
- 요금무료(MIT 라이선스). 키 없이 동작, 계산은 내 컴퓨터에서
- 숫자도구 97개(11-10 확인, 버전 0.25.3). 개인이 바로 쓸 건 12개 남짓, 나머지는 회계·세무 실무용
- 주의세무 자문이 아니라 참고용이에요. 신고 전엔 홈택스·세무사로 한 번 더 → 알아 둘 것
공식 원문

README 원문과 번역
- "Korean tax calculations for AI agents — code, not guesses."AI를 위한 한국 세금 계산. 짐작이 아니라 코드로.
- "세금 계산은 AI가 자주 틀립니다. 이 서버는 계산을 코드로 하고, 결과마다 근거 조문을 붙입니다. 연도표가 없는 해는 추정하지 않고 멈춥니다."(원문이 한국어예요)
- "모르는 항목·빠진 값이 있으면 계산하지 않고 무엇이 필요한지 알려 줍니다."정보가 모자라면 대충 계산하지 않고 되물어요.
어떻게 계산하나
- 입력 확인: 빠진 값이 있으면 멈추고 “이게 필요해요”라고 알려 줘요.
- 그해 기준값: 세율·한도를 코드 안 연도표에서 꺼내요. 소득세·법인세는 2016~2026년이 들어 있어서 지난해 세금도 그해 기준으로 계산해요.
- 계산: 법 조문 순서대로 계산해요.
- 결과: 세액과 중간 계산, 근거 조문을 같이 보여 줘요.
97개 중 94개는 생성형 AI 없이 코드로만 돌아요. 그래서 같은 질문엔 늘 같은 답이 나와요.
직접 계산해 봤어요
Ai.Mag가 11월 10일(버전 0.25.3)에 그대로 넣어 본 결과예요. 지방소득세는 따로 붙어요.
| 물어본 것 | 결과 | 계산기가 붙인 근거 |
|---|---|---|
| 퇴직금 3,000만 원, 7년 근무 (지금 기준) | 퇴직소득세 39만 2천 원 | 소득세법 제48조·제55조② |
| 같은 값, 2022년까지의 옛 기준 | 74만 원 | 2023년 바뀌기 전 근속연수공제 |
| 부모님께 5,000만 원 받음 (성인) | 증여세 0원 | 상속세 및 증여세법 제53조 |
| 부모님께 1억 원 받음 (성인) | 증여세 485만 원 (기한 안 신고 3% 공제 반영) | 상속세 및 증여세법 제53조 등 |
| 결혼 전후 2년 안에 1억 5,000만 원 받음 | 증여세 0원 (기본 5,000만 + 혼인·출산 1억) | 상속세 및 증여세법 제53조의2 |



퇴직소득세는 2023년에 공제가 크게 늘었어요. 그 전에 쓰인 글로 계산하면 같은 퇴직금에 세금이 거의 두 배로 나와요. 증여도 금액만 넣으면 계산하지 않고 "언제, 누구한테 받았는지"부터 물어요.
개인이 쓸 계산기만 골랐어요
| 이럴 때 | 계산기 |
|---|---|
| 회사 그만두고 퇴직금 받을 때 | 퇴직소득세 |
| 월급 세금, 연말정산 | 근로소득세, 특별세액공제, 자녀세액공제 |
| 프리랜서·부업 5월 신고 | 종합소득세 |
| 집·땅 팔 때 | 양도소득세 |
| 부모님께 돈 받을 때 | 증여세 |
| 상속받을 때 | 상속세 |
| 해외·국내 주식 팔 때 | 주식 양도소득세 |
| 연금저축·IRP 찾을 때 | 연금계좌 인출 |
| 월세 받는 집이 있을 때 | 주택임대소득 |
| 세금을 늦게·적게 냈을 때 | 납부지연가산세, 과소신고가산세 |
| 세금 더 낸 걸 돌려받고 싶을 때 | 경정청구 기한(보통 5년) |
이름을 몰라도 돼요. 상황을 말하면 find_tool이 맞는 계산기를 찾아요.

설치
솔직히 말하면, 터미널(검은 명령 창)을 한 번은 써야 해요. 붙여 넣고 Enter만 누르면 돼요.
순서
- 1. uv 설치 (처음 한 번)계산기를 실행해 주는 프로그램이에요. 맥은 터미널에 아래 첫 줄, 윈도우는 PowerShell에 둘째 줄을 붙여 넣어요.
- 2-A. 클로드 코드를 쓴다면터미널에 연결 명령 한 줄을 붙여 넣으면 끝이에요.
- 2-B. 클로드 데스크톱 앱을 쓴다면설정 → 개발자 → 설정 편집을 눌러 열린 파일에 아래 내용을 넣고, 앱을 껐다 켜요.
- 3. 확인새 대화에서 "퇴직금 1억, 15년 근속 퇴직소득세"라고 물어서 계산기 이름이 뜨면 연결된 거예요.
1. uv 설치
curl -LsSf https://astral.sh/uv/install.sh | shpowershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"2-A. 클로드 코드
claude mcp add korean-tax-calc -- uvx korean-tax-calc-mcp2-B. 클로드 데스크톱 (claude_desktop_config.json)
{
"mcpServers": {
"korean-tax-calc": { "command": "uvx", "args": ["korean-tax-calc-mcp"] }
}
}법 조문·판례까지 찾아 주는 짝 서버(korean-tax-mcp)도 있어요. 계산만 쓸 거면 위 한 줄로 충분해요.
상황별로 이렇게 물어보세요
세금 용어는 몰라도 돼요. 대괄호만 내 상황으로 바꿔요. 정보가 모자라면 클로드가 되물어요.
① 퇴직금
퇴직금 [3,000만 원] 받는데 [7년] 다녔어. 세금 얼마 떼여? 근거 조문도 알려 줘.② 집 팔 때
[2019년]에 [5억]에 산 집을 올해 [8억]에 팔아. 1주택이고 [5년] 살았어. 양도세 얼마야?③ 부모님께 돈 받을 때
부모님한테 전세금 [5,000만 원] 보태 받았어. 나는 성인이고 지난 10년간 받은 돈은 없어. 증여세 내야 돼?④ 주식 팔 때
올해 해외 주식으로 [800만 원] 벌었어. 세금 얼마고 언제까지 신고해야 해?⑤ 세금을 늦게 냈을 때
내야 할 세금 [200만 원]을 [30일] 늦게 냈어. 가산세 얼마 붙어?⑥ 더 낸 세금 돌려받기
[2021년] 종합소득세를 더 낸 것 같아. 지금 돌려 달라고 할 수 있는 기한이 남았어?⑦ 연말정산
연봉 [4,500만 원], 자녀 [2명]이야. 근로소득세 대략 얼마고 자녀세액공제는 얼마 받아?계산 결과는 질문에 넣은 값 그대로 나와요. 1주택인지, 특수관계인지 같은 사실은 계산기가 판단하지 않고 내가 말한 대로 계산해요.
알아 둘 것
- 세무 자문이 아니에요. 공식 저장소에 “결과는 참고 자료이며 세무대리(세무사법 제2조)를 하지 않는다”고 적혀 있어요. 실제 신고 전엔 홈택스 모의계산이나 세무사로 한 번 더 확인하세요.
- 사실관계는 내가 정확히 말해야 해요. 집이 몇 채인지, 가족 관계 같은 건 내가 말한 값으로 계산해요.
- 아주 빨리 바뀌어요. 10월 7일 공개 뒤 한 달 만에 도구가 85개 → 97개로 늘었어요. 새 버전으로 바꾸려면
uvx --refresh korean-tax-calc-mcp. - 내 정보가 밖으로 나가지 않아요. 키 없이 쓰면 계산은 내 컴퓨터에서 해요. 주식 시세(KRX)·공시가격(브이월드) 조회만 공개 데이터를 가져와요.
- 이 계산기 코드는 업스테이지 AI(Solar Pro 4)와 클로드가 나눠 썼다고 저장소에 밝혀 두었어요.
출처
- 저장소·README: https://github.com/UpstageAI/korean-tax-calc-mcp
- PyPI(버전): https://pypi.org/project/korean-tax-calc-mcp/
- 짝 서버(조문·판례 검색): https://github.com/UpstageAI/korean-tax-mcp
- uv 설치 안내: https://docs.astral.sh/uv/getting-started/installation/