CanLII

io.github.Vaquill-AIPublished by GitHub account Vaquill-AIv0.1.1Updated Oct 26, 2026

MCP for CanLII: Canadian case law and legislation metadata (federal, provincial, territorial).

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Remote MCP server for the CanLII API that lets an assistant browse Canadian case law and legislation metadata across federal, provincial and territorial…

What you can do
  • List courts, tribunals and statute/regulation databases in the CanLII collection
  • Browse decisions from a chosen court or tribunal database, and statutes or regulations from a chosen legislation database
  • Retrieve metadata for a specific case or piece of legislation: title, citation, date, keywords
  • Trace citation relationships: cases a decision cites, cases citing it, and legislation it references
When to use it
Useful when you need to look up Canadian legal citations, find decisions from a particular court, or follow citation links between cases and statutes. It is a metadata index, not a full-text source, so it suits research orientation rather than reading judgments in full.
Requirements
A CanLII API key, supplied per request in the X-CanLII-Token header or as a token query parameter on the hosted endpoint. No install is needed for the hosted endpoint; self-hosting requires Node.js 22+ and the CANLII_API environment variable, with an optional MCP_AUTH_TOKEN bearer gate.
Before you install
Your CanLII API key is a credential: the URL-parameter option puts it in the endpoint URL, which is less private than the header. Every call counts against your own CanLII quota (about 2 requests per second and 5,000 per day), and exceeding it returns errors. Requests go to the third-party hosted endpoint and onward to CanLII.

Installation

In SourceWeft

  1. Open CanLII in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Vaquill-AI%2Fcanlii-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "canlii": {
      "type": "http",
      "url": "https://canlii-mcp.vaquill.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

canlii-mcp

An MCP (Model Context Protocol) server for the CanLII Canadian legal information API. Gives AI assistants access to Canadian case law and legislation metadata across all federal, provincial, and territorial jurisdictions.

Forked from tomilashy/canlii-mcp. This fork adds bring-your-own-key (BYOK) auth, a /health route, and a hosted endpoint at canlii-mcp.vaquill.ai. Tools are unchanged.

Note: The CanLII API provides metadata only — titles, citations, dates, keywords, and citation relationships. Full document text is not available through the API.

[Discord]

Use the hosted endpoint (no install)

https://canlii-mcp.vaquill.ai/mcp

The hosted instance is public. No Vaquill token is required. Provide your own CanLII key one of two ways:

  • Header (recommended, keeps the key out of the URL): X-CanLII-Token: <your_canlii_api_key>

  • URL parameter (simplest; works in header-less clients like the Claude Desktop connector UI and claude.ai web): append ?token=<your_canlii_api_key> to the URL:

    https://canlii-mcp.vaquill.ai/mcp?token=YOUR_CANLII_API_KEY

Apply for a key via the CanLII API request form. The server never stores your key, and there is no server-side fallback key, so every call counts against your own CanLII quota.

Claude Desktop / Claude Code

json
{  "mcpServers": {    "canlii": {      "url": "https://canlii-mcp.vaquill.ai/mcp",      "headers": {        "X-CanLII-Token": "YOUR_CANLII_API_KEY"      }    }  }}

Cursor / VS Code / Windsurf

Same pattern: any client supporting MCP streamable HTTP with custom headers works. For stdio-only clients use mcp-remote to proxy.

Authentication

ModeHeaderWhen
BYOK header (preferred)X-CanLII-Token: <key>Hosted / shared deployments
BYOK URL param?token=<key> (or ?canlii_token=)Header-less clients: Claude Desktop connector UI, claude.ai web
Server fallback(env CANLII_API)Self-hosted single-tenant. Required for stdio.
MCP gateAuthorization: Bearer <MCP_AUTH_TOKEN>Optional, self-host only. The public hosted endpoint at canlii-mcp.vaquill.ai does not use it, so no bearer token is required.

Tools

ToolDescription
list_case_databasesList all courts and tribunals in the CanLII collection
list_casesBrowse decisions from a specific court/tribunal database
get_caseGet metadata for a specific case (title, citation, date, keywords)
get_case_citationsGet cases cited by a case, cases citing it, or legislation it references
list_legislation_databasesList all statute and regulation databases
list_legislationBrowse statutes or regulations from a specific database
get_legislationGet metadata for a specific piece of legislation

Requirements

Usage

stdio via npx (quickest)

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

stdio (from source)

bash
npm installnpm run buildnode dist/index.js

Add to your MCP config:

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

HTTP server

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

The MCP endpoint is available at http://localhost:3000/mcp. The server runs in stateless mode — each request is self-contained, no session ID or initialize handshake required. Clients can call tools directly:

bash
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

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

Or with Docker Compose:

yaml
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

The server includes a Workers-compatible entry point (src/worker.ts).

CLI deploy
bash
npx wrangler secret put CANLII_APInpx wrangler secret put MCP_AUTH_TOKEN  # optionalnpx wrangler deploy
Dashboard deploy (Connect to Git)
  1. Go to Cloudflare Dashboard → Workers & Pages → Create → Connect to Git
  2. Select your tomilashy/canlii-mcp repository
  3. On the Set up your application page:
    • Project name: canlii-mcp
    • Build command: npm install && npm run build
    • Deploy command: npx wrangler deploy (pre-filled)
  4. Expand Advanced settings:
    • Variable name: CANLII_API
    • Variable value: your CanLII API key
    • Check Encrypt to store it as a secret
  5. Click Deploy

The MCP endpoint will be at https://canlii-mcp.<your-subdomain>.workers.dev/mcp.

Configuration

Environment VariableRequiredDefaultDescription
CANLII_APIOnly for stdio and self-hosted single-tenant—Your CanLII API key. Not needed in HTTP mode, where clients bring their own key per request.
PORTNo3000HTTP server port (HTTP mode only)
MCP_AUTH_TOKENNo—Bearer token for HTTP authentication. If set, all HTTP requests must include Authorization: Bearer <token>. If not set, the server runs without authentication.

Rate Limits

The server enforces CanLII's API limits automatically, per CanLII key, so one caller's usage never throttles another's:

  • 1 request at a time
  • 2 requests per second
  • 5,000 requests per day

These mirror CanLII's own per-key limits. Each X-CanLII-Token gets its own independent budget (keyed by a hash of the key; raw keys are never retained). Requests that exceed the daily limit return an error rather than hitting the API.

Development

bash
npm installnpm run build      # compile TypeScriptnpm run watch      # watch mode

Release

This project uses Semantic Versioning via semantic-release. Commit messages follow the Conventional Commits spec:

Commit prefixRelease type
fix:Patch (1.0.0 → 1.0.1)
feat:Minor (1.0.0 → 1.1.0)
feat!: or BREAKING CHANGEMajor (1.0.0 → 2.0.0)

Pushing to main triggers the release workflow. If a release is cut, the Docker image is automatically built and published to ghcr.io.

License

MIT

Community

Questions, ideas, or want to contribute? Join the Vaquill community on Discord.

Source: README.md at commit fad5aa1

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

2
  1. v0.1.1LatestOct 26, 2026
  2. v0.1.0Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts