nts-taxlaw-mcp

Servidor MCP que consulta directamente el Sistema de Información de Legislación Tributaria Nacional (https://taxlaw.nts.go.kr) de la Agencia Tributaria Nacional (NTS).

Implementado con Python y FastMCP, utiliza los endpoints de consulta propios de la NTS sin pasar por el espejo del Ministerio de Legislación Gubernamental (ntsCgmExpc).

• Consulta de las interpretaciones tributarias más recientes

• Estructuración del contenido detallado: respuesta, juicio, conclusión, etc.

• Búsqueda exacta por número de documento

• Búsqueda de jurisprudencia, casos resueltos y criterios de interpretación administrativa

• Respuestas estructuradas que incluyen fuente y tipo de fundamento

El korean-law-mcp existente, debido a las características de la OPEN API del Ministerio de Legislación Gubernamental, puede buscar listados de interpretaciones de la NTS, pero tiene limitaciones para consultar el contenido detallado. nts-taxlaw-mcp consulta directamente la fuente original de la NTS para ofrecer búsqueda por número de documento y consulta del contenido detallado.

1. Datos compatibles

Volumen incluido

Según medición real de agosto de 2026.

Datos no compatibles

Para más información de la investigación, consulte docs/INVESTIGATION.md.

Related MCP server: korean-engineering-mcp

2. Fuente de datos

Todos los datos se consultan en el Sistema de Información de Legislación Tributaria Nacional de la NTS.

https://taxlaw.nts.go.kr

• Uso del endpoint público de consulta POST /action.do

• Sin evasión de inicio de sesión, CAPTCHA ni control de acceso

• No se requieren sesiones, cookies ni claves de autenticación adicionales

• Todas las respuestas incluyen información de trazabilidad del original

{
  "sourceAgency": "국세청",
  "sourceSystem": "국세법령정보시스템",
  "sourceId": "200000000000022584",
  "documentNumber": "서면-2026-법규재산-0119",
  "sourceUrl": "https://taxlaw.nts.go.kr/qt/USEQTA002P.do?ntstDcmId=200000000000022584",
  "retrievedAt": "2026-08-19T13:34:58Z"
}

3. Búsqueda por número de documento

Normaliza las diferencias de notación del número de documento para consultar el mismo documento.

서면-2026-법규재산-0119
서면 2026 법규재산 0119
서면2026법규재산0119
서면서면-2026-법규재산-0119
질의회신 서면-2026-법규재산-0119
질의회신서면-2026-법규재산-0119
국세청 서면-2026-법규재산-0119

Los formatos de número de documento verificados son los siguientes.

A y B se distinguen según si el segundo elemento es un año de 4 dígitos.

Principio de coincidencia exacta

정확히 일치
→ found: true
→ exactMatch: true
→ document 반환

일치 없음
→ NOT_FOUND
→ similarDocuments 별도 반환

Los documentos con coincidencia parcial no se devuelven como respuesta correcta.

lookup_tax_document("법규재산-0119")

→ [NOT_FOUND]

similarDocuments:
  · 서면-2026-법규재산-0119
  · 서면-2015-징세-0119
  · 기준-2023-법규부가-0044
  · 적부-국세청-2020-0119

similarDocuments es información auxiliar de búsqueda y no se considera el documento solicitado.

Los casos como 0119 y 119 que solo difieren en el relleno con ceros se tratan como el mismo número de documento. La normalización se utiliza únicamente para ampliar los candidatos de consulta; en la respuesta final se devuelve el número de documento original de la NTS tal cual.

4. Búsqueda por palabras clave

Se aplica la sintaxis de búsqueda basada en los resultados reales del Sistema de Información de Legislación Tributaria Nacional.

En MCP se utiliza de la siguiente manera.

{"query": "상속 공동상속주택"}                  # AND
{"query": "상속 증여", "match": "any"}         # OR
{"query": "상속", "exclude": ["증여"]}         # NOT
{"query": '"공동상속주택 소수지분" 양도'}       # 구절 검색

Tenga en cuenta lo siguiente al buscar:

• El operador OR utiliza la barra vertical ASCII |.

• ¦ (U+00A6) no funciona como OR.

• Si se pasa un campo de ordenación incorrecto, no se produce un error sino que se devuelven 0 resultados.

• El servidor solo utiliza DCM_RGT_DTM, FRS_RGT_DTM y SCORE, verificados mediante medición real.

5. Instalación

No es necesario instalar Python directamente ni crear un entorno virtual manualmente. uv gestiona el Python y los paquetes necesarios.

5.1 Instalación de uv

Windows

PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Si la política de la empresa restringe la ejecución de scripts:

winget install --id=astral-sh.uv -e

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Después de la instalación, abra una nueva terminal y verifique.

uv --version

5.2 Instalación del servidor

Se puede instalar directamente desde la dirección de GitHub.

uv tool install git+<GitHub 주소>

Después de la instalación, el comando nts-taxlaw-mcp se puede ejecutar desde cualquier ruta.

Verificación de la ubicación de instalación:

(Get-Command nts-taxlaw-mcp).Source

which nts-taxlaw-mcp

Rutas de instalación habituales:

Actualización:

uv tool upgrade nts-taxlaw-mcp

Desinstalación:

uv tool uninstall nts-taxlaw-mcp

5.3 Instalación desde el código fuente

Si desea modificar el código o ejecutar pruebas, descargue el repositorio y utilícelo.

git clone <GitHub 주소>
cd nts-taxlaw-mcp
uv sync

uv sync realiza las siguientes tareas:

• Verifica e instala el Python que cumple con requires-python = ">=3.11"

• Crea .venv en el directorio del proyecto

• Instala las dependencias según uv.lock

No es necesario activar el entorno virtual manualmente. Los comandos posteriores se ejecutan con uv run.

En entornos donde no se puede usar git, también puede descargar Code > Download ZIP desde GitHub, descomprimir y ejecutar uv sync.

Verificación de funcionamiento:

uv run nts-taxlaw-mcp --help
uv run python scripts/compare_with_site.py

5.4 Verificación de PATH

Si inmediatamente después de la instalación no encuentra el comando uv o nts-taxlaw-mcp, abra una nueva terminal y verifique.

uv tool update-shell

Verificación con ruta absoluta en Windows:

& "$env:USERPROFILE\.local\bin\uv.exe" --version

macOS / Linux:

~/.local/bin/uv --version

6. Conexión con Claude Code

Si se instaló con uv tool

claude mcp add nts-taxlaw -- nts-taxlaw-mcp

Si no encuentra el comando, verifique la ruta de instalación y especifique la ruta absoluta.

claude mcp add nts-taxlaw -- "C:\Users\<사용자>\.local\bin\nts-taxlaw-mcp.exe"

Si se ejecuta desde el repositorio

claude mcp add nts-taxlaw -- uv run --directory /절대경로/nts-taxlaw-mcp nts-taxlaw-mcp

Verificación del registro:

claude mcp list

Conexión HTTP

Ejecución del servidor:

nts-taxlaw-mcp --http --port 8000

Registro en Claude Code:

claude mcp add --transport http nts-taxlaw http://127.0.0.1:8000/mcp

7. Conexión con Claude Desktop

Archivo de configuración:

En Claude Desktop es más estable especificar la ruta absoluta del archivo ejecutable.

Windows

Instalación con uv tool:

{
  "mcpServers": {
    "nts-taxlaw": {
      "command": "C:\\Users\\<사용자>\\.local\\bin\\nts-taxlaw-mcp.exe"
    }
  }
}

Ejecución desde el repositorio:

{
  "mcpServers": {
    "nts-taxlaw": {
      "command": "C:\\Users\\<사용자>\\.local\\bin\\uv.exe",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\<사용자>\\nts-taxlaw-mcp",
        "nts-taxlaw-mcp"
      ]
    }
  }
}

En JSON, las barras invertidas de las rutas de Windows se escriben como \\. También se puede usar /.

macOS

Instalación con uv tool:

{
  "mcpServers": {
    "nts-taxlaw": {
      "command": "/Users/<사용자>/.local/bin/nts-taxlaw-mcp"
    }
  }
}

Ejecución desde el repositorio:

{
  "mcpServers": {
    "nts-taxlaw": {
      "command": "/Users/<사용자>/.local/bin/uv",
      "args": [
        "run",
        "--directory",
        "/Users/<사용자>/nts-taxlaw-mcp",
        "nts-taxlaw-mcp"
      ]
    }
  }
}

La ruta real se verifica con el siguiente comando.

(Get-Command nts-taxlaw-mcp).Source

which nts-taxlaw-mcp

Uso junto con korean-law-mcp

Se recomienda la configuración de consultar el texto de leyes, decretos de aplicación y reglamentos de aplicación en korean-law-mcp, y los materiales exclusivos de la NTS en nts-taxlaw-mcp.

{
  "mcpServers": {
    "korean-law": {
      "command": "npx",
      "args": ["-y", "korean-law-mcp"],
      "env": {
        "LAW_OC": "발급받은-인증키"
      }
    },
    "nts-taxlaw": {
      "command": "C:\\Users\\<사용자>\\.local\\bin\\nts-taxlaw-mcp.exe"
    }
  }
}

pip + venv

En entornos donde no se puede usar uv, se puede instalar Python 3.11 o superior directamente y ejecutar con el método tradicional.

git clone <GitHub 주소>
cd nts-taxlaw-mcp

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

python -m nts_taxlaw_mcp --help

Activación del entorno virtual en Windows:

.venv\Scripts\activate

En Claude Desktop, especifique la ruta absoluta del Python del entorno virtual.

{
  "mcpServers": {
    "nts-taxlaw": {
      "command": "/절대경로/nts-taxlaw-mcp/.venv/bin/python",
      "args": ["-m", "nts_taxlaw_mcp"]
    }
  }
}

8. Variables de entorno

Todos los elementos son opcionales y se puede ejecutar solo con los valores predeterminados.

9. Herramientas MCP

Se ofrecen un total de 9 herramientas.

Si conoce el número de documento, utilice primero lookup_tax_document.

get_tax_document integra la consulta detallada de interpretaciones y casos resueltos en una sola herramienta. Dado que la acción de consulta detallada del Sistema de Información de Legislación Tributaria Nacional es la misma independientemente del tipo de documento, no se divide en herramientas de consulta detallada separadas.

Ejemplos de uso

Consulta por número de documento:

{
  "name": "lookup_tax_document",
  "arguments": {
    "document_number": "서면-2026-법규재산-0119"
  }
}

Ejemplo de respuesta:

[OK]

found: true
exactMatch: true

서면-2026-법규재산-0119
질의회신 | 양도소득세 | 2026-08-11 | nts_ruling

title:
인구감소지역 내 취득한 분양권이 ’27.1.1.이후 주택으로 전환된 경우 조특법§71의2 적용 여부

relatedLaws:
- 조세특례제한법 제71조의2
- 조세특례제한법 시행령 제68조의2

sections:
- facts
- question
- relatedLawsText

Búsqueda de jurisprudencia y casos resueltos:

{
  "name": "search_tax_decisions",
  "arguments": {
    "query": "공동상속주택",
    "type": "court",
    "result": ["국승"],
    "limit": 3
  }
}

Búsqueda de reglas generales básicas:

{
  "name": "search_tax_guidance",
  "arguments": {
    "kind": "basic_ruling",
    "law_name": "상속세 및 증여세법",
    "query": "상속재산"
  }
}

Recopilación de fundamentos para consultas tributarias:

{
  "name": "tax_research",
  "arguments": {
    "question": "부모가 자녀에게 시가보다 낮은 가격으로 아파트를 양도하면 증여세가 발생하는지"
  }
}

10. Clasificación de fundamentos legales

Los materiales tributarios se devuelven clasificados según la naturaleza del fundamento.

Los precedentes administrativos de la NTS son interpretaciones de la legislación por parte de la autoridad tributaria y no vinculan a los tribunales. Las reglas generales y los criterios de ejecución son criterios internos de ejecución y no constituyen normas legales en sí mismos.

11. Gestión de errores

Se distingue entre los casos en que el material realmente no existe y los casos en que no se pudo consultar por problemas del servidor original.

En las respuestas de error se incluye información de guardrail para que el modelo no genere contenidos o conclusiones no verificados.

Incluso si la respuesta HTTP es 200, si se devuelve el HTML de la página de mantenimiento o el contenido está anormalmente vacío, se trata como una falla temporal y se reintenta.

12. Límite de solicitudes y caché

Se limita el volumen de llamadas y se reducen las consultas repetidas para no generar solicitudes excesivas al Sistema de Información de Legislación Tributaria Nacional.

Límite de solicitudes

• Límite de solicitudes predeterminado: 60 por minuto

• Capacidad de ráfaga: máximo 20

• Se utiliza el método de depósito de tokens considerando casos como tax_research donde varias solicitudes se suceden en una sola tarea

Caché

Gestión de solicitudes duplicadas

Si llegan solicitudes idénticas simultáneamente, solo se realiza una consulta real al Sistema de Información de Legislación Tributaria Nacional y se comparte el resultado.

Reutilización de conexiones HTTP

Se utiliza el grupo de conexiones keep-alive de httpx.

13. Aviso de exención de responsabilidad

• Este servidor es una capa de acceso a datos para la búsqueda y estructuración de los textos originales de la NTS y no proporciona juicios legales ni asesoramiento tributario.

• Las interpretaciones y los casos resueltos son juicios basados en la relación de hechos de cada caso individual.

• Los precedentes administrativos de la NTS son interpretaciones de la legislación por parte de la autoridad tributaria y no vinculan a los tribunales.

• Las reglas generales y los criterios de ejecución son criterios internos de ejecución y no son normas legales.

• Para la legislación modificada, se debe verificar por separado el momento de aplicación.

• La exactitud y actualidad de los datos dependen del estado de actualización del Sistema de Información de Legislación Tributaria Nacional.

• Para juicios que requieran efectos legales, se debe verificar el texto original del Sistema de Información de Legislación Tributaria Nacional.

• Las acciones con efectos legales como declaraciones reales o recursos de impugnación requieren la revisión de profesionales cualificados como asesores fiscales o abogados.

Licencia

MIT

Consulte NOTICE para la atribución de la fuente de datos.