Skip to main content
Glama

tax2ai-mcp

세무사 실무를 위한 법령·결정례 MCP 서버입니다. 법제처 국가법령정보 공동활용 Open API를 원천으로, AI 어시스턴트가 조문 원문·시행 시점·위임 법령·결정례를 직접 조회하고 근거를 붙여 답하도록 돕습니다.

  • 줄임말 이해: 법법, 조특법 시행령, 상증법 → 정식 법령명

  • 시점 조회: 사업연도 당시 시행 문언을 asOf로 확인, 시행 예정 개정 자동 경고

  • 인용 점검: 초안의 "같은 법 제52조제1항" 같은 인용까지 추출해 존재·삭제·항호 범위 판정

  • 기한·세액 계산: 경정청구 5년, 부과제척기간, 휴일 순연 / 연도별 세율표 기반 산출세액

  • 결정례 통합 검색: 법원 판례 · 헌재 · 조세심판원 · 법제처 해석례

공개 엔드포인트: https://mcp.tax2.ai/mcp · 배포 방법(Vercel / Docker)은 docs/DEPLOY.md

claude mcp add --transport http tax2ai https://mcp.tax2.ai/mcp
# 본인 법제처 OC 사용 시
claude mcp add --transport http tax2ai https://mcp.tax2.ai/mcp --header "X-Lawgo-OC: 본인OC"

Claude Code 플러그인 (권장)

MCP 연결, /semu 검토 스킬, 실무 서브에이전트 5종을 한 번에 설치합니다. 설치할 때 본인 법제처 OC를 선택 입력합니다(민감 정보로 저장).

/plugin marketplace add taip-tech/tax2ai-mcp
/plugin install tax2ai@tax2ai

사용: /semu 2021 사업연도 법인세 경정청구 기한은? · /semu deep 대표이사 가지급금 인정이자와 손금불산입 범위

Claude 웹·데스크톱: 설정 → 커넥터 → 사용자 지정 커넥터 추가 → https://mcp.tax2.ai/mcp → 연결 → TAX2 계정(카카오)으로 로그인 → 허용

본인 법제처 OC (필수): 공개 서버는 공용 키를 제공하지 않습니다. 신청 정보의 서버 도메인에 mcp.tax2.ai를 등록한 뒤 tax2.ai/mypage/office에 OC를 저장합니다. 커넥터 주소는 그대로 둡니다.

비회원: 커넥터 주소 끝에 본인 OC를 붙이면 로그인 없이 씁니다: https://mcp.tax2.ai/mcp?oc=본인OC (신청 정보에 mcp.tax2.ai 등록 필요. 사무소·강의 제출 기능은 로그인 필요)

수강생이라면 → docs/STUDENT_GUIDE.md부터 보세요.

출력은 참고자료이며 유권해석이 아닙니다. 법적 효과가 있는 판단은 원문 확인과 세무사 검토를 거치세요.

빠른 시작

npm install
npm run build
cp .env.example .env   # LAWGO_OC 입력

OC 발급

  1. open.law.go.kr 가입 → OPEN API 사용 신청

  2. 호출할 서버의 IP 또는 도메인 등록 (미등록 시 KEY_REJECTED)

  3. 승인 후 OC 값(가입 이메일 ID)을 LAWGO_OC에 설정

Claude Code 연결

저장소의 .mcp.json이 tax2ai 서버를 등록합니다. 셸에 export LAWGO_OC=... 후 이 폴더에서 Claude Code를 실행하세요.

또는 전역 등록:

claude mcp add tax2ai --env LAWGO_OC=발급값 -- node /절대경로/tax2ai_MCP/dist/cli.js

Claude Desktop 연결

{
  "mcpServers": {
    "tax2ai": {
      "command": "node",
      "args": ["/절대경로/tax2ai_MCP/dist/cli.js"],
      "env": { "LAWGO_OC": "발급값" }
    }
  }
}

HTTP 모드 (자체 서버)

HTTP_HOST=0.0.0.0 MCP_ACCESS_TOKEN=긴임의값 LAWGO_OC=발급값 npm run start:http
# POST http://서버:8787/mcp  (Authorization: Bearer 긴임의값)
# GET  http://서버:8787/healthz

Related MCP server: korea-tax-law

출처 표기 (Powered by TAX2.AI)

  • 모든 도구 응답 끝: Powered by TAX2.AI 세무 법령 MCP · 원문 출처: 법제처 국가법령정보센터

  • AI 최종 답변 맨 아래(서버 지침으로 요청): — 이 답변은 TAX2.AI 세무 법령 MCP(https://tax2.ai)를 활용하여 AI가 작성했습니다. (인공지능기본법상 생성형 AI 결과물 고지를 겸함)

  • BRAND_ATTRIBUTION=0으로 끌 수 있고, BRAND_NAME·BRAND_URL로 문구를 바꿀 수 있습니다.

도구 (23)

도구

용도

네트워크

find_statute

법령명(줄임말)·본문 키워드 검색

●

read_provision

조문·항 원문, asOf 시점 조회, 시행 예정 경고, 목차

●

read_transition_rules

부칙의 시행일·적용례·경과조치 (어느 사업연도부터 적용되는지)

●

trace_amendments

시행일별 버전, 조문 문언 변경 시점

●

trace_delegation

법률↔시행령↔시행규칙 위임·인용 연결

●

compare_revision

신구조문 대비

●

find_rulings

판례·헌재·조세심판원·법제처 해석례 통합 검색

●

read_ruling

결정례 본문 (섹션 선택)

●

find_admin_rule

기본통칙·고시·훈령 검색/본문

●

find_form

별표·서식 + HWP/PDF 링크

●

explain_term

법령용어 정의

●

check_references

초안 인용 조문 점검

●

build_issue_brief

쟁점별 법령·행정규칙·결정례 후보 일괄 수집

●

estimate_tax

법인세(20182026 개시)·종합소득세(20212026) 산출세액

–

tax_deadline

법정신고기한·경정청구·제척기간·후발적 경정청구

–

estimate_penalty

무신고·과소신고·납부지연 가산세, 수정·기한후신고 시점별 감면

–

entertainment_limit

기업업무추진비 한도·한도초과액 (2020~2026 개시)

–

deemed_interest

가지급금 적수·인정이자, 5%·3억원 기준 판정

–

find_treaty

조세조약 검색·본문 (키워드 필터)

●

office_profile

사무소 정보(사무소명·대표세무사·연락처·자료 제출 방법·말투) 등록·조회. 로그인 계정별 저장

–

draft_document_request

세목별 신고 자료요청문 (카톡·이메일·공문). 서류 체크리스트·신고기한·자료 마감일 자동

–

draft_job_posting

세무사무소 채용공고 (근무세무사·사무장·경력·신입·단기) + 법률 점검

●

check_job_posting

기존 공고 문구의 연령·성별·신체·개인정보·무급수습 표현과 최저임금 점검 (근거 조문 원문 확인)

●

필수 정보가 빠지면 사무소 도구는 [NEEDS_INPUT] 객관식 질문 목록을 돌려주고, AI가 사용자에게 선택지로 보여 준 뒤 고른 값으로 다시 호출합니다.

긴 응답은 [MORE] … cursor=N 안내가 붙으며, 같은 인자에 cursor를 넣어 이어받습니다.

프롬프트 (5)

refund_claim_review(경정청구 검토) · opinion_citation_audit(의견서 인용 점검) · client_question_memo(고객 질의 답변 메모) · document_request(신고 자료요청문) · job_posting(채용공고 작성)

서브에이전트 (.claude/agents/)

구분

에이전트

역할

개발

lawgo-api-engineer

법제처 연동·필드 매핑

개발

tax-rule-curator

세율표·기한·약칭 개정 반영

개발

mcp-qa-verifier

회귀·프로토콜·라이브 스모크

실무

statute-navigator

조문·위임·개정 조사

실무

precedent-analyst

결정례 수집·유불리 분류

실무

refund-claim-examiner

경정청구 검토 전 과정

실무

citation-auditor

인용 검수

실무

memo-drafter

검토메모·답변서 작성

개발

npm run dev         # tsx로 stdio 실행
npm run typecheck
npm test            # 단위 + 가짜 업스트림 통합 테스트

문서: RFP · 업무 계획 · 아키텍처 · 배포

라이선스 · 개인정보

알려진 제약

  • 법제처 응답 필드명은 실데이터로 검증 전 후보 매핑 상태입니다 (특히 조세심판원·3단비교·신구조문·법령용어). WORKPLAN.md Phase 2 참조.

  • 휴일 순연은 주말·양력 고정 공휴일만 자동 반영합니다. 설·추석·대체공휴일은 extraHolidays로 넣으세요.

  • 2026.1.1. 이후 개시 사업연도 법인세율(10/20/22/25%)은 원문 대조 전 caution 상태입니다.

Available Tools

19 tools
build_issue_brief쟁점 자료 묶음A
Read-onlyIdempotent

하나의 세무 쟁점에 대해 관련 법령 조문(본문 검색), 행정규칙, 판례·심판례·해석례 후보를 한 번에 모아 후속 조회용 식별자와 함께 돌려줍니다. 검토메모 작성의 첫 단계로 사용하세요.

Inputs: issue (required), cursor, perSource, rulingSources.

check_references인용 조문 점검A
Read-onlyIdempotent

의견서·검토메모·답변 초안에 적힌 조문 인용(예: '법인세법 시행령 제89조제3항', '같은 법 제52조')을 뽑아 실제 존재·삭제 여부와 항·호 범위를 법제처 원문과 대조합니다. 문언의 의미가 맞는지까지는 판단하지 않습니다.

Inputs: draft (required), asOf, defaultLaw.

compare_revision신구조문 대비B
Read-onlyIdempotent

법령의 최근 개정 전후 문언(신구조문 대비표)을 보여줍니다. article로 특정 조만 걸러낼 수 있습니다.

Inputs: law (required), cursor, article.

deemed_interest가지급금 인정이자A
Read-onlyIdempotent

특수관계인 가지급금 잔액 구간으로 적수와 인정이자를 계산하고, 실제 받은 이자와의 차이가 부당행위계산 기준(5% 또는 3억원)에 걸리는지 판정합니다.

Inputs: ratePct (required), rateKind (required), segments (required), yearDays, +1 more.

entertainment_limit기업업무추진비 한도A
Read-onlyIdempotent

법인의 기업업무추진비(접대비) 손금 한도와 한도초과액을 계산합니다. 기본한도(중소기업 여부·사업연도 월수)와 수입금액 기준 한도(특수관계인 거래분 10%)를 반영합니다.

Inputs: sme (required), revenue (required), fiscalStart (required), spent, +3 more.

estimate_penalty가산세 추정 (감면 포함)A
Read-onlyIdempotent

무신고·과소신고 가산세와 납부지연가산세를 계산하고, 수정신고·기한후신고 시점에 따른 감면율(국세기본법 제48조)을 적용합니다. 수정신고 시점별 부담 비교에 사용하세요.

Inputs: kind (required), dueDate (required), shortTax (required), fraud, +3 more.

estimate_tax산출세액 계산A
Read-onlyIdempotent

과세표준으로 법인세(사업연도 개시일 기준) 또는 종합소득세(귀속연도 기준) 산출세액을 누진 구간별로 계산합니다. 등록되지 않은 연도는 계산하지 않습니다.

Inputs: taxBase (required), taxType (required), year, months, +1 more.

explain_term법령용어 풀이A
Read-onlyIdempotent

법령에서 정의한 용어(예: 특수관계인, 사업연도, 내국법인)의 법령별 정의와 출처를 보여줍니다. law를 주면 그 법령의 정의만 남깁니다.

Inputs: term (required), law.

find_admin_rule행정규칙 (기본통칙·고시·훈령·예규)A
Read-onlyIdempotent

국세청·재정경제부 등의 행정규칙(훈령·예규·고시, 예: 법인세 사무처리규정)을 검색하거나(query), id로 본문을 읽습니다. 국세청 기본통칙·집행기준은 법제처 자료에 없으므로 국세법령정보시스템에서 확인해야 합니다.

Inputs: id, limit, query, cursor, +1 more.

find_form별표·서식 찾기B
Read-onlyIdempotent

세법 시행규칙 서식(신고서·명세서)과 별표(세율표·기준표)를 찾고 HWP/PDF 내려받기 링크를 제공합니다.

Inputs: query (required), limit, byLawName.

find_rulings결정례·해석례 찾기A
Read-onlyIdempotent

판례·헌재 결정·조세심판원 심판례·법제처 해석례를 한 번에 검색합니다 (court=법원 판례, constitutional=헌재 결정, tribunal=조세심판원 심판례, moleg=법제처 법령해석례). 결과의 source/id를 read_ruling에 넘기세요.

Inputs: query (required), sources, fullText, perSource.

find_statute세법 법령 찾기A
Read-onlyIdempotent

법령명(줄임말 자동 확장) 또는 본문 키워드로 법률·시행령·시행규칙을 찾습니다. 결과의 법령명을 read_provision 등에 그대로 넘기면 됩니다.

Inputs: query (required), page, limit, scope.

find_treaty조세조약 찾기A
Read-onlyIdempotent

조세조약(이중과세방지협약)을 국가명으로 찾거나(예: 미국, 베트남, 일본) id로 본문을 읽습니다. 국가명을 넣으면 조세조약만 골라 보여주고, keyword로 본문 중 필요한 부분(배당, 이자, 고정사업장 등)만 볼 수 있습니다.

Inputs: id, limit, query, cursor, +1 more.

read_provision조문 원문 읽기A
Read-onlyIdempotent

법령의 특정 조문(및 항) 원문을 가져옵니다. asOf로 과거·미래 시점 버전을 볼 수 있고, 시행 예정 개정이 있으면 경고를 붙입니다. article을 생략하면 조문 목차를 돌려줍니다.

Inputs: law (required), asOf, cursor, article, +1 more.

read_ruling결정례·해석례 본문A
Read-onlyIdempotent

find_rulings 결과의 source와 id로 요지·주문·이유 등 본문을 읽습니다.

Inputs: id (required), source (required), cursor, sectionsOnly.

read_transition_rules부칙 (시행일·적용례·경과조치)A
Read-onlyIdempotent

법령 부칙에서 시행일, 적용례("~이후 개시하는 사업연도분부터 적용"), 경과조치를 찾습니다. 개정 조문이 어느 사업연도·귀속연도부터 적용되는지 판단할 때 사용하세요. keyword로 특정 조문을 언급한 부칙만 걸러낼 수 있습니다.

Inputs: law (required), asOf, limit, cursor, +2 more.

tax_deadline신고·경정청구·제척기간A
Read-onlyIdempotent

세목과 과세기간 종료일로 법정신고기한, 경정청구 가능 기한(5년), 부과제척기간 만료일, 후발적 경정청구 기한을 계산합니다. 주말·고정 공휴일은 자동으로 다음 날로 넘깁니다.

Inputs: kind (required), periodEnd (required), today, abroad, +4 more.

trace_amendments조문 개정 흐름A
Read-onlyIdempotent

법령의 시행일별 버전 목록을 보여주고, article을 주면 최근 버전들 사이에서 해당 조문 문언이 바뀐 시점을 표시합니다. 귀속연도별 적용 조문 확인에 사용하세요.

Inputs: law (required), depth, cursor, article.

trace_delegation위임 법령 연결A
Read-onlyIdempotent

법률 조문이 시행령·시행규칙 어디로 위임되는지(또는 어디를 인용하는지) 법제처 3단 비교 자료로 보여줍니다. article을 주면 해당 조와 관련된 블록만 남깁니다.

Inputs: law (required), mode, cursor, article.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 19 tools

    Disambiguation4/5

    Each tool has a clearly stated purpose tied to a distinct artifact (statute text, amendment history, 부칙 적용례, 위임 구조, 신구조문, rulings, 행정규칙, 서식, 조약, 계산기). Mild overlap exists between build_issue_brief and the find_statute/find_rulings/find_admin_rule trio, and between trace_amendments and compare_revision/trace_delegation, but descriptions clarify the boundaries well enough that misselection is unlikely.

    Naming Consistency4/5

    The vast majority follow a clear verb_noun pattern (find_statute, read_provision, trace_amendments, compare_revision, estimate_tax, check_references, build_issue_brief). Three tools (tax_deadline, entertainment_limit, deemed_interest) break the verb pattern into bare noun phrases, which is a minor but noticeable deviation.

    Tool Count4/5

    19 tools is on the heavy side, but the domain (Korean tax law research plus computation) genuinely spans many distinct resource types and each tool covers a separate capability. The five calculators (estimate_tax, estimate_penalty, entertainment_limit, deemed_interest, tax_deadline) are each domain-specific rather than redundant, so the surface does not feel padded.

    Completeness4/5

    Coverage is strong across the legislative lifecycle (search, read, version trace, 부칙, 위임, 신구조문, citation validation) plus rulings, administrative rules, forms, treaties, and tax calculations, with no obvious dead ends for memo drafting. Gaps remain: no 국세청 기본통칙/집행기준 access (explicitly deferred to an external system), and calculators cover only corporate/comprehensive income tax, penalties, entertainment and deemed interest — no VAT or transfer/inheritance tax support.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to query and analyze Korean law, including statutes, precedents, and ordinances, with citation verification and impact analysis.
      10
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to retrieve current Korean tax statutes, judicial precedents, and tax authority interpretations via MCP, with daily-updated legislative history and full-text search.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Korean tax, accounting, and finance professionals to pull statute text, delegated enforcement decrees and rules, NTS rulings, and annexes in a single lookup, and to check whether every statute or article citation in an AI draft actually exists (±verified, missing, or unverifiable), with statutory-formula calculations for items like executive severance limits and entertainment-expense caps.
      7
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Korean tax law for AI agents: search NTS rulings, court and Tax Tribunal decisions; read point-in-time statutes with the Act → Decree → Rule chain and amendment history; basic rules and execution standards; 96 tax treaties with withholding rates; forms and schedules; and verify citations in drafts. Fact-pattern comparison is done by your AI (or optional on-prem/cloud Upstage Solar).
      14
      54
      4,055 PyPI
      10
      MIT