The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Korea Tax Law MCP listing page.
한국 세법 그래프 DB를 AI에 연결하는 공개 MCP(Model Context Protocol) 서버입니다. 단순 법 조문을 찾는 것을 넘어, 유권해석 본문, 예규판례 찾는 데 탁월한 DB입니다.
국세청 조세법령 목록의 현행 90개 법·령·칙(법률 31 · 시행령 32 · 시행규칙 27), 판례·조세심판원 결정례 15.3만건, 국세청·법제처·행정안전부 해석례 14.8만건, 108개국 조세조약 조문 3천개가 그래프로 연결되어 있고, 조문마다 시행일과 개정 연혁이 붙어 있습니다. 목록의 역사 법령 2개(자산재평가법시행령·시행규칙)는 현행 그래프에서 제외합니다. AI가 세법을 "기억"이 아니라 현행 원문 조회로 답하게 만듭니다.
위임·별표·문서 인용은 활성·검증되고 원천 스냅샷이 맞는 관계만 따릅니다. 키워드 검색 히트는 검증된 인용이 아니며, 인용은 적용 확정이 아닙니다.
국가법령정보센터에서 직접 API로 호출하는 것이 아니라, Graph DB로 세법 DB를 다시 설계하여 AI로 하여금 법률 추론의 효과성/효율성을 극대화할 수 있도록 한 DB입니다.
프론티어 모델이 급진적으로 발달했음에도 불구하고 LLM은 세법 질문에 자주 유권해석, 판례 등을 지어내서 답합니다. 또한, 일반 Web 검색을 통한 AI 답변은 학습 시점 이후 개정을 모르고, 세율·한도 숫자를 섞고, 폐지된 조문을 인용합니다. 이 서버를 연결하면 AI가 답하기 전에 현행 시행 버전 조문 원문을 직접 확인합니다.
현재 버전 v0.7.0 (CHANGELOG)
| 도구 | 용도 |
|---|---|
list_laws | 수록 현행 법령 목록 + 시행일 (국세·지방세 구분). 목록 역사 법령 제외 |
search_articles | 조문 전문검색 (복합어 부분일치 폴백 포함). 현행·검증 CONTAINS만 |
get_article | 조문 현행 원문 전체 + 시행일 + 검증된 위임·별표·인용 |
get_article_history | 조문 개정 연혁 ("언제 바뀌었나"). 미검증 버전 표시 |
search_cases | 판례·조세심판원 결정례 키워드 검색 (검증된 인용 아님) |
search_interpretations | 국세청·법제처·행정안전부 해석례 키워드 검색 (검증된 인용 아님) |
search_annexes | 별표·서식 검색 (세율표·기준금액·분류표) |
get_annex | 별표 본문 전체 + 원본 HWP·PDF 링크 |
list_upcoming | 공포됐으나 시행 전인 개정 조문 |
list_treaties | 조세조약 체결국 목록 / 국가별 협약·의정서 이력 |
search_treaties | 조세조약 조문 전문검색 (제한세율·고정사업장 등) |
get_treaty_article | 조세조약 조문 원문 (국문 + 영문) + 그 조문을 개정한 의정서 |
Claude (웹/데스크톱): 설정 → Connectors → Add custom connector → https://mcp.taxdoctorai.com/mcp
Claude Code:
Codex CLI (~/.codex/config.toml):
Gemini CLI (~/.gemini/settings.json):
구형 SSE 전용 클라이언트: https://mcp.taxdoctorai.com/sse
stdio 전용 클라이언트: npx -y mcp-remote https://mcp.taxdoctorai.com/mcp
범위의 정본은 국세청 조세법령 목록(주요세법 + 기타세법·관련법령)입니다. 현행 90,
목록 역사 2(자산재평가법시행령·자산재평가법시행규칙)는 현행 그래프에서 제외합니다.
표의 날짜는 수록된 버전의 시행일입니다. —는 해당 하위법령이 없거나 아직 미수록이라는
뜻이고, 최신 목록은 언제나 list_laws가 정본입니다.
이 MCP는 같은 로컬 Neo4j를 읽기만 합니다. 데이터셋 동봉이나 별도 검색 API가 아닙니다.
| 세목 | 법률 | 시행령 | 시행규칙 |
|---|---|---|---|
| 국세기본법 | 2026.08.11 | 2026.07.01 | 2026.03.20 |
| 국세징수법 | 2026.06.02 | 2026.02.27 | 2026.03.20 |
| 조세특례제한법 | 2026.07.01 | 2026.07.01 | 2026.07.01 |
| 농ㆍ축산ㆍ임ㆍ어업용 기자재 부가가치세 특례 | — | 2026.02.27 | 2026.03.20 |
| 외국인관광객 부가가치세·개별소비세 특례 | — | 2026.01.02 | 2026.01.02 |
| 소득세법 | 2026.07.01 | 2026.07.01 | 2026.07.01 |
| 법인세법 | 2026.07.01 | 2026.02.27 | 2026.07.01 |
| 국제조세조정에 관한 법률 | 2026.01.02 | 2026.02.27 | 2026.03.20 |
| 상속세 및 증여세법 | 2026.01.02 | 2026.02.27 | 2026.03.20 |
| 종합부동산세법 | 2026.01.01 | 2026.02.27 | 2026.03.20 |
| 부가가치세법 | 2026.01.02 | 2026.04.01 | 2026.04.01 |
| 개별소비세법 | 2026.04.24 | 2026.07.30 | 2026.04.01 |
| 주세법 | 2025.01.01 | 2026.04.01 | 2026.01.02 |
| 주류 면허 등에 관한 법률 | 2026.07.01 | 2026.07.01 | 2026.01.02 |
| 교통ㆍ에너지ㆍ환경세법 | 2026.01.02 | 2026.07.30 | 2025.04.01 |
| 인지세법 | 2026.01.02 | 2026.01.02 | 2026.01.02 |
| 증권거래세법 | 2022.07.01 | 2026.01.02 | 2026.03.20 |
조세특례제한법은 소관이 재정경제부·행정안전부 공동이라 list_laws에서 [공통]으로 표시합니다.
| 세목 | 법률 | 시행령 | 시행규칙 |
|---|---|---|---|
| 과세자료의 제출 및 관리에 관한 법률 | 2026.01.02 | 2026.02.27 | 2026.03.20 |
| 관세법 | 2026.08.11 | 2026.07.01 | 2026.07.31 |
| 교육세법 | 2026.01.01 | 2026.02.27 | — |
| 국세청과 그 소속기관 직제 | — | 2026.08.28 | 2026.08.28 |
| 금융실명거래 및 비밀보장에 관한 법률 | 2025.04.01 | 2024.12.27 | 2017.07.26 |
| 농어촌특별세법 | 2026.05.12 | 2026.01.02 | — |
| 부동산 실권리자명의 등기에 관한 법률 | 2020.03.24 | 2024.05.17 | 2017.03.30 |
| 상가건물 임대차보호법 | 2026.05.12 | 2026.07.01 | — |
| 자산재평가법 | 2020.08.28 | (역사·제외) | (역사·제외) |
| 조세범 처벌법 | 2021.01.01 | — | — |
| 조세범 처벌절차법 | 2023.01.17 | 2026.02.27 | — |
| 지방세기본법 | 2026.02.05 | 2026.07.01 | 2026.07.01 |
| 지방세법 | 2026.07.01 | 2026.07.01 | 2026.07.01 |
| 지방세징수법 | 2026.02.05 | 2026.02.05 | 2026.07.01 |
| 지방세특례제한법 | 2026.06.02 | 2026.07.01 | 2026.01.01 |
| 질서위반행위규제법 | 2021.01.01 | 2026.06.30 | — |
| 취업 후 학자금 상환 특별법 | 2026.07.01 | 2026.07.01 | 2024.07.01 |
일반법령 우주·ReferenceBook 15건의 재바인딩은 이 현행 범위에 포함되지 않습니다.
get_article의 위임·별표·인용은 활성(active)·검증(verified)되고 원천 스냅샷이
일치하는 관계만 반환합니다. 소득세법 제20조의 검증된 위임은 시행령 제38조이며,
비활성 위임이 가리키던 다른 조문은 숨깁니다.
문서 인용은 그 문서가 그 조문을 인용했다는 식별이지, 그 조문이 그 사안에
적용됐다는 확정이 아닙니다. temporal_resolution=unresolved 이거나
resolved_version_id가 없으면 현행 조문으로 메우지 마세요.
2026-09-06 수리 범위: remaining 문서 293,581건 재검증 오류 0. 전체 문서
325,581건은 선행 Case 32,000을 포함합니다. 적용 보고서 semantic_coverage=false
(부분 해소 193,826 · 모호 27,728 · 해소 불가 22,148)는 실행 실패가 아니라
불확실 인용은 불확실로 남긴 결과입니다.
그래프 물리 규모(노드 379,473 · 관계 2,838,346)는 물리 건수이며 의미 확정이 아닙니다.
세율표·기준금액·분류표는 조문이 아니라 별표에 있는 경우가 많습니다. 조문만 읽으면
"별표에 따른다"에서 막히므로 별표 본문을 함께 싣습니다.
get_article이 검증된 HAS_ANNEX로 그 조문의 별표를 함께 표시합니다.
공포됐으나 아직 시행되지 않은 개정문입니다. 현행 조문과 분리해서 담습니다 —
섞으면 어느 쪽을 답한 것인지 알 수 없게 됩니다.
get_article은 그 조문에 시행예정 개정이 있으면 시행일과 함께 경고합니다.
| 구분 | 건수 |
|---|---|
| 조세심판원 결정례 | 139,504 |
| 대법원 판례 | 8,949 |
| 고등법원 판례 | 3,676 |
| 헌법재판소 결정 | 899 |
| 발신 기관 | 건수 |
|---|---|
| 국세청 질의회신 | 136,516 (기관 미표기 6,302 포함) |
| 법제처 법령해석례 | 8,708 |
| 행정안전부 (지방세) | 3,316 |
예규(Ruling) 24,013건은 get_article의 검증된 인용으로만 일부 노출합니다.
행정규칙·ReferenceBook은 전용 검색 도구가 없습니다.
협약·개정의정서·교환각서를 합친 건수이며, 조문 3,002개가 국문·영문 병존으로 들어 있습니다.
그중 220건은 부속문서(개정의정서·교환각서·최혜국대우 통보·전문)이고, 이 부속문서들이
자기가 고치는 조문에 AMENDS 관계로 연결돼 있습니다 — 링크 110개.
전부 공공 원천입니다. 법령·판례는 저작권법 제7조 비보호저작물입니다.
| 데이터 | 원천 | 경로 |
|---|---|---|
| 법령 조문·시행일·개정 연혁 | 국가법령정보센터 OpenAPI | lawSearch/lawService.do?target=eflaw (시행일 법령), target=law |
| 별표·서식 본문 | 국가법령정보센터 | 법령 상세 XML의 <별표단위> (별도 target=licbyl이 아님) |
| 시행예정 개정 | 국가법령정보센터 | target=eflaw 목록의 현행연혁코드 시행예정 |
| 대법원·고등법원 판례 | 국가법령정보센터 | law.go.kr/판례/{id} |
| 헌법재판소 결정 | 국가법령정보센터 | target=detc |
| 조세심판원 결정례 | 국가법령정보센터 | target=ttSpecialDecc |
| 국세청 질의회신 목록 | 공공데이터포털 | 법제처_국세청 법령해석 목록 |
| 국세청 질의회신 본문 | 국세법령정보시스템 | taxlaw.nts.go.kr 공개 조회 액션 |
| 법제처 법령해석례 | 국가법령정보센터 | law.go.kr/법령해석례/{id} |
| 행정안전부 지방세 해석 | 국가법령정보센터 | target=moisCgmExpc |
| 행정규칙(훈령·예규·고시) | 국가법령정보센터 | target=admrul |
| 조세조약 메타데이터 | 국가법령정보센터 | target=trty |
| 조세조약 조문 본문 | 국세법령정보시스템 | taxlaw.nts.go.kr 조세조약 메뉴 |
갱신은 매일 아침 증분 수집(법령 개정·신규 판례·해석례)이며, 수록 범위는 list_laws·
list_treaties로 확인합니다. 미수록 법령은 국가법령정보센터 참조.
별표 본문은 별표 API가 아니라 법령 상세 XML에서 옵니다.
별표 상세 엔드포인트(target=licbyl)는 JS 껍데기만 주고 본문을 주지 않습니다. 본문은
법령 상세 XML 안의 <별표단위>에 들어 있어서, 별표만 따로 받는 경로로는 내용이 비어
옵니다.
조세조약 — 개정의정서가 본문에 반영돼 있지 않습니다. 대신 연결해 뒀습니다.
조약은 메타데이터(국가법령정보센터)와 조문 본문(국세법령정보시스템)을 서로 다른 원천에서 받아 합칩니다. 국세법령정보시스템이 주는 조문 본문은 협약 원문이라 이후 개정의정서가 반영돼 있지 않습니다. 스위스 제10조(배당)는 1980년 협약 그대로 10%/15%인데, 2012년 의정서가 이를 5%(지분 10% 이상)/15%로 바꿨습니다.
다행히 그 개정의정서 본문 자체는 부속문서로 함께 들어옵니다. 그래서 수집 단계에서
부속문서 본문의 협약 제N조 참조를 뽑아 해당 조문에 잇습니다. 조문 번호 없이 세율만
알리는 최혜국대우 통보는 소득 유형(배당·이자·사용료)을 조문 제목에 맞춥니다.
이제 get_treaty_article이 조문 본문과 함께 그 조문을 고친 의정서를 발췌까지 붙여
돌려줍니다.
list_treaties(country)는 그 나라의 부속문서 목록을, get_treaty_article은 부속문서
제목으로도 전문을 돌려줍니다.
남은 한계: 개정 성격 부속문서 40건 중 35건에서 조문 참조를 뽑았습니다. 나머지와, 애초에 국세법령정보시스템이 부속문서를 싣지 않은 조약은 연결이 없습니다. 그 경우 국가 단위 경고 (후속 협약·의정서 N건 존재)만 표시되니, 제한세율처럼 숫자가 결론을 좌우하는 쟁점은 law.go.kr 원문을 반드시 대조하세요.
server.py 하나가 전부입니다. 파이썬 3.9+ 표준 라이브러리만 사용 (의존성 0).
단, 같은 스키마의 Neo4j 그래프 DB가 필요합니다 (Law/Article/Case/Interpretation/Treaty/TreatyArticle 노드, 풀텍스트 인덱스, 관계의 active/verified/원천 스냅샷). 데이터 수집 파이프라인과 DB 덤프는 이 리포에 포함되어 있지 않으므로, 일반 사용자는 호스팅 엔드포인트 사용을 권장합니다.
기본 방어 설정: 도구 호출 IP당 분당 30회(RATE_PER_MIN), 핸드셰이크(initialize·
tools/list) IP당 분당 20회(HANDSHAKE_PER_MIN), 동시 쿼리 4개, 쿼리 타임아웃 8초,
read-only.
도구는 한 번도 안 부르고 initialize+tools/list만 반복하는 디렉터리 스캐너가
붙으면, server.py의 BLOCKED_NETS에 해당 IP나 대역을 넣어 403으로 끊을 수 있습니다
(기본값은 빈 목록). 대상은 logs/usage-*.jsonl을 IP×메서드로 갈라 tools/call이
0건인 IP를 찾으면 됩니다.
제공 정보는 실무 참고용이며 공식 유권해석이 아닙니다. 구체적 사안은 반드시 원문(국가법령정보센터·국세법령정보시스템)을 확인하고 전문가와 상의하세요. 검증된 인용·물리 관계 건수를 법적 완결이나 적용 확정으로 읽지 마세요.
박민수 — 한국공인회계사(KICPA), 안세회계법인 세무 이야기: Threads @mangopeach.cpa