
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).
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.
Installation
In SourceWeft
- Open CanLII in the dashboard and add it to a workspace.
- Connect Authorization token credentials. They are stored privately and never shown on public pages.
- 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.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
/healthroute, and a hosted endpoint atcanlii-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.
Use the hosted endpoint (no install)
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:
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
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
Tools
Requirements
- Node.js 22+
- A CanLII API key — apply here
Usage
stdio via npx (quickest)
stdio (from source)
Add to your MCP config:
HTTP server
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:
Docker
Or with Docker Compose:
Cloudflare Workers
The server includes a Workers-compatible entry point (src/worker.ts).
CLI deploy
Dashboard deploy (Connect to Git)
- Go to Cloudflare Dashboard → Workers & Pages → Create → Connect to Git
- Select your
tomilashy/canlii-mcprepository - 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)
- Project name:
- Expand Advanced settings:
- Variable name:
CANLII_API - Variable value: your CanLII API key
- Check Encrypt to store it as a secret
- Variable name:
- Click Deploy
The MCP endpoint will be at https://canlii-mcp.<your-subdomain>.workers.dev/mcp.
Configuration
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
Release
This project uses Semantic Versioning via semantic-release. Commit messages follow the Conventional Commits spec:
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
0Version history
2- v0.1.1LatestOct 26, 2026
- 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