Skip to main content

korean-tax-mcp — Korea Tax Law MCP (한국 세법)

데모: 조사 쟁점 근거 조회 — 비상장주식 저가양도 부당행위계산, 2024년 기준 조문 3단·통칙·집행기준·해석·판례·승패 비교

PyPI MCP Registry License: MIT Built with Upstage Solar Pro 4 · English

작성 주체(정확한 고지): 0.7.00.11.1(2026-10-1310-19)은 Solar Pro 4(Solar Work CLI)가 코드를 쓰고 CodeSolar가 리뷰, Claude가 테스트로 교차 검증했습니다(0.10.0은 목차만 Solar, 나머지는 Claude 작성). 0.12.0(2026-10-28)부터는 기존 세법 MCP 뼈대는 Solar Pro 4 그대로이고, 점검·버그 수정·보완은 Claude(Anthropic)가 작성하며 CodeSolar가 리뷰합니다. 버전별 작성 주체는 CHANGELOG 각 절 머리에 적혀 있습니다. 도구 24개.

Korea tax law for AI agents — statutes as in force on any date, NTS rulings and court decisions, basic rules, treaties. English


세법 쟁점을 AI에 물으면, 그 시점의 조문과 국세청 해석·판례를 문서번호와 함께 가져옵니다.

작동 방식

flowchart LR
  Q["AI의 요청<br/>법령·조문·기준일·키워드"] --> V["시행본 고르기<br/>기준일에 시행 중인 판"]
  V --> P["조문 정리<br/>항·호 분리, 단서 표시"]
  P --> L["위임 연결<br/>법→시행령→시행규칙"]
  Q --> S["해석·판례 검색<br/>문서번호·요지"]
  Q --> C["대조·판정<br/>원문과 글자 비교"]
  V -.-> A1[("법제처 Open API")]
  L -.-> A1
  S -.-> A2[("국세법령정보시스템")]
  P --> R["결과<br/>원문·시행일·문서번호·링크"]
  L --> R
  S --> R
  C --> R
  1. 조문 — 법제처에서 기준일에 시행 중이던 판을 골라 원문을 주고, 단서 구절과 위임 조문(법→시행령→시행규칙)을 함께 붙입니다. 기준일을 안 주면 오늘 기준입니다.
  2. 해석·판례 — 국세법령정보시스템에서 질의회신·판례·심판례·통칙·집행기준을 문서번호·링크로 찾습니다.
  3. 그 해 기준 — 세목별 기준일(사업연도 말일, 양도일 등)의 조문·해석을 모으고 현행과 바뀐 점을 표시합니다.
  4. 대조 — 진술·보기를 원문과 글자 단위로 비교해 다른 숫자·단서를 표시합니다.

판단과 결론은 사용자의 AI와 전문가 몫입니다. 이 서버는 근거를 가져옵니다.

이렇게 물어보세요

  • "2023년 12월 31일 기준 법인세법 시행규칙 제43조 원문"
  • "법인세법 제52조를 인용한 최근 질의회신·판례 보여줘"
  • "2019 사업연도 기준으로 법인세법 제52조 관련 조문·통칙·해석 정리해줘"
  • "'경조금은 건당 10만원까지 증빙 없이 손금'이라는 말, 2026 시행령 제41조 원문과 맞아?"
  • "미국 시민권자 대표이사, 작년 국내 체류 200일, 가족은 미국 — 거주자야?"

설치

claude mcp add korean-tax -- uvx korean-tax-mcp
{
  "mcpServers": {
    "korean-tax": {
      "command": "uvx",
      "args": ["korean-tax-mcp"],
      "env": { "LAW_OC": "법제처 OC(선택)", "UPSTAGE_API_KEY": "Upstage 키(선택)" }
    },
    "korean-tax-calc": { "command": "uvx", "args": ["korean-tax-calc-mcp"] }
  }
}

두 번째 줄의 korean-tax-calc-mcp는 짝 서버입니다 — 여기서 찾은 조문·해석을 근거로 세액·한도·판정을 코드로 계산하고(85개 도구), 법정서식 엑셀까지 만듭니다. 같이 두면 근거 찾기 → 계산 → 서식이 한 대화에서 이어집니다. 조문·판례만 쓰려면 첫 줄만 넣어도 됩니다.

키 쓰는 곳
없음 해석·판례·통칙·집행기준·사례집·조약·서식·책자 검색, 승패 비교, 거주자 판정
LAW_OC (open.law.go.kr 무료) 조문 조회·찾기·개정 이력, 그 해 기준 묶음, 진술·보기 대조, 인용 검증(조문)
UPSTAGE_API_KEY (선택) 사실관계 대조·승패 요약·영문 번역을 Solar가 수행. 없으면 사용자 AI가 수행
KOREAN_TAX_MCP_SOLAR_BASE_URL (선택) 망분리 환경에서 기관 내부 Solar 사용

데이터 전송 안내 — 기본 동작은 법제처·국세청 공개 API만 호출하며, AI 판단·요약·번역(사실관계 대조, 승패 요약, 영문 번역)은 사용자 AI가 수행합니다. Upstage로 전송되는 내용은 없습니다. 선택: UPSTAGE_API_KEY를 설정하면 Solar가 대조·요약·번역을 수행하며, 이때 입력 내용이 Upstage API(api.upstage.ai)로 전송되니 개인정보 등 민감정보는 넣지 마세요. 망분리 환경에서는 KOREAN_TAX_MCP_SOLAR_BASE_URL로 기관 내부 Solar에 연결하면 외부 전송 없이 사용할 수 있습니다.

도구 (24개)

묶음 도구 하는 일
조문 law_article 기준일 시행본 원문, 목차, 위임 조문, 단서 구절
find_article 조문 번호를 모를 때 키워드로 찾기
article_history 언제 바뀌었는지, 시행 예정 개정
article_addenda 부칙 — 개정 조문이 언제·어느 소득분부터 적용되는지(시행일·적용례·경과조치)
해석·판례 search_tax_rulings 질의회신·판례·심판례 검색
get_tax_ruling 문서 본문 전문
rulings_by_article 특정 조문을 인용한 해석·판례
basic_rules 국세 기본통칙 전문
execution_standards 세법집행기준 항목·쪽·링크
casebook_search 2025 세법해석 사례집(96건)
그 해 기준·검증 research_issue 세목별 기준일의 조문·통칙·해석 묶음, 현행 대비 변경
timing_rules 시기 규칙표 — 납세의무 성립·손익 귀속·소득별 수입시기·부가 공급시기
verify_citations 초안 속 문서번호·조문이 실제로 있는지
대조·판정 verify_statement 한 문장을 원문과 글자 대조
judge_options 보기 여러 개를 조문과 한 번에 대조
compare_outcomes 같은 쟁점의 납세자 승·패 결정 나란히
compare_with_case 우리 사실관계와 해석·판례 비교(지지·반대·구별)
조약·거주자 tax_treaty 조세조약 96개국 조문(국·영문)
treaty_withholding_rates 배당·이자·사용료 제한세율
residency_check 거주자·비거주자 3단계 판정(규칙)
residency_report 판정 검토 보고서(Solar)
문서·서식 search_forms 별표·서식
search_nts_publications 국세청 발간책자 본문
search_local_documents 내 PC PDF 검색(KOREAN_TAX_MCP_DOCS)

모든 도구는 lang="en"으로 영어 결과를 받을 수 있습니다.

면책

이 도구의 결과는 세무 자문이 아닙니다. 세법 근거를 찾아 보여 주는 참고 자료이며, 실제 신고·세무조사·불복 판단은 세무사·회계사·변호사 등 전문가에게 확인하세요. 해석·판례·조문은 원문 링크로 확인하세요.

이 도구는 세무사법 제2조의 세무대리(세무조정계산서 작성, 신고·불복 대리, 세무상담 등)를 수행하지 않으며, 그 업무는 세무사와 등록한 공인회계사·변호사만 할 수 있습니다(세무사법 제20조). 공개된 법령·해석·결정례 원문을 찾아 보여 주는 소프트웨어이고, 데모 화면의 "조사 쟁점 근거 조회" 같은 사례도 자료 조회·정리 기능의 시연일 뿐 사실관계 판단이나 대응 전략 제시가 아닙니다. 사실관계 판단과 대응은 세무 전문가(세무사·회계사·변호사)와 함께 확인해 주세요.

AI 사용 고지

  • 조회·검색·거주자 규칙 판정(search_tax_rulings, get_tax_ruling, law_article, residency_check 등)은 코드로 동작합니다 — 생성형 AI가 개입하지 않습니다.
  • 생성형 AI가 작성하는 결과: 사실관계 대조(compare_with_case), 승패 요약(compare_outcomes explain=True), 영문 번역(lang="en"), 거주자 판정 보고서(residency_report)는 생성형 AI(기본: 사용자 AI, 선택: Upstage Solar Pro 4)가 작성합니다.
  • Solar가 작성한 결과(mode: "solar_cloud" 또는 "solar_onprem")에는 결과에 AI 생성 표시 필드가 함께 반환됩니다. 이 표시의 문구는 AI 기본법 제31조에 따른 것입니다.
  • 사용자 AI(mode: "host_ai")가 판단하는 경우는 결과에 AI 생성 표시가 붙지 않으며, 대신 안내 문구에 "판단 결과를 사용자에게 보여 줄 때 AI 생성임을 표시하세요"가 포함됩니다. 실제 표시는 사용자 측 AI 도구에서 수행하세요.

유의

  • 해석·판례는 회신·선고 당시 법 기준입니다. 적용 연도 조문(law_article의 as_of)과 대조하세요.
  • 국세법령정보시스템 공개 조회를 1일 캐시, 0.5초 간격으로 사용합니다. 집행기준은 항목·쪽·링크까지만 제공합니다.
  • 일반 법령 전반은 korean-law-mcp와 함께 쓰면 좋습니다.

평가 방법

Solar Pro 4가 이 MCP 서버들을 도구로 써서 세법 객관식 문항을 푸는 종합 평가는 eval/ 폴더를 참고한다. 도구 하나하나의 정확도는 bench/에서 측정한다.

출처 · 라이선스

국세청 국세법령정보시스템 · 법제처 국가법령정보 공동활용 · 국세청 「2025 세법해석 사례집」

MIT © 2026 Upstage · Created by Mia(윤승미)

Metadata

Release files for korean-tax-mcp 0.12.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for korean-tax-mcp 0.12.4
File Size Uploaded Provenance Actions
korean_tax_mcp-0.12.4.tar.gz 455.6 kB With provenance Details for korean_tax_mcp-0.12.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for korean-tax-mcp 0.12.4
File Interpreter ABI Platform Actions
korean_tax_mcp-0.12.4-py3-none-any.whl Python 3 none any Details for korean_tax_mcp-0.12.4-py3-none-any.whl

Total release size: 605.8 kB

Release files / korean_tax_mcp-0.12.4.tar.gz

Download URL korean_tax_mcp-0.12.4.tar.gz
Size 455.6 kB
Tags Source
SHA-256 checksum
How to use checksums
83074e57878afb37cd1d4ede8bf9c356d57ece9a96a494a55362a7a7cffffd16
BLAKE2b-256 checksum
How to use checksums
ce166f3fd42aef803dcb5cb93a9b5ce73fbad219d88cba129f2472bd6b654861
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.

Transparency log

Release files / korean_tax_mcp-0.12.4-py3-none-any.whl

Download URL korean_tax_mcp-0.12.4-py3-none-any.whl
Size 150.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
af3d2289d6654c72ad57e132f3152d168ddae937963905358f1b6066c72117f5
BLAKE2b-256 checksum
How to use checksums
31dc23db3aab87ebcae9cdc031e1d52b1c847340fc365d277d2f97e9b1555e7d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.

Transparency log

Security for korean-tax-mcp 0.12.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for korean_tax_mcp-0.12.4.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page