plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "pakistan-case-law",
  "version": "1.0.0",
  "description": "Search, read and trace reported judgments of the courts of Pakistan, with citations and links to the full text.",
  "author": {
    "name": "Hamadullah Shah, Advocate",
    "email": "contact@pakistancaselaw.com",
    "url": "https://pakistancaselaw.com/about"
  },
  "homepage": "https://pakistancaselaw.com",
  "keywords": [
    "case law",
    "Pakistan",
    "judgments",
    "law reports",
    "citations",
    "legal research"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Pakistan Case Law",
        "shortDescription": "Search Pakistani judgments",
        "longDescription": "Pakistan Case Law searches more than 230,000 reported judgments of the Supreme Court of Pakistan, the Federal Constitutional Court, the Federal Shariat Court, the High Courts and tribunals, from 1970 to the present, with new judgments added daily.\n\nResults carry their law-report citation (PLD, SCMR, CLC, YLR, MLD, PCrLJ, PLC, PTD and others), the court's recorded outcome and a link to the full judgment on pakistancaselaw.com, so each answer can be checked against the source.\n\nWhat it does:\n- Full-text search of every judgment, ranked by relevance, date or court seniority, and narrowed by court, by a judge on the bench or the judge who wrote it, by law report and volume (such as SCMR 2025), or by year.\n- The latest judgments of a court, or the newest additions to the library.\n- Judgments found by the legal question they settle, such as \"Can bail once granted be cancelled?\"\n- The judgment at an exact citation, such as PLD 1995 Supreme Court 34.\n- A judgment's summary (where one exists), outcome and full text, or only the paragraphs needed from a long judgment.\n- The citation graph: the precedents a judgment relied on, and the later cases that cite it.\n- The most-cited judgments, as a starting point for any area of law.\n\nFor advocates, judges' researchers, law students and anyone researching the law of Pakistan. Read-only, with no account or sign-in.\n\nJudgments are court records and can describe crimes and family disputes in detail.\n\nThis is research assistance, not legal advice. Verify every authority against the official law report before relying on it.",
        "developerName": "Hamadullah Shah, Advocate",
        "category": "Education & Research",
        "capabilities": [
          "Search judgments",
          "Search by legal question",
          "Look up a citation",
          "Read a judgment",
          "Follow the citation graph"
        ],
        "websiteURL": "https://pakistancaselaw.com/for-ai",
        "supportURL": "https://pakistancaselaw.com/about",
        "privacyPolicyURL": "https://pakistancaselaw.com/privacy",
        "termsOfServiceURL": "https://pakistancaselaw.com/terms",
        "defaultPrompt": [
          "Find Supreme Court judgments on cancellation of bail once granted.",
          "Look up PLD 1995 Supreme Court 34 and summarise what it decided.",
          "Which later cases cite PLD 1995 Supreme Court 34?"
        ],
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Search case law on a legal issue, limited to one court",
              "prompt": "Find Supreme Court of Pakistan judgments on cancellation of bail.",
              "tools_triggered": "caselaw_search",
              "expected_behavior": "Lists Supreme Court of Pakistan judgments on cancelling bail, each with its law-report citation, recorded outcome and pakistancaselaw.com link. Tariq Bashir and 5 others vs The State (PLD 1995 Supreme Court 34) is among them."
            },
            {
              "description": "Find judgments by the legal question they settle",
              "prompt": "Which judgments decide what grounds are needed to cancel bail once it has been granted?",
              "tools_triggered": "caselaw_search_questions",
              "expected_behavior": "Lists judgments whose summaries record that question, each showing the matched question, its citation, outcome and link."
            },
            {
              "description": "Look up a judgment by its exact citation",
              "prompt": "Look up PLD 1995 Supreme Court 34.",
              "tools_triggered": "caselaw_lookup_citation",
              "expected_behavior": "Returns one judgment: Tariq Bashir and 5 others vs The State, Supreme Court of Pakistan, 1995, with its outcome (Order accordingly) and the link https://pakistancaselaw.com/case/65340."
            },
            {
              "description": "Read a judgment's summary and outcome",
              "prompt": "Summarise PLD 1995 Supreme Court 34 and tell me its outcome.",
              "tools_triggered": "caselaw_lookup_citation, caselaw_get_case",
              "expected_behavior": "Gives the case's summary (cancelling bail needs strong and exceptional grounds; where there is reasonable doubt the benefit goes to the accused even at the bail stage), the bench, the recorded outcome, the citation and the link."
            },
            {
              "description": "See how a judgment has been followed since",
              "prompt": "Which later cases cite PLD 1995 Supreme Court 34?",
              "tools_triggered": "caselaw_lookup_citation, caselaw_get_cited_by",
              "expected_behavior": "Lists later judgments that cite it, newest first, each with its citation and link, and says that several hundred more are available."
            }
          ],
          "negative": [
            {
              "description": "A general question with nothing to do with case law",
              "prompt": "What's the weather in Lahore today?",
              "expected_behavior": "No Pakistan Case Law tool is called."
            },
            {
              "description": "Drafting a document is not a case-law search",
              "prompt": "Draft a rent agreement for my flat in Karachi.",
              "expected_behavior": "No Pakistan Case Law tool is called: the plugin finds and reads judgments, it does not draft documents."
            },
            {
              "description": "An action the read-only plugin cannot take",
              "prompt": "File my bail application in the Sindh High Court online.",
              "expected_behavior": "No Pakistan Case Law tool is called: the plugin only reads published judgments and cannot file documents or contact a court."
            }
          ]
        },
        "demo_recording_url": "https://github.com/pakistancaselaw/pakistan-case-law-mcp/blob/main/demo/chatgpt-demo.mp4",
        "commerce": false,
        "commerce_description": "This plugin does not sell anything or process payments."
      },
      "publication": {
        "release_notes": "First release. Seven read-only tools over the Pakistan Case Law library: full-text search with court, judge, author, law-report and year filters; search by the legal question a judgment settles; citation lookup; a judgment's summary, outline, chosen paragraphs or full text; the precedents a judgment cites and the later cases citing it; and the most-cited judgments."
      },
      "apps": "./.app.json"
    }
  }
}