LegisGraph

View saved version →

---
name: legisratio-caselaw
description: Search Italian court judgments by theme, retrieve full text and official shareable PDF links, and list jurisprudence on a statutory article via LegisRatio MCP. Use for case-law research and filing citations; not for legislation text.
license: MIT
metadata:
  version: "0.1.0"
---

# LegisRatio Caselaw Skill

Locate and pull Italian court judgments — search by topic/court/date, retrieve full text, produce official shareable PDF links, and surface jurisprudence attached to a specific statutory article.

See [litigation package prompt](references/litigation-package.md) for a ready-to-use citation-ready filing workflow.

## When to Use

- Find court judgments/verdicts on a dispute theme or legal point
- Retrieving a judgment's full text or an official PDF URL for citation/filing
- Compile the jurisprudence interpreting a given law article
- Don't use for: legislation search or law text (use `legisratio-research` / `legisratio-law-text`)

## Prerequisites

- LegisRatio MCP server connected and available to the agent. Tool names below are the base MCP tool names; depending on the MCP client they may appear with a prefix (e.g. `mcp_legisratio_judgment_search`).

## How to Run

The agent calls the MCP tools directly.

## Procedure

1. Search judgments: call `judgment-search` with `searchString` (topic/phrase), optionally `section` (array of courts, e.g. `CASSAZIONE_CIVILE`, `CASSAZIONE_UNITE`, `TAR_LAZIO`, `CORTE_GIUSTIZIA_UE`) and `startDate` (YYYY-MM-DD). `k` defaults 100; lower it for a focused set.
2. For each relevant result, note its verdict ID, formatted like `SENTENZA-CASS:2017:10413:CIV` (Cass. civ. sez. unite, 27 Apr 2017, n. 10413).
3. Full text: call `get-judgment-text` with `idJudgment`.
4. Official shareable PDF: call `get-judgment-url` with `idJudgment` — use this URL for citations/filings, not a guessed link.
5. Jurisprudence on an article: call `judgment-related-to-article` with `articleId` in article format (see `legisratio-law-text` for the ID patterns).
6. Present each judgment with court, date, number and the official PDF URL.

## Pitfalls

- Pass the verdict ID exactly as returned — `SENTENZA-...` IDs encode court/type/year/number and don't tolerate reformatting.
- `section` is an array; pass courts as a list.
- `TRIBUNALE` and `CORTE_APPELLO` in `section` mean merit ('sentenze di merito') cases.
- `get_judgment_url` returns a shareable official PDF link (e.g. `.../view_pdf/<ID>?token=...`) — use it for citations/filings. A past 401 (the PDF endpoint wanting its own key) was fixed server-side; if it ever errors again, don't invent a URL — say it's unavailable and offer the full text via `get_judgment_text` instead.
- `get_judgment_text` already embeds the same shareable PDF link inline in its output — when you've already fetched the text you can skip the separate `get_judgment_url` call.

## Verification

- Every cited judgment has a real `idJudgment` from a search result, and the PDF URL you give is the one returned by `get_judgment_url` (official), not a constructed link.

Referenced files: 1

View saved version →

---
name: legisratio-law-text
description: Retrieve authoritative full text of an Italian/EU law, single article, or secondary act as in force on a date via LegisRatio MCP. Use when the law, article, or act ID is already known for a clause or compliance check; not for topic search.
license: MIT
metadata:
  version: "0.1.0"
---

# LegisRatio Law-Text Skill

Retrieve the authoritative full text of a law, a single article, or a secondary act exactly as it stood in force on a given date. Use this when the document ID is already known; search first (`legisratio-research`) when it isn't.

See [clause deep-dive prompt](references/clause-deep-dive.md) for a ready-to-use clause/compliance validation workflow.

## When to Use

- Need the full current or historical text of a specific Italian/EU/regional law
- Need the text of one article to cite in an opinion or brief
- Need a `Consob`/`Bankitalia`/`IVASS` secondary act's full text
- Don't use for: finding which documents exist on a topic (use `legisratio-research`)

## Prerequisites

- LegisRatio MCP server connected and available to the agent. Tool names below are the base MCP tool names; depending on the MCP client they may appear with a prefix (e.g. `mcp_legisratio_get_law_text`).

## How to Run

The agent calls the MCP tools directly.

## Procedure

1. Confirm the document ID and the target `dateInForce` (YYYY-MM-DD; use today's date when the intent is "current").
2. Law text: call `get-law-text` with `idLaw` = `YEARPUBLICATION|LAWNUMBER` (e.g. `2023|123`), `dateInForce` = target date. Regional laws append `:<region>` (e.g. `2023|123:lombardia`).
3. Article text: call `get-article-text-by-id` with `idArt` = `YEARPUBLICATION|LAWNUMBER#ARTICLENUMBER` (e.g. `2023|123#45`; regional adds `:lombardia`). For Constitution and codes use the exception names: `costituzione`, `codice_civile`, `codice_penale`, `codice_procedura_civile`. For EU laws use the CELEX ID from a prior search.
4. Secondary act: call `get-secondary-act` with `idAct`.
5. Verify the returned text matches the requested in-force date; quote it verbatim in the deliverable.

## Pitfalls

- Always pass `dateInForce` explicitly — the tool requires it and the text is date-sensitive.
- Unknown ID → search first; the tool will not guess. IDs come from search results, not memory.
- `#BIS` / `#TER` articles have no separate ID — their text is inside the main article (e.g. the base article number).
- Code/Constitution and regional IDs use special forms; don't force the generic `YEAR|NUM` pattern on them.
- Full law text for codes is NOT available via `get_law_text` with the `YEAR|NUM` id — e.g. `idLaw 1942|262` (civil code RD) returns "No text found". Read codes/Constitution at the article level with `get_article_text_by_id` (`codice_civile#NNNN`), which returns verbatim text.
- `get_secondary_act` accepts the exact `idAct` returned by `secondary_act_search` (e.g. `BANKIT:CIRC:229-...:9#1`) with no trimming.

## Verification

- The returned text begins with the correct document/act header and reflects the requested in-force date; you can quote it directly.

Referenced files: 1

View saved version →

---
name: legisratio-research
description: Discover relevant Italian/EU laws, court judgments, and secondary regulation by topic via LegisRatio MCP search. Use when finding which sources exist on a fact pattern or legal question for a memo or opinion; not for fetching text of an already-known ID.
license: MIT
metadata:
  version: "0.1.0"
---

# LegisRatio Research Skill

Find which Italian/EU legal documents are relevant to a question, using the LegisRatio MCP search tools. This skill answers "what exists on this topic" — picking up specific texts and judgments belongs to `legisratio-law-text` and `legisratio-caselaw`.

See [research-brief prompt](references/research-brief.md) for a ready-to-use first-pass memo workflow.

## When to Use

- User asks to find laws, articles, court judgments, or secondary regulation on a topic or fact pattern
- Building the starting set of sources for a legal opinion, memo, due-diligence, or compliance check
- Don't use for: retrieving a specific known law/article/judgment by ID (use the text/caselaw skills)

## Prerequisites

- LegisRatio MCP server connected and available to the agent. Tool names below are the base MCP tool names; depending on the MCP client they may appear with a prefix (e.g. `mcp_legisratio_hybrid_search`).

## How to Run

The agent calls the MCP tools directly. Run the searches, then synthesize.

## Procedure

1. Identify the document type(s) the question targets.
2. Search legislation: call `hybrid-search` with `searchString` = the topic/phrase. Set `k` ~80 (recommended for coverage; max 100). Add `levels` to widen from default `['EU','National']` to regions as needed (e.g. `['RegionalLombardia']` for a Lombardy question; `RegionalAll` only when spanning all regions).
3. Search case law: call `judgment-search` with `searchString`. Narrow with `startDate` (YYYY-MM-DD) and `section` (e.g. `CASSAZIONE_CIVILE`, `TAR_LAZIO`, `CORTE_GIUSTIZIA_UE`). `k` defaults 100.
4. Search secondary regulation: call `secondary-act-search` with `searchString`, `entity` as an array (e.g. `['Bankitalia']` or `['Consob','IVASS']`), `k` high, optional `articleOfLaw` reference.
5. Report sources grouped by type, each with its stable ID for follow-up retrieval.

## Pitfalls

- `levels` and `entity` are arrays — pass them as lists or the call fails.
- `entity` values are case-sensitive: use `Bankitalia`, `IVASS`, `Consob`, `CCNL`, `EDPB`, `ConsiglioNotarile` (lowercase 'ob' in `Consob` — the tool's own description shows the wrong capitalization and errors out with `-32602`).
- Default search scope is EU + National only; regional law requires explicitly adding regional `levels`.
- Search results give IDs in `YEAR|NUM` / `SENTENZA-CASS:...` form — hand those to the text/caselaw skills, don't retype from memory.
- Query phrasing decides relevance: state the topic in 2–4 concrete terms tied to the actual question (object, sector, transaction), not a generic doctrinal phrase and not a full sentence. "non concorrenza lavoratore" hits art. 2125 c.c.; "patto di non concorrenza del lavoratore codice civile" and the broad "adempimento obbligazioni" both returned off-topic laws. If the first pass lands off-topic, re-search with the concrete fact-words of the query. 

## Verification

- Every source you cite was returned by a real search call and carries an ID you can pass to a text-retrieval tool (`get-law-text`, `get-article-text-by-id`, `get-judgment-text`, `get-secondary-act`) to fetch the authoritative text.

Referenced files: 1