search_scottish_judgments
Pack: scotcourts · Endpoint: https://gateway.pipeworx.io/scotcourts/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/search_scottish_judgments for the schema, then POST the same URL with its arguments for the data.
Search Scottish court and tribunal judgments from the Scottish Courts and Tribunals Service (SCTS), published at scotcourts.gov.uk/judgments/ from 1999 onward: Court of Session, High Court of Justiciary, the National Personal Injury Court, Sheriff Appeal Courts, Sheriff Court civil/criminal, and the Scottish Upper Tribunal chambers. Returns title, court, judges, date and a document_link to the judgment PDF (fetch it with get_scottish_judgment). The total field is the true corpus match count (pagination.count.total upstream) — it is not the number of rows in this response, which is capped by limit. Coverage is whatever SCTS itself has chosen to publish on this index, not every decision ever made — sheriff court and tribunal coverage in particular is thin next to the higher courts. This is SCOTS law; England & Wales, UK Supreme Court and UK tribunal decisions are a different corpus (search_uk_caselaw).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | no | Free-text search over the judgment (e.g. a party name, a distinctive phrase, “negligence”). Optional — omit to browse by court/date alone. |
court | string | no | Court or Chamber to narrow to. Must match one of: ${COURTS.join(’, ’)}. An unrecognised value is rejected here rather than silently returning zero rows. |
from_date | string | no | Earliest date of opinion/decision, YYYY-MM-DD. |
to_date | string | no | Latest date of opinion/decision, YYYY-MM-DD. |
page | number | no | Page number, 1-based (default 1). |
limit | number | no | Judgments per page, 1-50 (default 20). |
Example call
Arguments
{
"query": "negligence"
}
curl
curl -X POST https://gateway.pipeworx.io/scotcourts/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_scottish_judgments","arguments":{"query":"negligence"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('search_scottish_judgments', {
"query": "negligence"
});
More examples
{
"query": "negligence",
"court": "Court of Session",
"from_date": "2020-01-01",
"to_date": "2020-12-31"
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"scotcourts": {
"url": "https://gateway.pipeworx.io/scotcourts/mcp"
}
}
}
See Getting Started for client-specific install steps.