Skip to main content
Glama

canlii-mcp

Un servidor MCP (Model Context Protocol) para la API de información legal canadiense CanLII. Proporciona a los asistentes de IA acceso a metadatos de jurisprudencia y legislación canadiense en todas las jurisdicciones federales, provinciales y territoriales.

Nota: La API de CanLII solo proporciona metadatos: títulos, citas, fechas, palabras clave y relaciones de citas. El texto completo de los documentos no está disponible a través de la API.

Herramientas

Herramienta

Descripción

list_case_databases

Lista todos los tribunales y cortes en la colección de CanLII

list_cases

Explora decisiones de una base de datos específica de un tribunal/corte

get_case

Obtiene metadatos de un caso específico (título, cita, fecha, palabras clave)

get_case_citations

Obtiene casos citados por un caso, casos que lo citan o legislación a la que hace referencia

list_legislation_databases

Lista todas las bases de datos de estatutos y reglamentos

list_legislation

Explora estatutos o reglamentos de una base de datos específica

get_legislation

Obtiene metadatos de una pieza legislativa específica

Related MCP server: courtlistener-mcp

Requisitos

Uso

stdio vía npx (más rápido)

{
  "mcpServers": {
    "canlii": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@tomilashy/canlii-mcp"],
      "env": {
        "CANLII_API": "your_api_key"
      }
    }
  }
}

stdio (desde el código fuente)

npm install
npm run build
node dist/index.js

Agrégalo a tu configuración de MCP:

{
  "mcpServers": {
    "canlii": {
      "command": "node",
      "args": ["/path/to/canlii-mcp/dist/index.js"],
      "env": {
        "CANLII_API": "your_api_key"
      }
    }
  }
}

Servidor HTTP

PORT=3000 CANLII_API=your_api_key node dist/index.js --transport http

El endpoint de MCP está disponible en http://localhost:3000/mcp. El servidor se ejecuta en modo sin estado: cada solicitud es independiente, no se requiere ID de sesión ni protocolo de enlace de inicialización. Los clientes pueden llamar a las herramientas directamente:

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_case_databases","arguments":{"language":"en"}}}'

Docker

docker run -e CANLII_API=your_api_key -e MCP_AUTH_TOKEN=your_secret -p 3000:3000 ghcr.io/tomilashy/canlii-mcp

O con Docker Compose:

services:
  canlii-mcp:
    image: ghcr.io/tomilashy/canlii-mcp
    environment:
      CANLII_API: your_api_key
      MCP_AUTH_TOKEN: your_secret  # optional
    ports:
      - "3000:3000"

Cloudflare Workers

El servidor incluye un punto de entrada compatible con Workers (src/worker.ts).

Despliegue mediante CLI

npx wrangler secret put CANLII_API
npx wrangler secret put MCP_AUTH_TOKEN  # optional
npx wrangler deploy

Despliegue mediante panel de control (Conectar a Git)

  1. Ve al Panel de control de Cloudflare → Workers & Pages → Create → Connect to Git

  2. Selecciona tu repositorio tomilashy/canlii-mcp

  3. En la página Set up your application:

    • Project name: canlii-mcp

    • Build command: npm install && npm run build

    • Deploy command: npx wrangler deploy (prellenado)

  4. Expande Advanced settings:

    • Variable name: CANLII_API

    • Variable value: tu clave de API de CanLII

    • Marca Encrypt para almacenarla como un secreto

  5. Haz clic en Deploy

El endpoint de MCP estará en https://canlii-mcp.<tu-subdominio>.workers.dev/mcp.

Configuración

Variable de entorno

Requerido

Predeterminado

Descripción

CANLII_API

Sí

—

Tu clave de API de CanLII

PORT

No

3000

Puerto del servidor HTTP (solo modo HTTP)

MCP_AUTH_TOKEN

No

—

Token de portador (Bearer) para autenticación HTTP. Si se establece, todas las solicitudes HTTP deben incluir Authorization: Bearer <token>. Si no se establece, el servidor se ejecuta sin autenticación.

Límites de tasa

El servidor aplica automáticamente los límites de la API de CanLII:

  • 1 solicitud a la vez

  • 2 solicitudes por segundo

  • 5,000 solicitudes por día

Las solicitudes que exceden el límite diario devuelven un error en lugar de llamar a la API.

Desarrollo

npm install
npm run build      # compile TypeScript
npm run watch      # watch mode

Lanzamiento

Este proyecto utiliza Semantic Versioning a través de semantic-release. Los mensajes de confirmación (commits) siguen la especificación Conventional Commits:

Prefijo de commit

Tipo de lanzamiento

fix:

Parche (1.0.0 → 1.0.1)

feat:

Menor (1.0.0 → 1.1.0)

feat!: o BREAKING CHANGE

Mayor (1.0.0 → 2.0.0)

Enviar cambios a main activa el flujo de trabajo de lanzamiento. Si se realiza un lanzamiento, la imagen de Docker se construye y publica automáticamente en ghcr.io.

Licencia

MIT

Available Tools

7 tools
get_caseGet CaseA
Read-only
Inspect

Get metadata for a specific case including title, citation, decision date, keywords, and URL.

Inputs: caseId (required), databaseId (required), language.

get_case_citationsGet Case CitationsA
Read-only
Inspect

Get citation information for a case: what it cites, what cites it, or what legislation it references. Note: the CanLII API currently only supports English for this endpoint; French requests will fall back to English.

Inputs: caseId (required), citationType (required), databaseId (required), language.

get_legislationGet LegislationA
Read-only
Inspect

Get metadata for a specific piece of legislation including title, citation, dates, and repeal status.

Inputs: databaseId (required), legislationId (required), language.

list_case_databasesList Case DatabasesA
Read-only
Inspect

List all courts and tribunals in the CanLII collection with their database IDs.

Inputs: language.

list_casesList CasesB
Read-only
Inspect

List decisions from a specific caselaw database. Returns case titles, citations, and IDs.

Inputs: databaseId (required), decisionDateAfter, decisionDateBefore, language, +4 more.

list_legislationList LegislationA
Read-only
Inspect

List statutes or regulations from a specific legislation database.

Inputs: databaseId (required), language.

list_legislation_databasesList Legislation DatabasesA
Read-only
Inspect

List all legislation and regulation databases in the CanLII collection.

Inputs: language.

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 7 tools

    Disambiguation5/5

    Each tool targets a distinct operation: retrieving specific case metadata, case citations, legislation, or listing various databases and documents. No functional overlap exists.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, e.g., get_case, list_cases, get_legislation, making the API predictable.

    Tool Count4/5

    7 tools is well-scoped for a legal database API, covering core retrieval and listing operations. Slightly on the smaller side but still appropriate.

    Completeness3/5

    The set covers basic CRUD-like read operations for cases and legislation, but lacks search/full-text query capabilities, which are common in legal research APIs.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP server giving AI agents structured access to Canadian federal, provincial, and municipal government data.
      4
      5
      53 PyPI
      62
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      LegalMCP is a comprehensive US legal MCP server that enables AI assistants to search over 4 million US court opinions, manage Clio practice data, and access PACER federal filings through natural language.
      18
      69
      MIT