← Back to blog # How to Search Finnish Case Law (Finlex: KKO and KHO) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/finlex connector to Claude or ChatGPT and search precedents of the Finnish Supreme Court (KKO), the Supreme Administrative Court (KHO) and Finnish courts on Finlex: ECLI, official keywords, summary and applied provisions.
**Finlex** is Finland's official legal database, run by the Ministry of Justice. It publishes the **precedents** (*ennakkopäätökset*) of the **Korkein oikeus** (KKO, Supreme Court) and the **Korkein hallinto-oikeus** (KHO, Supreme Administrative Court), plus decisions of the **hovioikeudet** (courts of appeal), the administrative courts and the specialist courts: the Market Court, the Labour Court and the Insurance Court. Each precedent carries **official keywords** (*asiasanat*) and a summary with the provisions applied. In this guide you will connect the **`legaltech/finlex`** connector to **Claude** or **ChatGPT** so you can search it from the chat, even when you ask in English.
> ✅ **Why this instead of just asking the AI:** if you ask Claude or ChatGPT about case law from memory, it may give you a convincing answer with made-up decisions. With the connector, the AI doesn't answer from memory: it goes to the official source, searches it and brings back real decisions with their links so you can check them.
## ⚖️ What does the `legaltech/finlex` connector cover?
The [`legaltech/finlex`](https://apify.com/legaltech/finlex?fpr=legaltech) connector queries Finlex case law and returns:
- **Collections:** KKO and KHO precedents and other decisions, hovioikeudet, hallinto-oikeudet, Market Court, Labour Court and Insurance Court.
- **Search:** Finnish or Swedish text with `AND`, `OR`, `NOT` (also `JA`, `TAI`, `EI`), exact phrases, parentheses and `*` wildcard (`konkurssi*`). It can search only the **keywords** (fast) or the **full text**, or fetch a decision by its identifier (`KKO:2024:1`).
- **Filters:** collection and year range (by default, the last five years).
- **Output:** identifier, date, diary number, **ECLI**, keywords, **summary** with the provisions applied, the passages where your terms appear and, optionally, the full text.
## 🔌 How to add Apify to Claude (5 minutes, first time only)
You don't need to know how to code. You will copy one address and paste it into Claude's settings. You do it once; after that you just ask your questions.
**1. Create your free Apify account.** Apify is the service that searches the official source for you. Sign up (you can use your Google account) and stay logged in in your browser. The free plan is enough to try it.
<a href="https://console.apify.com/sign-up?fpr=legaltech" target="_blank" rel="noopener noreferrer" style="display: inline-block; padding: 10px 20px; font-size: 16px; font-weight: bold; text-align: center; text-decoration: none; color: #ffffff; background-color: #6B46C1; border-radius: 8px;">
Create a free Apify account
</a>
**2. Open Claude's connectors.**
- **On a computer:** open [Claude's connectors page](https://claude.ai/customize/connectors) directly and sign in with your account. (Inside Claude it is under **Customize → Connectors**.)
- **On your phone:** open the [Claude app](https://claude.com/download), tap the **+** next to the message box, then **Connectors**.
**3. Click "Add custom connector".** On the phone it is under the **+** in the top-right corner.
**4. Fill in the form and click "Add".** There are only two fields:
- **Name:** `Apify`
- **URL:** copy this address with the button and paste it:
https://mcp.apify.com/?tools=actors,docs,runs,storage,tasks,legaltech/finlex
Leave the other fields (the "OAuth" ones) empty.
**5. Click "Connect".** An Apify window opens: click **Allow** and you will be back in Claude with the connector ready.
**6. Try it.** Open a new chat and paste the first prompt from the example below. The first time, Claude will ask for permission to use Apify: click **Allow**.
> 💡 **Already have Apify in Claude?** Don't install it again: start your question with "Use the connector `legaltech/finlex`" and Claude will run it.
If you get stuck, the [installation guide](/en/instalar/?assistant=claude&jurisdiction=fi) has a screenshot of every step. Using ChatGPT? The steps are different: follow the [ChatGPT guide](/en/instalar/?assistant=chatgpt&jurisdiction=fi).
## 🧪 Worked example: recovery to the bankruptcy estate (takaisinsaanti)
**Takaisinsaanti konkurssipesään** is the clawback action: it lets the estate recover payments and transfers the debtor made before bankruptcy. Let's look at recent Supreme Court precedents:
> **Use the connector legaltech/finlex and find KKO precedents since 2018 on recovery to the bankruptcy estate (takaisinsaanti)**
Claude picks the collection and searches the official keywords:
```json
{
"searchTerms": ["takaisinsaanti"],
"collections": ["kko"],
"yearFrom": 2018,
"searchIn": "keywords",
"maxResults": 4,
"passages": 1
}
```
Result of a real run (these are the insolvency precedents):
| Precedent | Date | Keywords | Provisions | What it decides |
| --- | --- | --- | --- | --- |
| KKO:2026:13 | 10 Feb 2026 | Konkurssi – Takaisinsaanti konkurssipesään – Kanneaika | TakSL 24 § 1 mom | The **three-month** time limit for the action runs from when the estate had sufficient grounds to sue |
| KKO:2025:6 | 14 Jan 2025 | Ulosottokaari – Takaisinsaanti ulosotossa | UK 3:84; TakSL 9 §; AL 104 § | Clawback of a **division of matrimonial property**: an earlier tax debt counts even though it later became time-barred (with dissents) |
| KKO:2024:26 | 9 Apr 2024 | Konkurssi – Takaisinsaanti konkurssipesään | OYL 12:1.1.2; TakSL 10 § | Repaying matured **capital loans** was a premature payment and is recovered by the estate |
**KKO:2026:13** is the most practical. Company A had transferred funds to B for no consideration, and B used them to pay its debt to C. The estate sued on 9 Sep 2022, more than a year after the bankruptcy (22 Jun 2021). The Supreme Court holds the claim **in time**: the three months under s. 24 of the Recovery Act (TakSL) run from when the estate could see sufficient grounds for its claims. Here that was **21 Jun 2022**, when C's lawyer explained that the funds were not a loan but part of a share purchase financed by a dividend.
In **KKO:2024:26**, the payments were made two and a half months before the company applied for restructuring, even though the loans had already matured. The Supreme Court treats them as **premature**, because the Companies Act conditions for repaying a capital loan (OYL 12:1) were not met.
You can carry on:
- *Find KKO precedents applying TakSL 5 § (payments to persons close to the debtor).*
- *Get the full text of KKO:2025:6 and summarise the dissenting opinions.*
- *Find 2024 and 2025 court-of-appeal decisions citing KKO:2024:26.*
## 💡 More prompt ideas
- *Use legaltech/finlex and find KHO precedents from 2023 to 2025 on public procurement (julkiset hankinnat).*
- *Use legaltech/finlex and get KKO:2024:1 with its summary and the provisions applied.*
- *Use legaltech/finlex and search the Labour Court for decisions on collective agreements (työehtosopimus).*
## ✅ Good practice
- **Watch out for homonyms.** The same search also returned **KKO:2024:45**, which is about *takaisinsaanti* of a **default judgment**, not insolvency. To narrow it, use the full keyword: `"takaisinsaanti konkurssipesään"`.
- **Start with keywords** (`searchIn: keywords`): it is fast and precise. Switch to full text only if you find nothing.
- **Search in Finnish** (or Swedish for decisions published in Swedish).
- **Always check** the decision on finlex.fi before citing it.
If you have questions or get stuck, write to us at [legaltechnologybootcamp@gmail.com](mailto:legaltechnologybootcamp@gmail.com).
Published on by Miguel Gonzalez Herrera
Finlex is Finland’s official legal database, run by the Ministry of Justice. It publishes the precedents (ennakkopäätökset) of the Korkein oikeus (KKO, Supreme Court) and the Korkein hallinto-oikeus (KHO, Supreme Administrative Court), plus decisions of the hovioikeudet (courts of appeal), the administrative courts and the specialist courts: the Market Court, the Labour Court and the Insurance Court. Each precedent carries official keywords (asiasanat) and a summary with the provisions applied. In this guide you will connect the legaltech/finlex connector to Claude or ChatGPT so you can search it from the chat, even when you ask in English.
✅ Why this instead of just asking the AI: if you ask Claude or ChatGPT about case law from memory, it may give you a convincing answer with made-up decisions. With the connector, the AI doesn’t answer from memory: it goes to the official source, searches it and brings back real decisions with their links so you can check them.
⚖️ What does the legaltech/finlex connector cover?
The legaltech/finlex connector queries Finlex case law and returns:
Collections: KKO and KHO precedents and other decisions, hovioikeudet, hallinto-oikeudet, Market Court, Labour Court and Insurance Court.
Search: Finnish or Swedish text with AND, OR, NOT (also JA, TAI, EI), exact phrases, parentheses and * wildcard (konkurssi*). It can search only the keywords (fast) or the full text, or fetch a decision by its identifier (KKO:2024:1).
Filters: collection and year range (by default, the last five years).
Output: identifier, date, diary number, ECLI, keywords, summary with the provisions applied, the passages where your terms appear and, optionally, the full text.
🔌 How to add Apify to Claude (5 minutes, first time only)
You don’t need to know how to code. You will copy one address and paste it into Claude’s settings. You do it once; after that you just ask your questions.
1. Create your free Apify account. Apify is the service that searches the official source for you. Sign up (you can use your Google account) and stay logged in in your browser. The free plan is enough to try it.
5. Click “Connect”. An Apify window opens: click Allow and you will be back in Claude with the connector ready.
6. Try it. Open a new chat and paste the first prompt from the example below. The first time, Claude will ask for permission to use Apify: click Allow.
💡 Already have Apify in Claude? Don’t install it again: start your question with “Use the connector legaltech/finlex” and Claude will run it.
If you get stuck, the installation guide has a screenshot of every step. Using ChatGPT? The steps are different: follow the ChatGPT guide.
🧪 Worked example: recovery to the bankruptcy estate (takaisinsaanti)
Takaisinsaanti konkurssipesään is the clawback action: it lets the estate recover payments and transfers the debtor made before bankruptcy. Let’s look at recent Supreme Court precedents:
Use the connector legaltech/finlex and find KKO precedents since 2018 on recovery to the bankruptcy estate (takaisinsaanti)
Claude picks the collection and searches the official keywords:
The three-month time limit for the action runs from when the estate had sufficient grounds to sue
KKO:2025:6
14 Jan 2025
Ulosottokaari – Takaisinsaanti ulosotossa
UK 3:84; TakSL 9 §; AL 104 §
Clawback of a division of matrimonial property: an earlier tax debt counts even though it later became time-barred (with dissents)
KKO:2024:26
9 Apr 2024
Konkurssi – Takaisinsaanti konkurssipesään
OYL 12:1.1.2; TakSL 10 §
Repaying matured capital loans was a premature payment and is recovered by the estate
KKO:2026:13 is the most practical. Company A had transferred funds to B for no consideration, and B used them to pay its debt to C. The estate sued on 9 Sep 2022, more than a year after the bankruptcy (22 Jun 2021). The Supreme Court holds the claim in time: the three months under s. 24 of the Recovery Act (TakSL) run from when the estate could see sufficient grounds for its claims. Here that was 21 Jun 2022, when C’s lawyer explained that the funds were not a loan but part of a share purchase financed by a dividend.
In KKO:2024:26, the payments were made two and a half months before the company applied for restructuring, even though the loans had already matured. The Supreme Court treats them as premature, because the Companies Act conditions for repaying a capital loan (OYL 12:1) were not met.
You can carry on:
Find KKO precedents applying TakSL 5 § (payments to persons close to the debtor).
Get the full text of KKO:2025:6 and summarise the dissenting opinions.
Find 2024 and 2025 court-of-appeal decisions citing KKO:2024:26.
💡 More prompt ideas
Use legaltech/finlex and find KHO precedents from 2023 to 2025 on public procurement (julkiset hankinnat).
Use legaltech/finlex and get KKO:2024:1 with its summary and the provisions applied.
Use legaltech/finlex and search the Labour Court for decisions on collective agreements (työehtosopimus).
✅ Good practice
Watch out for homonyms. The same search also returned KKO:2024:45, which is about takaisinsaanti of a default judgment, not insolvency. To narrow it, use the full keyword: "takaisinsaanti konkurssipesään".
Start with keywords (searchIn: keywords): it is fast and precise. Switch to full text only if you find nothing.
Search in Finnish (or Swedish for decisions published in Swedish).
Always check the decision on finlex.fi before citing it.
How to search ECHR case law (HUDOC) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/tedh connector to Claude or ChatGPT and search judgments and decisions of the European Court of Human Rights in HUDOC: by respondent State, Convention article and violation found, with official headnote, operative part and passages.
How to Search French Administrative Case Law (Conseil d’État, CAA and TA) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/conseil-etat connector to Claude or ChatGPT and search decisions of the Conseil d’État, the administrative courts of appeal and the administrative tribunals: panel, ECLI, Lebon publication status and relevant passages.
How to Search German Federal Court Case Law (BGH, BVerfG, BAG…) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/rechtsinformationen-bund connector to Claude or ChatGPT and search decisions of the BVerfG, BGH, BVerwG, BFH, BAG, BSG and BPatG: headnote, operative part, cited statutes, lower-court decisions and passages with margin numbers.
How to Search Swiss Federal Supreme Court Case Law (BGer / BGE) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/bger connector to Claude or ChatGPT and search judgments of the Swiss Federal Supreme Court (Bundesgericht / Tribunal fédéral) since 2000 and BGE/ATF leading cases since 1954: official Regeste, considerations, operative part and relevant passages.
How to Search Italian Constitutional Court Case Law with Claude, ChatGPT and the Apify MCP
Connect the legaltech/corte-costituzionale connector to Claude or ChatGPT and search over 20,000 judgments and orders of the Corte costituzionale since 1956: official massime, operative part, reporting judge and constitutional articles invoked.
How to Search Portuguese Case Law (DGSI: STJ, Courts of Appeal and STA) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/dgsi connector to Claude or ChatGPT and search rulings of the Supreme Court of Justice, the Supreme Administrative Court, the courts of appeal and the TCAs in the DGSI databases: headnote, descriptors, reporting judge and outcome.
How to Search Danish Case Law (Domsdatabasen) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/domsdatabasen connector to Claude or ChatGPT and search judgments of Højesteret, the high courts and Danish district courts in Domsdatabasen: ECLI, status (final or appealed), amount claimed and the case's path through the instances.
How to Search Swedish Case Law (Högsta domstolen and Rättspraxis) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/domstol-se connector to Claude or ChatGPT and search precedents of Högsta domstolen, the Supreme Administrative Court, the courts of appeal and Swedish specialist courts: NJA reports, keywords, applied statutes by SFS number and relevant passages.
How to Search Finnish Case Law (Finlex: KKO and KHO) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/finlex connector to Claude or ChatGPT and search precedents of the Finnish Supreme Court (KKO), the Supreme Administrative Court (KHO) and Finnish courts on Finlex: ECLI, official keywords, summary and applied provisions.
How to Search Italian Administrative Case Law (Consiglio di Stato and TAR) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/giustizia-amministrativa connector to Claude or ChatGPT and search judgments of the Consiglio di Stato, the Sicilian CGA and the 29 regional TARs: outcome, chamber, reporting judge, operative part (P.Q.M.) and relevant passages.
How to Search Dutch Case Law (Rechtspraak) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/rechtspraak connector to Claude or ChatGPT and search decisions of the Hoge Raad, the Council of State and Dutch courts from Rechtspraak Open Data: ECLI, summary, links between instances and annotations.
How to Search Austrian Case Law (RIS) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/ris-austria connector to Claude or ChatGPT and search decisions of the OGH, VfGH, VwGH, BVwG and Austrian courts in the RIS: legal principles (Rechtssätze), operative part, cited statutes, ECLI and official PDF.
How to Search Portuguese Constitutional Court Case Law with Claude, ChatGPT and the Apify MCP
Connect the legaltech/tribunal-constitucional-pt connector to Claude or ChatGPT and search rulings (acórdãos) of Portugal's Constitutional Court since 1983 by text, chamber, proceeding type, reporting judge and date, with the operative part and full text.
How to Search UK Case Law (Find Case Law) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/find-case-law-uk connector to Claude or ChatGPT and search judgments of the Supreme Court, Court of Appeal, High Court and UK tribunals on The National Archives’ Find Case Law: neutral citation, judges, parties and PDF.
How to Search Brandenburg and Berlin-Brandenburg Case Law with Claude, ChatGPT and the Apify MCP
Connect the legaltech/gerichtsentscheidungen-brandenburg connector to Claude or ChatGPT and search decisions from 31 Brandenburg courts and the joint Berlin-Brandenburg courts: ECLI, operative part, statutes and procedural history.
How to Search Bavarian Case Law (gesetze-bayern.de) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/gesetze-bayern connector to Claude or ChatGPT and search Bavarian court decisions on the official gesetze-bayern.de portal, including by applied statute (e.g. BGB § 536): headnotes, keywords and operative part.
How to Search Belgian Case Law (Juportal) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/juportal connector to Claude or ChatGPT and search decisions of the Court of Cassation, the Constitutional Court, the Council of State and Belgian courts on Juportal: ECLI, case notes, thesaurus and legal bases.
How to Search North Rhine-Westphalia Case Law (NRWE) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/nrwe connector to Claude or ChatGPT and search decisions from every North Rhine-Westphalia court in the official NRWE database: headnotes, operative part, ECLI and lower-court decision, just by asking in plain language.
How to Search Lower Saxony Case Law (NI-VORIS) with Claude, ChatGPT and the Apify MCP
Connect the legaltech/rechtsprechung-niedersachsen connector to Claude or ChatGPT and search some 32,000 Lower Saxony court decisions in NI-VORIS: ECLI, applied statutes, headnote and operative part, just by asking in plain language.
How to Use the Apify MCP with a Local Model (Ollama) to Search CENDOJ Rulings
Learn how to search Spanish CENDOJ rulings in natural language with a language model that runs on your own computer: Ollama, AnythingLLM and the Apify MCP, without sending your conversations or documents to Claude or ChatGPT.
How to Use the Apify MCP in Claude to Find Which Cadastral Parcel You Are In and Look Up Its Data
Learn how to connect the Apify MCP to Claude and use the legaltech/catastro actor to get a parcel's cadastral reference from your coordinates or an address, and look up its official data without going through the Spanish Cadastre website.
How to Use the Apify MCP in Claude to Cross-Reference Spanish Mortgage and Foreclosure Data from the INE
Learn how to connect the Apify MCP to Claude and use the legaltech/ine actor to cross-reference Spain’s Mortgage Statistics and Mortgage Foreclosure Statistics from the INE, and reach the provincial figure no article publishes.
How to Use the Apify MCP in ChatGPT to Access LegalTech Legal Connectors
Learn how to use LegalTech legal connectors from a free ChatGPT account: enable Developer Mode, add the Apify MCP (@Apify), and query Fiscalía, CENDOJ, Hacienda, Property Registry, and more directly from the chat.
How to Use the Apify MCP in Claude to Query Doctrine from the Spanish State Prosecutor Office
Learn how to connect the Apify MCP to Claude and use the legaltech/fiscalia actor to search Circulares, Instrucciones and Consultas from the Spanish State Prosecutor Office directly from the chat, simply by asking in natural language.
How to Use the Apify MCP in Claude to Query Spanish Tax Authority Administrative Doctrine
Learn how to connect the Apify MCP to Claude and use the legaltech/hacienda actor to query TEAC tax administrative doctrine, DGT binding rulings, and historical resolutions directly from the chat.
We use Google Analytics cookies to analyze traffic and improve your experience. You can accept them, reject them, or read our Privacy & Cookies policy. Privacy & Cookies.