Content
# Argentina JUBA - MCP Server
[](https://www.typescriptlang.org/)
[](https://modelcontextprotocol.io/)
[](https://juba-mcp.vercel.app)
MCP Server para buscar y extraer jurisprudencia de la **Suprema Corte de Justicia de la Provincia de Buenos Aires (SCBA)** ([juba.scba.gov.ar](https://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](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:** `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`:
```json
{
"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`:
```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](https://claude.ai/customize/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](https://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:
```json
{
"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:
```bash
git clone https://github.com/voftec/juba-mcp.git
cd juba-mcp
```
2. Instala las dependencias:
```bash
npm install
```
3. Compila el código TypeScript a JavaScript ESM:
```bash
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:**
```json
"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.
