Skip to main content
Glama

up-law-argleg-mcp

Servidor MCP que expone el corpus legal de la base up_law_argleg_db (legislacion nacional argentina + jurisprudencia CSJN + tratados internacionales de Cancilleria) a Claude, con proveniencia verificable en cada respuesta: el abogado puede rastrear cada texto al documento oficial capturado (sha256 + fecha + URL de InfoLEG) y auditar cualquier cita textual con el tool verificar_cita.

Requisitos

  • Docker Desktop (Postgres 16 + pgvector via docker compose del proyecto infoleg)

  • Python >= 3.12 y uv

  • La base up_law_argleg_db cargada (ver proyecto hermano ../infoleg)

Related MCP server: bora-mcp

Instalacion (macOS / Windows)

# 1. base con pgvector (en el proyecto infoleg)
cd ../infoleg && docker compose up -d

# 2. dependencias
cd ../mcp-v2 && uv sync

# 3. schema mcp + roles (idempotente)
uv run up-law-argleg-mcp setup-db

# 4. embeddings (primera vez: 2-4 h; incrementales: minutos)
uv run up-law-argleg-mcp index

# 5. smoke
uv run up-law-argleg-mcp status

Claude Desktop

Agregar a claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "up_law_argleg": {
      "command": "uv",
      "args": ["run", "--directory", "/RUTA/ABSOLUTA/a/mcp-v2", "up-law-argleg-mcp", "serve"]
    }
  }
}

En Windows la ruta usa barras invertidas escapadas: C:\\Users\\...\\mcp-v2.

Servidor HTTP (clientes remotos)

Ademas del modo stdio, el servidor puede exponerse por Streamable HTTP (el transporte que aceptan los conectores remotos de claude.ai y el parametro mcp_servers de la API):

uv run up-law-argleg-mcp serve-http                # 127.0.0.1:8000
uv run up-law-argleg-mcp serve-http --host 0.0.0.0 --port 9000

El endpoint MCP queda en http://HOST:PORT/mcp, en modo stateless (apto para escalar horizontalmente). Configuracion via .env:

  • HTTP_HOST, HTTP_PORT: interfaz y puerto de escucha.

  • HTTP_ALLOWED_HOSTS: lista JSON de dominios publicos aceptados en el header Host al desplegar detras de un proxy (p.ej. '["mcp.ejemplo.ar"]'); vacia = solo localhost, proteccion DNS-rebinding default del SDK.

  • HTTP_RATE_RPM, HTTP_RATE_BURST: rate limit por IP (token bucket, default 120 rpm / burst 20; HTTP_RATE_RPM=0 lo desactiva). Al exceder responde 429 con Retry-After.

  • DB_POOL_MAX: conexiones simultaneas maximas del pool de lectura (default 10).

Las consultas a la base van por un pool de conexiones (psycopg_pool), asi que multiples clientes concurrentes se atienden en paralelo.

Operacion

  • Tras cada sync mensual del ETL infoleg: uv run up-law-argleg-mcp index.

  • uv run up-law-argleg-mcp status muestra frescura y cobertura.

  • Tests: uv run pytest (unit) | uv run pytest -m live (requiere base) | uv run pytest -m model (carga el modelo de embeddings).

Garantia de fidelidad

  • El servidor se conecta con un rol de solo lectura (mcp_reader).

  • Los tools devuelven texto verbatim; el servidor jamas resume.

  • Cada texto viaja con bloque fuente (sha256 del documento oficial, fecha de captura, URL, offsets).

  • verificar_cita confirma si una cita existe literalmente en el corpus, y detecta citas casi-correctas mostrando el diff contra el texto real.

  • La base no determina vigencia: expone el grafo de modificaciones y las observaciones de InfoLEG; el analisis juridico es del profesional.

Créditos

Proyecto de la Facultad de Derecho de la Universidad de Palermo — Palermo E-Law / Innovation Hub.

Equipo: Hernán Quadri, Juan Cruz Romano, Aníbal Ramírez y Guido Barosio.

Available Tools

13 tools
buscar_articulosA

Busqueda profunda sobre 1,2M articulos vigentes (hibrida: semantica + FTS). Para "que norma regula X" cuando no sabes donde mirar. El texto devuelto es literal de la base, con proveniencia.

Inputs: query (required), limit, tipo_norma.

buscar_fallosB

Busca jurisprudencia CSJN (hibrida sobre sumarios + texto de fallos). voces filtra por descriptor tematico del sumario (ILIKE).

Inputs: query (required), limit, voces, anio_desde, +1 more.

buscar_normasA

Busca normas por texto libre sobre titulos y resumenes oficiales (FTS), con filtros por tipo (Ley/Decreto/...), organismo y rango de fecha_boletin (YYYY-MM-DD). Devuelve id canonico e id_norma; usar cualquiera en los otros tools.

Inputs: query (required), tipo, limit, organismo, +2 more.

buscar_tratadosB

Busca tratados internacionales (Cancilleria). Con query la busqueda es FTS sobre la ficha (titulo, partes, materias) + texto completo del tratado; sin query lista por filtros (p.ej. solo_jerarquia_constitucional=True da los tratados con jerarquia de la CN art. 75 inc. 22). contraparte filtra por pais/organismo; fechas de firma en YYYY-MM-DD. Usar ficha_id_opaco o id_tratado+catalogo en los otros tools.

Inputs: limit, query, materia, catalogo, +5 more.

estado_corpusA

Frescura y cobertura del corpus: ultima ingesta por etapa, conteos, cobertura de segmentacion y de embeddings.

Inputs: no named parameters.

leer_articulosA

Texto LITERAL de articulos de una norma, con proveniencia por articulo. articulos: "245", "240-250" o "14 bis, 245". Sin articulos devuelve todos. Cita el texto de forma textual y verifica cada cita con verificar_cita antes de responder. documento: texto_actualizado | texto_original (default: el actualizado si existe).

Inputs: ref (required), articulos, documento, fragmento.

leer_falloA

Texto completo LITERAL de un fallo, paginado en fragmentos. Citar textual y verificar con verificar_cita.

Inputs: id_fallo (required), fragmento.

leer_tratadoA

Texto completo LITERAL de un tratado (extraido del documento oficial de Cancilleria), paginado en fragmentos y con proveniencia (sha256 + URL). Citar textual y verificar con verificar_cita.

Inputs: ref (required), caso, catalogo, fragmento.

modificacionesC

Grafo de modificaciones de una norma segun InfoLEG. direccion: entrantes (que la modifican) | salientes (a cuales modifica) | ambas.

Inputs: ref (required), direccion.

obtener_falloC

Ficha de un fallo CSJN: caratula, fecha, tomo/pagina, sumarios completos con voces y holdings, y proveniencia del PDF.

Inputs: id_fallo (required).

obtener_normaA

Ficha completa de una norma: metadatos, textos capturados, indice de articulos, resumen de modificaciones y observaciones de InfoLEG. ref acepta id canonico (ley_20744), alias (ccyc) o id_norma numerico. La base NO determina vigencia: solo presenta el grafo de modificaciones.

Inputs: ref (required).

obtener_tratadoA

Ficha completa de un tratado: fechas del ciclo de vida (firma, entrada en vigor, ratificacion, denuncia...), contrapartes, firmantes, jerarquia constitucional si la tiene, normas aprobatorias vinculadas y archivos capturados. ref acepta ficha_id_opaco o id_tratado numerico (si el id existe en ambos catalogos, desambiguar con catalogo).

Inputs: ref (required), catalogo.

verificar_citaA

Verifica que un texto citado exista LITERALMENTE en el corpus. Resultados: VERIFICADA (con ubicacion y fuente) | NO_ENCONTRADA | NO_ENCONTRADA_CON_SIMILAR (existe un pasaje parecido, NO verificado, con diff). modo: estricta (solo whitespace flexible) | tolerante (tildes, mayusculas, comillas). Usar sobre toda cita textual antes de responder.

Inputs: texto (required), ref, modo, articulo.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 13 tools

    Disambiguation5/5

    Each tool targets a distinct operation and document type: buscar for search, leer for reading literal text, obtener for metadata, plus specialized tools for modifications, corpus status, and citation verification. No overlap.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in Spanish: buscar_ (search), leer_ (read), obtener_ (get). Exceptions like modificaciones, estado_corpus, and verificar_cita are nouns or verb+noun but are clearly differentiated and fit the domain.

    Tool Count5/5

    With 13 tools, the server covers all essential operations for legal research (search, read, metadata, modifications, citation verification) without being overwhelming. Each tool has a clear purpose.

    Completeness5/5

    The tool set provides a complete workflow: search across articles, rulings, norms, and treaties; read full literal texts; retrieve detailed metadata; explore modification graphs; verify citations; and check corpus health. No obvious gaps for the intended domain.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for searching and extracting official announcements, decrees, and resolutions from the Argentine Official Gazette (Boletín Oficial de la República Argentina). It enables LLMs to perform real-time searches and retrieve verbatim legal text with complete juridical fidelity.
      14
      19 npm
      3
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that enables searching and retrieving judicial decisions from the Uruguayan National Public Jurisprudence Database (BJN).
      -