Skip to main content
Glama
slapash

JurisCassation MCP Server

by slapash

JurisCassation API

GraphQL + REST wrapper for juriscassation.cspj.ma — the Moroccan Court of Cassation decision portal.

Features

  • Live search — real-time passthrough to the Arabic search endpoint

  • Local search — SQLite FTS5 full-text search over scraped decisions

  • GraphQL API — type-safe queries and mutations

  • PDF proxy — cache and serve decision PDFs by encrypted ID

  • Background scraper — index all decisions into local SQLite

Related MCP server: Entscheidsuche MCP Server

Quick Start

# Docker (GraphQL API on port 5091)
docker compose up -d

# Or direct
pip install -r requirements.txt
python app.py serve --port 8000

# MCP Server (port 5098, SSE transport)
# Via systemd:
sudo systemctl start juriscassation-mcp

# Or direct:
JURIS_API_BASE=http://localhost:5091 python mcp_server.py

API Endpoints

Endpoint

Description

GET /graphql

GraphQL playground (interactive)

POST /graphql

GraphQL API

GET /api/pdf/{encrypted_id}

Download decision PDF (proxied + cached)

GET /api/stats

Local index statistics

GraphQL Schema

Queries

# Live search against the Moroccan portal (real-time)
query {
  searchLive(chamberId: 1, sujet: "طلاق", lang: "ar", page: 1) {
    total
    page
    perPage
    items {
      encryptedId
      dossierNumber
      decisionNumber
      decisionDate
      keywordsAr
      pdfUrl
    }
  }
}

# Search the local SQLite index
query {
  searchLocal(query: "طلاق", chamberId: 1, page: 1, perPage: 20) {
    total
    page
    perPage
    items {
      id
      encryptedId
      dossierNumber
      decisionNumber
      decisionDate
      keywordsAr
      pdfUrl
    }
  }
}

# List chambers with decision counts
query {
  chambers {
    id
    nameAr
    nameFr
    nameEn
    decisionCount
  }
}

# Scraper/indexer status
query {
  scraperStatus {
    totalDecisions
    lastScrape
    chambers { id nameFr decisionCount }
  }
}

Mutations

# Scrape decisions from a chamber (Arabic endpoint with alef wildcard)
mutation {
  scrapeChamber(chamberId: 1, maxPages: 5)
}

# Scrape all pages
mutation {
  scrapeChamber(chamberId: 1, maxPages: 0)
}

Chambers

ID

Arabic

French

English

1

الغرفة المدنية

Chambre Civile

Civil

2

غرفة الأحوال الشخصية و الميراث

Statut Personnel & Successions

Personal Status & Inheritance

3

الغرفة التجارية

Chambre Commerciale

Commercial

4

الغرفة الإدارية

Chambre Administrative

Administrative

5

الغرفة الاجتماعية

Chambre Sociale

Social

6

الغرفة الجنائية

Chambre Pénale

Criminal

7

الغرفة العقارية

Chambre Immobilière

Real Estate

CLI Scraper

# Scrape chamber 1 (all pages)
python app.py scrape --chamber 1

# Scrape all chambers, max 50 pages each
python app.py scrape --chamber 0 --max-pages 50

# Scrape from page 100 onwards
python app.py scrape --chamber 6 --since-page 100

Architecture Notes

  • The Arabic endpoint (/Decisions/RechercheDecisionsRes) returns encrypted data-id attributes needed for PDF download

  • The French endpoint (/Decisions/RechercheDecisionsResFr) returns numeric idArretCassation IDs but no encrypted IDs

  • PDFs are downloaded via /Decisions/GetArret?encryptedId=... — no auth required

  • Empty Sujet in Arabic search returns 0 results; we use ا (alef) as a wildcard catch-all

  • SSL cert on the upstream site is broken; verify=False is required

Environment Variables

Variable

Default

Description

JURIS_DB

/data/decisions.db

SQLite database path

JURIS_PDF_CACHE

/data/pdfs

PDF cache directory

JURIS_CONCURRENCY

3

Max concurrent scrape requests

JURIS_DELAY

0.5

Delay between scrape pages (seconds)

MCP Server

An MCP (Model Context Protocol) server exposes all API features as AI-agent tools via SSE on port 5098.

MCP Endpoint: http://localhost:5098/sse

Tools

Tool

Description

search_decisions

Live search against juriscassation.cspj.ma

search_local

FTS5 search over local SQLite index

get_decision_pdf

Check/download a decision PDF by encrypted ID

list_chambers

List all 7 chambers with index counts

scrape_chamber

Index decisions from a chamber

get_stats

Local index statistics

Resources

URI

Description

juriscassation://chambers

Chamber reference list (AR/FR/EN)

juriscassation://stats

Current index statistics

MCP Environment Variables

Variable

Default

Description

JURIS_API_BASE

http://localhost:5091

GraphQL API base URL

JURIS_DB

/mnt/data/juriscassation/decisions.db

SQLite path (for direct search)

MCP_PORT

5098

MCP server port

MCP_HOST

0.0.0.0

MCP server bind host

MCP_TRANSPORT

sse

Transport type (sse or streamable-http)

Test with mcporter

# List tools
npx mcporter list --http-url http://localhost:5098/sse --allow-http --schema

# Search
npx mcporter call search_decisions sujet=طلاق chamber_id=1 --allow-http --http-url http://localhost:5098/sse

Deployment

The app is containerized and runs on port 8000 internally, mapped to host port 5091.

Related MCP Connectors

Related MCP Servers