tfn-mcp

# Argentina TFN MCP [](https://www.typescriptlang.org/) [](https://modelcontextprotocol.io/) [](https://tfn-mcp.vercel.app) [](https://www.npmjs.com/package/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](https://nodejs.org/) (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`: ```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" } } } } ``` > [!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`: ```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: ```bash cd 08-tfn-mcp/Argentina-TFN-MCP ``` 2. Instala las dependencias: ```bash npm install ``` 3. Compila el código TypeScript a JavaScript: ```bash npm run build ``` 4. Ejecuta el servidor compilado: ```bash 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](./TOOLS.md). --- ## 📝 Licencia Este proyecto se distribuye bajo la **Licencia MIT**. Consulta el archivo [LICENSE](./LICENSE) para más detalles.