Scotcourts

@pipeworx/scotcourts

スコットランドの裁判所および審判所の判決を検索できます。対象は、Court of Session、High Court of Justiciary、National Personal Injury Court、Sheriff Appeal Courts、Sheriff Court の民事・刑事事件、Scottish Upper Tribunal の各部門です。Scottish Courts and Tribunals Service（SCTS）が1999年以降に公開した判決を対象とします。

Pipeworx の一部です。AI エージェントを1683以上の稼働中のデータソースに接続する MCP ゲートウェイです。

ツール

• search_scottish_judgments(query?, court?, from_date?, to_date?, page?, limit?) — 判決インデックスを検索します。タイトル、裁判所、裁判官、日付、PDF への document_link に加え、実際のコーパス一致件数を返します。
• get_scottish_judgment(document_link?, query?) — 判決の document_link を解決するか、先に事件名／クエリで検索し、その判決を特定して、 PDF に実際にアクセスできることを確認します。HTTP ステータス、コンテンツタイプ、 サイズを返します。PDF のテキストは抽出しません — SCTS の判決は PDF のみで、 このカタログ内に PDF テキスト抽出の依存関係はありません。常に pdf_url とともに text_extracted: false を返します。

認証

キーは不要です。API キー、Cookie、ベアラートークンは不要です。ブラウザーセッションを 使わず、通常の curl で api.pa.web.scotcourts.gov.uk/web/search に対して ライブ検証済みです。

データソース

• https://api.pa.web.scotcourts.gov.uk/web/search（POST、JSON）— クライアント側で描画される SPA scotcourts.gov.uk/judgments/#/ の背後にある判決検索インデックスです。 scotcourts.gov.uk/search-results/?filterType=Judgments は使用しないでください — これはサイト全体を対象とする汎用検索（サーバー側で描画される HTML）で、実際の判決に ニュース記事や審理／ライブ配信ページが混在して返されます。このパックでは行き止まりと 判断されました（fleet #2259）。
• https://www.scotcourts.gov.uk<documentLink> — 判決の PDF 本体です。 API レスポンスの documentLink は相対パスのため、このホストを基準に解決してください。

構築時に確認した注意点（fleet #2259 のスパイク、#2262 のビルド）

• 判決 SPA とサイト全体の検索は、異なるホスト上で動作する完全に別個のアプリです。 /judgments/ から参照される静的バンドル（/apps/scts-web-apps.min.js）は、サイト全体で 共有される共通の UI 部分であり、判決アプリ独自のロジックは含まれていません。判決アプリは 実行時に動的に読み込まれるため、リクエストの形式は静的バンドルの解析ではなく、 devtools／window.fetch のモンキーパッチを使ってライブページを操作し、取得しました。
• filters の形式（ブラウザー内と通常の curl の両方でライブ検証済み）：
  • 裁判所：{"field":"Court","value":"<exact dropdown string>"} — 値は裁判所の一般的な名称から 推測できません（例：ドロップダウンの表示は "Court of Session (Outer House)" ではなく "Court of Session" です）。完全な一覧は src/index.ts の COURTS にあります。
  • 日付範囲：{"field":"AdditionalDate","value":"<from>|<to>"} — 期間の始点または終点を空欄にして 範囲を指定できます（"2020-01-01|" は始点のみ、"|2020-01-01" は終点のみ）。 両方の形式をライブ検証済みです。
  • 認識されない Court の値を指定してもエラーにはなりません — HTTP 200 が返り、 results: [] および pagination.count.total: 0 となります。検出できなければ、 「該当する判決がない」場合とまったく同じに見えます。このパックではフィルターを送信する前に、 court が既知の一覧に含まれているか検証します。
  • 基本の4項目（キーワード、裁判所、開始日、終了日）の背後にある「Show more filters」パネルは、 リバースエンジニアリングしていません。このビルドの範囲外のため、検証済みの機能のみを 提供します。
• pagination.count.total はコーパス内での実際の一致件数です。results.length は リクエストで指定した limit によって上限が設定されます。「一致した判決の件数」として 表示するのは results.length ではなく、必ず total にしてください。
• 対象範囲に関する注意：このインデックスが対象とするのは、SCTS が1999年以降に公開することを 選択した判決であり、これまでに出されたスコットランドの判決すべてではありません。上級裁判所と 比べて、Sheriff Court と審判所の収録範囲は限られています。これはスコットランド法です。 イングランドおよびウェールズ／UK Supreme Court／UK の審判所の決定は別のコーパス （@pipeworx/uk-caselaw）です。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/scotcourts/mcp の tools/list は、上記の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールと併せて、およそ30個の共有ツールが一覧表示されます。接続の initialize 応答には正確な対象範囲が記載されており、その日の状況を確認する際の正式な情報源です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使えば、このパックでは扱えない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて回答できます。そのため、2つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックのエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

このパックのツールだけでなく、すべてのパックのツールを直接一覧表示するには、Pipeworx のフルゲートウェイに接続する方法もあります。

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

どちらの URL も同じゲートウェイと同じ1,683以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらの URL からも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/search_scottish_judgments \
  -H 'Content-Type: application/json' \
  -d '{"query":"negligence"}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/search_scottish_judgments を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も必要ありません。

{
  "mcpServers": {
    "scotcourts": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-scotcourts"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-scotcourts

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Scotcourts data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT