Pakistan Case Law — MCP server

Connect Claude, ChatGPT, Gemini, Grok, Cursor or any MCP client to 230,000+ reported Pakistani judgments — Supreme Court, Federal Shariat Court, High Courts and tribunals, 1970 onward — so your assistant searches real case law and walks the citation graph instead of answering from memory.

• Endpoint: https://pakistancaselaw.com/mcp
• Transport: Streamable HTTP (SSE also works)
• Authentication: none — free, read-only, no API key, no account
• Official MCP registry: com.pakistancaselaw/caselaw
• Website: pakistancaselaw.com · full setup guide: pakistancaselaw.com/for-ai

This repository holds the documentation and the registry manifest (server.json). The server itself is hosted — there is nothing to install.

Connect in one minute

Claude (web and desktop)

Settings → Connectors → + → Add custom connector → name it Pakistan Case Law, URL https://pakistancaselaw.com/mcp, leave OAuth fields empty → Add. Works on the Free plan (one custom connector) and on Pro, Max, Team and Enterprise.

Claude Code

claude mcp add --transport http caselaw https://pakistancaselaw.com/mcp

ChatGPT

Works on the Free plan. Plugins → Add → Custom → name it Pakistan Case Law, URL https://pakistancaselaw.com/mcp → Add; if asked about authentication, choose No Authentication. Don't see Custom? Turn on Developer mode under Settings → Security and login, then repeat.

Gemini (web and app)

Works on the free Gemini app, in chat and in Gemini Spark. On a computer, go to gemini.google.com → Settings → Connected Apps (or Personal Intelligence → Connected Apps) → under Custom apps, Add a custom app → paste https://pakistancaselaw.com/mcp → Next. No credentials needed. Once added, it works in the mobile app too; type @ to pick it in a chat. Needs a personal Google Account with Keep Activity on.

Gemini CLI

gemini mcp add --transport http caselaw https://pakistancaselaw.com/mcp

Grok

grok.com/connectors → New Connector → Custom → paste the URL → no authentication.

Cursor, VS Code and other MCP clients

{
  "mcpServers": {
    "caselaw": {
      "type": "http",
      "url": "https://pakistancaselaw.com/mcp"
    }
  }
}

A client that only runs local commands can bridge with npx -y mcp-remote https://pakistancaselaw.com/mcp.

Tools

All seven are read-only and annotated as such (readOnlyHint: true, destructiveHint: false).

Tool	What it does
caselaw_search	Full-text search across all judgments, with optional filters: court ("Supreme Court", "LHC", "Sindh" ...), judge (spelling-tolerant - "Asif Khosa" finds Asif Saeed Khan Khosa; the reply names the judge matched), author (only the judgments that judge wrote; every result shows its author when known), journal (with years, a volume such as SCMR 2025) and year_from / year_to. Keywords are optional when a filter is given: court='Supreme Court' alone lists the latest Supreme Court judgments. Sort: relevance, newest, court, or recently_added. For the current law on a point, keep relevance and add year_from. A keyword search shows each result's court, the number of judges on the bench and the words of the judgment that matched.
caselaw_search_questions	Find judgments by the legal question they settle — e.g. "Can bail once granted be cancelled?" — rather than by the words they contain. Filters: court, judge, year_from, year_to.
caselaw_lookup_citation	The judgment at an exact law-report citation (journal, year, page), e.g. PLD 1995 Supreme Court 34.
caselaw_get_case	One judgment: metadata (court, case number - every case a common order decides - bench), outcome and headnote (section='summary'), or the full text too (section='full'). For a long judgment, section='outline' is a map of it (the judge's paragraph numbers, each separate opinion, the court's order); then paras returns paragraphs by the judge's own numbers, find returns the paragraphs of that judgment that match, and start continues from a character position.
caselaw_get_citations	Walk the citation graph forward — the precedents a judgment relied on.
caselaw_get_cited_by	Walk it backward — later judgments that cite this one, and how it was treated.
caselaw_most_cited	The most-cited landmark judgments — a good entry point to the leading authorities.

The server also offers a prompt, research_proposition, that runs a multi-step research plan: re-phrase and search several ways, triage on the headnotes, then walk the citation graph both ways.

Example prompts

• "Using the Pakistan Case Law tools, find Supreme Court authority on whether bail once granted can be cancelled without strong grounds, and tell me which cases are still followed."
• "Look up PLD 1995 Supreme Court 34, summarise what it decided, then show me the later cases that cite it."
• "What are the leading Pakistani authorities on maintainability of a constitutional petition where an alternate remedy exists? Give me the contrary authority as well."
• "Trace the line of authority on khula — start from the most-cited case and work forward to the current position."
• "What has Justice Asif Saeed Khan Khosa held on bail? List his judgments and what each decided."
• "Show me the latest Supreme Court judgments, and the pre-arrest bail cases reported since 2025."

Coverage and limits

• 230,000+ reported judgments, new ones added daily. Citations follow the Pakistani law reports (PLD, SCMR, CLC, YLR, MLD, PCrLJ, PLC, PTD and others).
• Headnotes and "questions settled" cover part of the corpus and are growing.
• Rate limited; over the limit, the reply says so and sets Retry-After.

How to rely on the results

Every result carries its citation and a link to the judgment page, so any answer can be checked against the source. Headnotes are a finding aid, not authority. This is research assistance, not legal advice: verify every authority against the official law report before relying on it in practice.

Privacy

No account and no personal data. The server receives only the search terms or judgment ids your client sends in a tool call — never your conversation, files or chat history. Full policy: pakistancaselaw.com/privacy · Terms: pakistancaselaw.com/terms.

About

Pakistan Case Law is built and maintained by Hamadullah Shah, Advocate, as a free public resource for Pakistani lawyers, students and researchers.

Questions, problems or a client that will not connect: [email protected], or open an issue in this repository.

Licence

The documentation and configuration in this repository are MIT-licensed (see LICENSE). The judgments are public documents of the courts; use of the website and the server is governed by the Terms of Use.