# uy-legal-mcp

Suite de servidores MCP para fuentes legales uruguayas.
Equivalente uruguayo de la suite voftec (Argentina).

## Servidores incluidos

| Servidor | Fuente | Herramientas |
|---|---|---|
| `impo-uy-mcp` | IMPO - Centro de Información Oficial | Texto de normas, búsqueda, artículos |
| `bjn-uy-mcp` | BJN - Base de Jurisprudencia Nacional Pública | Búsqueda de sentencias, obtener sentencia |

---

## Requisitos

- Cuenta gratuita en [Cloudflare](https://dash.cloudflare.com/sign-up)
- Node.js 18+ instalado localmente
- npm

---

## Despliegue: impo-uy-mcp

### 1. Instalar dependencias

```bash
cd impo-uy-mcp
npm install
```

### 2. Autenticar con Cloudflare

```bash
npx wrangler login
```

Se abre el navegador para autenticarse con tu cuenta de Cloudflare.

### 3. Desplegar

```bash
npm run deploy
```

La URL del endpoint quedará en la salida del comando:
```
https://impo-uy-mcp.<tu-cuenta>.workers.dev
```

El endpoint MCP es:
```
https://impo-uy-mcp.<tu-cuenta>.workers.dev/mcp
```

### 4. Conectar en Claude.ai

1. Settings → Integrations → Add MCP Server
2. Pegar la URL: `https://impo-uy-mcp.<tu-cuenta>.workers.dev/mcp`
3. Confirmar y verificar que aparezca activo

### 5. Probar

Decirle a Claude:
- "Buscame la Ley de Procedimiento Administrativo uruguaya" → usa `impo_search`
- "Dame el artículo 5 de la Ley 15869 de 1987" → usa `impo_articulo`
- "Texto completo de la Ley 18331 de 2008" → usa `impo_norma`

---

## Despliegue: bjn-uy-mcp

Mismo procedimiento:

```bash
cd bjn-uy-mcp
npm install
npx wrangler login   # si no se hizo ya
npm run deploy
```

URL del endpoint:
```
https://bjn-uy-mcp.<tu-cuenta>.workers.dev/mcp
```

### Advertencia sobre estabilidad del BJN

El BJN usa JavaServer Faces (Seam), tecnología de 2008 que requiere
scraping del formulario. Si el Poder Judicial modifica la interfaz,
el conector puede dejar de funcionar.

Síntoma: `bjn_search` devuelve "no se pudo extraer el token de sesión".
Solución: acceso directo en bjn.poderjudicial.gub.uy y reportar el issue.

---

## Desarrollo local

Para probar antes de desplegar:

```bash
cd impo-uy-mcp
npm run dev
# El servidor corre en http://localhost:8787
# Endpoint MCP: http://localhost:8787/mcp
```

---

## Costos

Cloudflare Workers tiene una capa gratuita de **100.000 requests/día**.
Para uso en una práctica legal individual, es más que suficiente.
No se requiere tarjeta de crédito para el plan gratuito.

---

## Diferencias respecto a la suite voftec (Argentina)

| | voftec (AR) | uy-legal-mcp (UY) |
|---|---|---|
| Fuente normas | InfoLEG + BORA | IMPO |
| Jurisprudencia SCJ/federal | PJN Juris, CSJN | BJN |
| Jurisprudencia administrativa | — | BJN (TAC, TAF) |
| Boletín oficial | BORA, BOPBA | IMPO (incluye) |
| Tribunal Fiscal/Contencioso | TFN-mcp | — (TCA requiere suscripción) |
| Endpoint público sin deploy | Sí (Vercel) | Requiere deploy propio |

La diferencia en el punto de endpoint público es la más importante:
los servidores voftec están desplegados y disponibles para cualquiera.
Estos servidores requieren que cada usuario los despliegue en su propia
cuenta de Cloudflare Workers. La capa gratuita de Cloudflare hace que
el costo sea cero, pero el paso de despliegue inicial es necesario.

---

## Fuentes primarias

Si los conectores no están disponibles, el flujo de trabajo manual es:

| Necesidad | URL |
|---|---|
| Texto de norma (número conocido) | `https://www.impo.com.uy/bases/leyes/{año}-{número}` |
| Buscar normas | https://www.impo.com.uy |
| Jurisprudencia | https://bjn.poderjudicial.gub.uy/BJNPUBLICA/busquedaSimple.seam |

---

## Estado al junio 2026

- `impo-uy-mcp`: ESTABLE. La API de IMPO datos abiertos es estable y documentada.
- `bjn-uy-mcp`: FRÁGIL. Depende de scraping de portal web antiguo.

---

*Autor: Pi · junio 2026*
*Basado en el patrón de leguy-mcp (schilotte) y mcp-impo (daedalus)*