canlii-mcp
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 |
| Lista todos los tribunales y cortes en la colección de CanLII |
| Explora decisiones de una base de datos específica de un tribunal/corte |
| Obtiene metadatos de un caso específico (título, cita, fecha, palabras clave) |
| Obtiene casos citados por un caso, casos que lo citan o legislación a la que hace referencia |
| Lista todas las bases de datos de estatutos y reglamentos |
| Explora estatutos o reglamentos de una base de datos específica |
| Obtiene metadatos de una pieza legislativa específica |
Related MCP server: courtlistener-mcp
Requisitos
Node.js 22+
Una clave de API de CanLII — solicítala aquí
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.jsAgré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 httpEl 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-mcpO 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 deployDespliegue mediante panel de control (Conectar a Git)
Ve al Panel de control de Cloudflare → Workers & Pages → Create → Connect to Git
Selecciona tu repositorio
tomilashy/canlii-mcpEn la página Set up your application:
Project name:
canlii-mcpBuild command:
npm install && npm run buildDeploy command:
npx wrangler deploy(prellenado)
Expande Advanced settings:
Variable name:
CANLII_APIVariable value: tu clave de API de CanLII
Marca Encrypt para almacenarla como un secreto
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 |
| Sí | — | Tu clave de API de CanLII |
| No |
| Puerto del servidor HTTP (solo modo HTTP) |
| No | — | Token de portador (Bearer) para autenticación HTTP. Si se establece, todas las solicitudes HTTP deben incluir |
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 modeLanzamiento
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 |
| Parche ( |
| Menor ( |
| Mayor ( |
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 toolsget_caseGet CaseARead-onlyInspect
Get metadata for a specific case including title, citation, decision date, keywords, and URL.
Inputs: caseId (required), databaseId (required), language.
get_case_citationsGet Case CitationsARead-onlyInspect
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 LegislationARead-onlyInspect
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 DatabasesARead-onlyInspect
List all courts and tribunals in the CanLII collection with their database IDs.
Inputs: language.
list_casesList CasesBRead-onlyInspect
List decisions from a specific caselaw database. Returns case titles, citations, and IDs.
Inputs: databaseId (required), decisionDateAfter, decisionDateBefore, language, +4 more.
list_legislationList LegislationARead-onlyInspect
List statutes or regulations from a specific legislation database.
Inputs: databaseId (required), language.
list_legislation_databasesList Legislation DatabasesARead-onlyInspect
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
Scored across 7 tools
Each tool targets a distinct operation: retrieving specific case metadata, case citations, legislation, or listing various databases and documents. No functional overlap exists.
All tool names follow a consistent verb_noun pattern using snake_case, e.g., get_case, list_cases, get_legislation, making the API predictable.
7 tools is well-scoped for a legal database API, covering core retrieval and listing operations. Slightly on the smaller side but still appropriate.
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
Related MCP Connectors
Connect AI to millions of laws and court cases with the Lawstronaut MCP.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
AI governance MCP server for EU AI Act compliance and jurisdiction verification
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP Server providing AI agents access to over 3 million US court decisions via CourtListener and EU legislation via EUR-Lex, with tools for searching cases, citations, judges, and court information.621 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server providing AI agents access to CourtListener's comprehensive legal database, featuring semantic search, hybrid search, citation verification, and research tools.7MIT
- AlicenseAqualityBmaintenanceMCP server giving AI agents structured access to Canadian federal, provincial, and municipal government data.4553 PyPI62MIT
- AlicenseAqualityDmaintenanceLegalMCP 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.1869MIT