`pk_search_judgments`

Pack: pakistan-law · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/pk_search_judgments for the schema, then POST the same URL with its arguments for the data.

Search judgments of Pakistan’s High Courts: Islamabad High Court, High Court of Sindh, Peshawar High Court and High Court of Balochistan (Lahore High Court returns an explicit unavailable result). Give court plus words from the headnote or party names, optionally year of decision and reported_only. Returns case title, case number, law-report citation (PLD, SCMR, PCrLJ, YLR, MLD and others), decision date, bench and the judgment link to read with pk_get_judgment. Example: bail before arrest at the Islamabad High Court.

Parameters

Name	Type	Required	Description
`court`	string	yes	Which High Court: islamabad, sindh, peshawar, balochistan (lahore is recognised and returns unavailable). Also accepts ihc, shc, phc, bhc.
`query`	string	no	Words to find. Islamabad: headnote or party names (6+ letters work best). Sindh: party names. Peshawar: case title and remarks. Balochistan: case title or citation.
`year`	string	no	Four-digit year, e.g. “2024”. Year of decision for Islamabad and Peshawar; year the case was filed for Sindh; year inside the citation for Balochistan.
`reported_only`	boolean	no	Only judgments approved for reporting in the law reports (Islamabad, Sindh, Balochistan).
`limit`	number	no	Max results (default 20, max 100).

Example call

Arguments

{
  "court": "islamabad",
  "query": "bail before arrest",
  "reported_only": true,
  "limit": 5
}

curl

curl -X POST https://gateway.pipeworx.io/pakistan-law/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pk_search_judgments","arguments":{"court":"islamabad","query":"bail before arrest","reported_only":true,"limit":5}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('pk_search_judgments', {
  "court": "islamabad",
  "query": "bail before arrest",
  "reported_only": true,
  "limit": 5
});

More examples

{
  "court": "peshawar",
  "query": "bail",
  "year": "2024",
  "limit": 5
}

Response shape

Field	Type	Description
`found`	boolean
`available`	boolean
`court`	string
`query`	string \| null
`year`	number \| null
`reported_only`	boolean
`reason`	string
`total_matches`	number
`returned`	number
`judgments`	array
`latest_decision_in_matches`	string \| null
`query_matched_against`	string
`note`	string \| null
`hint`	string
`next`	string
`publisher`	string
`source`	string

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "available": {
      "type": "boolean"
    },
    "court": {
      "type": "string"
    },
    "query": {
      "type": [
        "string",
        "null"
      ]
    },
    "year": {
      "type": [
        "number",
        "null"
      ]
    },
    "reported_only": {
      "type": "boolean"
    },
    "reason": {
      "type": "string"
    },
    "total_matches": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "judgments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "court": {
            "type": "string"
          },
          "case_title": {
            "type": "string"
          },
          "case_no": {
            "type": [
              "string",
              "null"
            ]
          },
          "citation": {
            "type": [
              "string",
              "null"
            ]
          },
          "decision_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "bench": {
            "type": [
              "string",
              "null"
            ]
          },
          "reported": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "note": {
            "type": [
              "string",
              "null"
            ]
          },
          "judgment_url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true
      }
    },
    "latest_decision_in_matches": {
      "type": [
        "string",
        "null"
      ]
    },
    "query_matched_against": {
      "type": "string"
    },
    "note": {
      "type": [
        "string",
        "null"
      ]
    },
    "hint": {
      "type": "string"
    },
    "next": {
      "type": "string"
    },
    "publisher": {
      "type": "string"
    },
    "source": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the pakistan-law pack

{
  "mcpServers": {
    "pakistan-law": {
      "url": "https://gateway.pipeworx.io/pakistan-law/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

pk_search_judgments