canlii-mcp
CanLII MCP Server
A Model Context Protocol (MCP) server for searching Canadian legal information via the CanLII API. Search cases, browse legislation, and check citations — all from Claude Desktop or Claude Code.
npx canlii-mcpFeatures
Full-text search — search across all of CanLII by keyword, case name, or legal concept
Case citator — check if a case is still good law by finding what later cases cite it
Legislation browsing — browse statutes and regulations by jurisdiction
Bilingual — English and French support across all tools including the citator
9 tools — search, browse courts, browse cases, case metadata, full citator, citator preview, legislation databases, browse legislation, legislation metadata
Built-in rate limiting — serialized request queue respects CanLII's API limits (2 req/sec, 1 concurrent, 5,000/day)
Input validation — all parameters regex-validated and URI-encoded to prevent injection
Minimal footprint — 2 runtime dependencies, ~500 lines of code, runs locally as a stdio process
Security-first — no file system access, no shell execution, only connects to
api.canlii.org
Related MCP server: canlii-mcp
Quick Start
Prerequisites: Node.js 18+ and a CanLII API key (free for research use).
Claude Desktop — add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"canlii": {
"command": "npx",
"args": ["-y", "canlii-mcp"],
"env": {
"CANLII_API_KEY": "your_api_key_here"
}
}
}
}Restart Claude Desktop after saving.
Claude Code:
claude mcp add canlii -e CANLII_API_KEY=your_key -- npx -y canlii-mcpFrom source (for development):
git clone https://github.com/mohammadfarooqi/canlii-mcp.git
cd canlii-mcp
npm install && npm run buildAvailable Tools (9)
search
Full-text keyword search across all of CanLII — cases, legislation, and commentary. This is the primary entry point for legal research.
search({ query: "material change in circumstances Ontario", resultCount: 10 })get_courts_and_tribunals
List all available court and tribunal databases. Returns database IDs needed by other tools.
Key Ontario databases: onsc (Superior Court), onca (Court of Appeal), oncj (Court of Justice), csc-scc (Supreme Court of Canada).
get_case_law_decisions
Browse case law decisions from a specific court database, ordered by most recently added. Supports date filters.
get_case_law_decisions({ databaseId: "onsc", resultCount: 20 })get_case_metadata
Get full details for a specific case — citation, decision date, docket number, keywords, and CanLII URL for reading the full decision.
get_case_metadata({ databaseId: "onsc", caseId: "2021onsc8582" })get_case_citator
Look up citation relationships for a case. Use citingCases to check if a case is still good law.
get_case_citator({ databaseId: "csc-scc", caseId: "1996canlii190", metadataType: "citingCases" })get_case_citator_tease
Quick citation preview returning max 5 results. Faster than the full citator for a quick check.
get_case_citator_tease({ databaseId: "csc-scc", caseId: "1996canlii190", metadataType: "citingCases" })get_legislation_databases
List all legislation databases. Ontario: ons (Statutes), onr (Regulations). Federal: cas (Statutes), car (Regulations).
browse_legislation
List legislation items within a specific database.
browse_legislation({ databaseId: "ons" })get_legislation_regulation_metadata
Get metadata for a specific statute or regulation, including its CanLII URL.
Typical Research Workflow
Search —
search({ query: "gatekeeping parenting time" })to find relevant casesGet details —
get_case_metadata(...)to get the full citation and CanLII URLCheck citations —
get_case_citator(..., metadataType: "citingCases")to verify the case is still good lawRead the decision — Click the CanLII URL to read the full text on canlii.org
API Rate Limits
Per CanLII's API terms:
5,000 queries per day
2 requests per second
1 request at a time
Metadata access only — full document text is not available via the API
The server enforces these limits automatically with a built-in rate limiter.
Development
npm run build # Compile TypeScript
npm run start # Run the server (needs CANLII_API_KEY env var)Project Structure
src/
index.ts # MCP server — tools, rate limiter, stdio transport
schema.ts # Zod schemas for CanLII API responsesContributing
Contributions are welcome! This project aims to make Canadian legal research more accessible through AI tooling.
Ways to contribute:
Report bugs or unexpected API behavior — open an issue
Suggest new tools or improvements — start a discussion
Submit a PR with fixes or new features
To submit a PR:
Fork this repository
Create a feature branch (
git checkout -b feature/my-improvement)Make your changes and test locally (
npm run build && CANLII_API_KEY=your_key npm run start)Commit and push to your fork
Open a pull request with a description of what you changed and why
If you find issues with the CanLII API responses, schema mismatches, or have ideas for new tools that would help legal researchers, please open an issue — even if you're not sure how to fix it. We'll investigate together.
Security
This server is designed to be transparent and minimal:
Only connects to
api.canlii.org— no other network calls, no telemetry, no analyticsAPI key stays local — passed via environment variable, never logged or included in responses
All inputs validated — database IDs, case IDs, and dates are regex-validated before use; path segments are URI-encoded
All API responses validated — parsed through Zod schemas before being returned
No file system access — the server only makes HTTPS calls to CanLII
No shell execution — no
child_process,exec, orspawn2 runtime dependencies —
@modelcontextprotocol/sdk(official Anthropic MCP SDK) andzod(schema validation)Rate limiter built in — serialized request queue prevents API abuse
MIT licensed, fully open source — read every line at src/index.ts (~350 lines) and src/schema.ts (~140 lines)
If you discover a security issue, please see SECURITY.md.
Known Limitations
No decision body text — full-text search works (searching across case titles, citations, and content), but the API cannot return the full text of a decision. You must click the CanLII URL to read the decision on canlii.org. Paragraph numbers and direct quotes need to be verified by reading the source.
Search is keyword-based, not semantic — queries like "mother gatekeeping sole decision-making" may return mixed results. Refine queries and check case titles before drilling into metadata.
Search results don't include case details — search returns only citations and titles. You need to call
get_case_metadataseparately for each case to get keywords, topics, decision date, and the CanLII URL.No treatment indicators — the citator shows what cases cite a decision, but does not indicate whether it was followed, distinguished, or overturned. You need to read the citing cases to determine treatment.
Citator tease caps at 5 results — use
get_case_citator(full version) for comprehensive citation analysis.Search has no database/jurisdiction filter — you cannot limit search results to a specific court or province server-side; add jurisdiction keywords to your query instead (e.g., "custody Ontario" instead of just "custody").
Search endpoint is undocumented — it works but is not in CanLII's official API docs, so it could change without notice.
Rate limits are strict — 5,000 queries/day, 2 req/sec, 1 concurrent request (enforced automatically by the built-in rate limiter).
License
MIT — see LICENSE.
Available Tools
9 toolsbrowse_legislationA
List all legislation items in a specific database. Use to find legislation IDs for metadata lookup. Key statutes by database — ons: Children's Law Reform Act, Family Law Act, Employment Standards Act. cas: Divorce Act, Criminal Code, Canada Labour Code, Federal Child Support Guidelines.
Inputs: databaseId (required), language, publishedBefore, publishedAfter, +6 more.
get_case_citatorA
Look up citation relationships for a case. Critical for verifying if a case is still good law. Use 'citingCases' to see what later cases cite this decision — if many recent cases cite it approvingly, it is strong authority. Use 'citedCases' to see what authorities this case relied on. Use 'citedLegislations' to see what statutes the case references. Returns the full list of citing/cited items.
Inputs: databaseId (required), caseId (required), metadataType (required), language, +8 more.
get_case_citator_teaseA
Quick preview of citation relationships (max 5 results). Faster than the full citator. Use this for a quick check on whether a case has been cited, then use get_case_citator for the complete list if needed.
Inputs: databaseId (required), caseId (required), metadataType (required), language.
get_case_law_decisionsA
List case law decisions from a specific court database. Use date filters to narrow results. Useful for browsing recent decisions from a specific court. Results are ordered by most recently added. Use get_case_metadata to get full details on a specific case.
Inputs: databaseId (required), language, offset, resultCount, +8 more.
get_case_metadataA
Get detailed metadata for a specific case including its CanLII URL, citation, decision date, docket number, keywords, and topics. The URL field links directly to the full decision text on canlii.org — always provide this to the user for verification. Use after finding a case via search or browse to get complete details before citing it.
Inputs: databaseId (required), caseId (required), language, publishedBefore, +7 more.
get_courts_and_tribunalsA
List all available court and tribunal databases in Canada. Returns database IDs needed for other tools. Key databases: onsc (Ontario Superior Court), onca (Ontario Court of Appeal), oncj (Ontario Court of Justice), onscdc (Divisional Court), csc-scc (Supreme Court of Canada), bcsc (BC Supreme Court), abkb (Alberta King's Bench). Use this to discover valid databaseId values for browse and citator tools.
Inputs: language, publishedBefore, publishedAfter, modifiedBefore, +5 more.
get_legislation_databasesA
List all available legislation databases in Canada. Returns database IDs for browsing statutes and regulations. Key databases: ons (Ontario Statutes), onr (Ontario Regulations), cas (Canada Statutes), car (Canada Regulations), bcs (BC Statutes), abs (Alberta Statutes).
Inputs: language, publishedBefore, publishedAfter, modifiedBefore, +5 more.
get_legislation_regulation_metadataA
Get metadata for a specific statute or regulation including its CanLII URL, citation, and table of contents. The URL links directly to the full legislation text on canlii.org — always provide this to the user.
Inputs: databaseId (required), legislationId (required), language.
searchA
Search CanLII for cases, legislation, and commentary by keyword. This is the primary entry point for legal research. Returns case citations and titles ranked by relevance — does NOT include keywords, dates, or URLs. Call get_case_metadata on promising results to get full details before citing a case. Search is keyword-based, not semantic — use specific legal terms rather than natural language. Common terms: 'best interests of the child', 'material change in circumstances', 'standard of review', 'duty to consult', 'reasonable expectation of privacy'. Include jurisdiction to narrow results (e.g., 'Ontario', 'Alberta'). Date filters are NOT supported on search. Always cite the CanLII citation and provide the case URL so the user can verify the source.
Inputs: query (required), language, resultCount, offset.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a distinct purpose: browse_legislation lists legislation items, get_case_citator retrieves full citation relationships, get_case_citator_tease offers a quick preview, get_case_law_decisions lists decisions from a court database, get_case_metadata provides detailed case info, get_courts_and_tribunals lists available court databases, get_legislation_databases lists legislation databases, get_legislation_regulation_metadata fetches legislation details, and search performs keyword searches. No two tools overlap significantly.
Most tools follow a 'get_' prefix (e.g., get_case_metadata, get_courts_and_tribunals), but 'browse_legislation' uses 'browse_' and 'search' is a bare verb. This slight inconsistency is minor and does not hinder readability.
Nine tools is appropriate for a legal research server. Each tool covers a core function—searching, browsing cases and legislation, citators, and metadata retrieval—without being excessive or insufficient.
The surface covers essential read-only legal research operations: search, browse, citator, and metadata. Minor gaps include lack of date filters on search (mitigated by jurisdiction keywords) and no direct full-text retrieval (URLs provided instead). Overall, it's well-rounded.
Maintenance
Related MCP Connectors
MCP for CanLII: Canadian case law and legislation metadata (federal, provincial, territorial).
Resolve, search and verify legal citations against the official sources, with provenance.
Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).
Wrapper for the official LegalOne API (Thomson Reuters / Novajus, Premium package): lawsuits and lit
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceProvides access to Canadian federal parliamentary data (debates, bills, MPs, votes, Hansard transcripts) and legal information (case law and legislation through CanLII) for research and analysis.3MIT
- AlicenseNot gradedqualityDmaintenanceProvides access to the CanLII API for searching and retrieving Canadian legal information, including court decisions, legislation, and citations.28MIT

caselegis-mcpofficial
AlicenseNot gradedqualityDmaintenanceEnables searching, retrieving, and checking citation status of California legal opinions via the Caselegis API.MIT- AlicenseAqualityBmaintenanceEnables retrieval of Canadian federal legislation (Acts and regulations) from the Justice Laws Website by code, providing metadata and full consolidated text in English and French.340 PyPIApache 2.0