Argentina JUBA - MCP Server

MCP Server para buscar y extraer jurisprudencia de la Suprema Corte de Justicia de la Provincia de Buenos Aires (SCBA) (juba.scba.gov.ar). Conecta cualquier LLM compatible (Claude, Cursor, Antigravity) con el portal oficial JUBA para realizar búsquedas de fallos en tiempo real por fuero, materia, magistrado, período o voces jurídicas, y extraer el texto íntegro de las sentencias con fidelidad jurídica sin alucinaciones.

🚀 Características Principales

• Búsqueda por Fuero (buscar_fallos_civil_y_comercial, buscar_fallos_penal, y 5 más): 7 herramientas dedicadas, una por materia, con el filtro pre-aplicado. Sin necesidad de configurar nada — la tool ya apunta al fuero correcto del sistema JUBA.
• Búsqueda General (buscar_jurisprudencia): Consulta simultánea en todos los fueros. Punto de partida ideal cuando no se conoce la materia del expediente.
• Búsqueda por Campo Específico (buscar_por_voces_juridicas, buscar_por_magistrado, y 3 más): 5 herramientas de Búsqueda Integral que apuntan a campos precisos del sistema — voces indexadas, cuerpo del sumario, texto íntegro, carátula o juez votante.
• Filtros Temporales (buscar_jurisprudencia_reciente, buscar_jurisprudencia_por_periodo): Búsquedas acotadas por rango de fechas para rastrear la evolución de una doctrina en el tiempo.
• Filtros por Tipo de Voto (buscar_fallos_por_unanimidad, buscar_fallos_por_mayoria, buscar_votos_en_minoria): Discrimina fallos por unanimidad (SD), mayoría (MA) o minoría (MI), permitiendo identificar los precedentes más sólidos o las posiciones disidentes que anticipan cambios doctrinales.
• Búsqueda Avanzada Combinada (buscar_jurisprudencia_avanzada): La herramienta más completa — combina cualquier combinación de campos, fechas y tipo de voto en una sola llamada.
• Extracción de Sentencias Verbatim (obtener_sentencia): Descarga el texto íntegro de un fallo por ID numérico, formateado en el mismo orden que la vista oficial de JUBA (materia, tribunal, magistrados, carátula, texto completo hasta 50.000 caracteres).
• Resiliencia Criptográfica: Configurado con agentes HTTPS tolerantes a fallos para sortear bloqueos por certificados SSL en portales gubernamentales.

🛠️ 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: juba-mcp
   • Type: command
   • Command: npx -y juba-mcp

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": {
    "juba-mcp": {
      "command": "npx",
      "args": ["-y", "juba-mcp"]
    }
  }
}

3. Antigravity / Codex

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

{
  "mcpServers": {
    "juba-mcp": {
      "command": "npx",
      "args": ["-y", "juba-mcp"]
    }
  }
}

4. Claude Web (Claude.ai Custom Connectors)

[!TIP] ¿Estás utilizando Claude Web (Claude.ai)? ¡No necesitas instalar Node.js ni ejecutar nada localmente! Puedes conectar este servidor de forma 100% remota y serverless utilizando nuestro endpoint oficial.

Para conectarlo en segundos:

1. Ve a la sección de configuración de conectores en Claude.ai Connectors.
2. Haz clic en Add Connector o Connect Server.
3. Completa los campos requeridos:
   • Name: juba-mcp
   • URL: https://juba-mcp.vercel.app/api/mcp/sse
4. Guarda la configuración. ¡Listo! Claude Web ahora accede a la jurisprudencia bonaerense en tiempo real.

💡 ¿Necesitas ejemplos de prompts para usar correctamente este MCP? Consulta nuestra biblioteca interactiva con prompts óptimos en: juba-mcp.vercel.app/prompts

5. Antigravity / Codex (Integración SSE Remota)

Para la versión serverless de alta disponibilidad directamente en Antigravity u otros clientes compatibles con MCP SSE:

{
  "mcpServers": {
    "juba-mcp-sse": {
      "type": "sse",
      "url": "https://juba-mcp.vercel.app/api/mcp/sse"
    }
  }
}

💡 Ventaja de la integración SSE Remota: No requiere ejecutar comandos locales (npx), instalar Node.js ni consumir recursos en tu máquina, ya que se ejecuta de manera 100% serverless en Vercel Edge.

💻 Instalación Manual (Para Desarrolladores)

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

1. Clona el repositorio oficial:

   git clone https://github.com/voftec/juba-mcp.git
   cd juba-mcp

2. Instala las dependencias:

   npm install

3. Compila el código TypeScript a JavaScript ESM:

   npm run build

4. Configura tu cliente MCP local apuntando directamente al build:
   • Cursor Command: node D:/ruta-a-tu-carpeta/juba-mcp/build/index.js
   • Claude Desktop Config:

     "juba-mcp": {
       "command": "node",
       "args": ["D:/ruta-a-tu-carpeta/juba-mcp/build/index.js"]
     }

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

El servidor expone 21 herramientas especializadas organizadas en 8 grupos funcionales. Scraping real sobre ASP.NET WebForms — sin navegador, sin mocks.

| Grupo | Herramienta | Descripción | Parámetros | |---|---|---|---| | A – Por Fuero | buscar_fallos_civil_y_comercial | Fallos en el fuero Civil y Comercial de la SCBA. | criterio | | A – Por Fuero | buscar_fallos_penal | Fallos en el fuero Penal de la SCBA. | criterio | | A – Por Fuero | buscar_fallos_laboral | Fallos en el fuero Laboral de la SCBA. | criterio | | A – Por Fuero | buscar_fallos_contencioso_administrativo | Fallos en Contencioso Administrativo. | criterio | | A – Por Fuero | buscar_fallos_inconstitucionalidad | Fallos de Inconstitucionalidad de la SCBA. | criterio | | A – Por Fuero | buscar_fallos_conflicto_de_poderes | Fallos de Conflicto de Poderes. | criterio | | A – Por Fuero | buscar_fallos_enjuiciamiento_magistrados | Fallos de Enjuiciamiento de Magistrados. | criterio | | B – General | buscar_jurisprudencia | Búsqueda en todos los fueros simultáneamente. | criterio | | C – Por Campo | buscar_por_voces_juridicas | Busca en las voces indexadas por la SCBA. | voces | | C – Por Campo | buscar_en_texto_sumario | Busca en el cuerpo del sumario jurídico. | termino | | C – Por Campo | buscar_en_texto_completo_fallo | Busca en el texto íntegro del fallo. | termino | | C – Por Campo | buscar_por_caratula | Busca por nombre de las partes del expediente. | caratula | | C – Por Campo | buscar_por_magistrado | Todos los fallos de un juez votante específico. | magistrado | | D – Temporal | buscar_jurisprudencia_reciente | Jurisprudencia dictada desde 2024. | criterio | | D – Temporal | buscar_jurisprudencia_por_periodo | Jurisprudencia en un rango de fechas. | criterio, fecha_desde, fecha_hasta | | E – Por Voto | buscar_fallos_por_unanimidad | Fallos sin disidencia — SD (precedentes más sólidos). | criterio | | E – Por Voto | buscar_fallos_por_mayoria | Fallos por mayoría — MA (con votos en contra). | criterio | | E – Por Voto | buscar_votos_en_minoria | Votos en minoría — MI (anticipan cambios doctrinales). | criterio | | F – Avanzada | buscar_jurisprudencia_avanzada | Combina campos, fechas y tipo de voto en una llamada. | termino, en_voces, en_sumario, en_texto_completo, en_caratula, fecha_desde, fecha_hasta, tipo_voto | | G – Lectura | obtener_sentencia | Texto íntegro del fallo por ID numérico (hasta 50.000 chars). | id_fallo | | H – Info | juba_info | Describe la cobertura, fueros y herramientas disponibles. | (Ninguno) |

📊 Cobertura de Datos

| Tipo | Disponible desde | |---|---| | Sumarios SCBA (definitivas e interlocutorias) | 1984 | | Cámaras de Apelaciones de la PBA | 1990 | | Fallos in extenso — Civil y Comercial SCBA | 1986 | | Fallos in extenso — Otras materias SCBA | 1996 |

⚖️ Disclaimer

Este MCP no reemplaza asesoramiento jurídico profesional. Devuelve información desde fuentes públicas oficiales (SCBA — JUBA) y debe verificarse contra el portal oficial antes de uso probatorio o presentaciones formales.

📝 Licencia

Este proyecto se distribuye de forma abierta y transparente bajo los términos de la Licencia MIT. Consulta el archivo LICENSE para más detalles.