Argentina TFN MCP

Servidor MCP (Model Context Protocol) para consultar resoluciones y jurisprudencia del Tribunal Fiscal de la Nación (TFN) de la República Argentina. Conecta cualquier LLM compatible (Claude, Cursor, Antigravity) con el portal oficial del TFN para realizar búsquedas de resoluciones en materia impositiva y aduanera con fidelidad jurídica sin alucinaciones.

🚀 Características Principales

• Búsqueda General (buscar_resoluciones_tfn): Busca jurisprudencia y resoluciones del TFN con filtros avanzados (competencia, tribunal, tipo de búsqueda, sala, vocalía, fechas).
• Búsqueda por Expediente (tfn_buscar_resolucion_por_expediente): Busca una resolución específica por su número de expediente exacto.
• Búsqueda por Carátula (tfn_buscar_resolucion_por_caratula): Busca resoluciones filtrando por el nombre de las partes involucradas.
• Búsqueda por Hechos (tfn_buscar_por_hechos): Busca jurisprudencia por hechos del caso en lenguaje natural.
• Búsqueda por Sumarios (tfn_buscar_por_sumarios): Busca jurisprudencia por sumarios de las resoluciones.
• Búsqueda de Antecedentes (tfn_buscar_antecedentes): Busca casos similares o antecedentes jurisprudenciales relacionados con un tema específico.
• Búsqueda Especializada Impositiva (tfn_buscar_ultimos_impositivos): Buscador especializado de fallos impositivos recientes.
• Búsqueda Especializada Aduanera (tfn_buscar_ultimos_aduaneros): Buscador especializado de fallos aduaneros recientes.
• Texto Íntegro (obtener_resolucion_tfn): Obtiene el cuerpo íntegro de la resolución con todos los datos disponibles (expediente, registro, sala, vocalía, competencia, fecha, sumarios, síntesis).
• Resumen IA (tfn_obtener_resumen_ia): Obtiene el resumen generado por IA de una resolución específica.
• Descarga PDF (tfn_descargar_resolucion_pdf): Descarga el documento PDF original de una resolución y lo retorna como archivo.
• Verificación de Vigencia (tfn_verificar_vigencia): Verifica la disponibilidad de un fallo en el sistema del TFN y muestra sus datos de identificación.
• Estadísticas (tfn_obtener_estadisticas): Obtiene estadísticas actualizadas del TFN (resoluciones totales, fallos por tribunal, doctrinas identificadas).
• Filtros Disponibles (tfn_obtener_filtros): Obtiene los filtros disponibles para búsqueda (tribunales, salas, vocalías, competencias).
• Últimos Casos (tfn_obtener_ultimos_casos): Obtiene los casos más recientes publicados en el TFN.
• Alcance de Fuente (alcance_fuente): Informa capacidades, fuentes de datos, limitaciones y disclaimer del conector.

🛠️ Instalación y Configuración Rápida

Para utilizar este servidor MCP de forma inmediata, necesitas tener instalado Node.js (versión 18 o superior).

1. Cursor IDE / Windsurf

Tanto Cursor como Windsurf admiten servidores MCP de forma nativa a través del protocolo standard I/O (stdio):

1. Abre la configuración (Settings) de tu entorno y busca la sección MCP.
2. Haz clic en + Add New MCP Server.
3. Completa los campos requeridos:
   • Name: tfn-mcp
   • Type: command
   • Command: node
   • Args: D:/MCP/Legales/08-tfn-mcp/Argentina-TFN-MCP/build/index.js
   • Env: NODE_TLS_REJECT_UNAUTHORIZED=0

2. Claude Desktop

1. Abre tu archivo de configuración de Claude Desktop. En Windows: C:\Users\<TuUsuario>\AppData\Roaming\Claude\claude_desktop_config.json
2. Agrega el servidor dentro de la clave mcpServers:

{
  "mcpServers": {
    "tfn-mcp": {
      "command": "node",
      "args": ["D:/MCP/Legales/08-tfn-mcp/Argentina-TFN-MCP/build/index.js"],
      "env": {
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

[!IMPORTANT] La variable de entorno "NODE_TLS_REJECT_UNAUTHORIZED": "0" es fundamental para saltear problemas periódicos con los certificados SSL vencidos o mal configurados de los sitios gubernamentales argentinos.

3. Antigravity / Codex

Configura el servidor en tu archivo de configuración global mcp_config.json:

{
  "mcpServers": {
    "tfn-mcp": {
      "command": "node",
      "args": ["D:/MCP/Legales/08-tfn-mcp/Argentina-TFN-MCP/build/index.js"],
      "env": {
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

💻 Instalación Manual (Para Desarrolladores)

Si deseas descargar el código fuente, auditar la lógica de scraping o contribuir al desarrollo local:

1. Ubícate en el directorio del conector:

   cd 08-tfn-mcp/Argentina-TFN-MCP

2. Instala las dependencias:

   npm install

3. Compila el código TypeScript a JavaScript:

   npm run build

4. Ejecuta el servidor compilado:

   npm start

⚖️ Catálogo de Herramientas Disponibles (16 Tools)

El servidor expone 16 herramientas (tools) diseñadas para consultar resoluciones y jurisprudencia del Tribunal Fiscal de la Nación.

| Herramienta | Descripción | Parámetro principal | |---|---|---| | buscar_resoluciones_tfn | Búsqueda general con filtros avanzados (competencia, tribunal, tipo de búsqueda) | criterio | | tfn_buscar_resolucion_por_expediente | Búsqueda por número de expediente exacto | numero_expediente | | tfn_buscar_resolucion_por_caratula | Búsqueda por nombre de las partes (carátula) | caratula | | tfn_buscar_por_hechos | Búsqueda por hechos del caso en lenguaje natural | consulta | | tfn_buscar_por_sumarios | Búsqueda por sumarios de las resoluciones | consulta | | tfn_buscar_antecedentes | Búsqueda de casos similares o antecedentes jurisprudenciales | tema | | tfn_buscar_ultimos_impositivos | Buscador especializado de fallos impositivos recientes | criterio | | tfn_buscar_ultimos_aduaneros | Buscador especializado de fallos aduaneros recientes | criterio | | obtener_resolucion_tfn | Texto íntegro de la resolución con todos los datos disponibles | idResolucion | | tfn_obtener_resumen_ia | Resumen generado por IA de una resolución específica | id_resolucion | | tfn_descargar_resolucion_pdf | Descarga del documento PDF original como archivo | id_resolucion | | tfn_verificar_vigencia | Verificación de disponibilidad y datos de identificación del fallo | id_fallo | | tfn_obtener_estadisticas | Estadísticas actualizadas del TFN | (ninguno) | | tfn_obtener_filtros | Filtros disponibles para búsqueda (tribunales, salas, vocalías) | (ninguno) | | tfn_obtener_ultimos_casos | Casos más recientes publicados en el TFN | limit | | alcance_fuente | Cobertura, capacidades y disclaimer del conector | (ninguno) |

Prompts: buscar_resoluciones, auditar_criterio_tfn, buscar_por_hechos, buscar_por_sumarios, obtener_estadisticas_tfn, obtener_filtros_tfn, obtener_ultimos_casos_tfn.

Parámetros detallados: TOOLS.md.

📝 Licencia

Este proyecto se distribuye bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.