Published on Thu Jun 18 2026 00:00:00 GMT+0000 (Coordinated Universal Time) by Miguel Gonzalez Herrera

Searching for case law in CENDOJ and applying filters by court, subject, or date can take a lot of time. In this guide you will learn how to connect the Apify MCP to Claude Code so that the assistant itself searches for judgments on your behalf and presents them ready for analysis, all from a simple conversation.

🤖 Tutorial: Use the Apify MCP in Claude Code to Search for CENDOJ Judgments

Thanks to the Model Context Protocol (MCP), Claude Code can connect to external tools such as Apify. This means that, instead of manually navigating and filtering the CENDOJ search engine, you can ask Claude in natural language to retrieve the judgments you need and work with them.

In this case we will use the legaltech/cendoj actor, which searches for judgments published in CENDOJ and lets you filter them — for example, by subject and court.

Step 1: Create an Apify Account

The first thing you need is an Apify account. If you do not have one yet, sign up using the button below. The free plan is sufficient, as it provides monthly usage credits to run the actor.

Step 2: Get Your Apify Personal API Token

For Claude Code to authenticate with Apify, you need to generate a personal API token.

1. Log in to your Apify account and go to Settings → API & Integrations.

2. Click Create new token, give it a descriptive name, and copy it.

   

Keep that token handy: you will need it in the next step when adding the connector in Claude Code.

Step 3: Set Up Apify in Claude Code

For Claude Code to communicate with Apify, you need to add the Apify MCP custom connector.

1. Go to Claude’s connector settings and select Add custom connector.

   

2. Enter the Apify MCP details to complete the connection.

   

   https://mcp.apify.com/

   

Step 4: Check That Apify Is Available in the Chat

Once the connector is configured, open the Claude chat and verify that Apify appears as an available tool. From this point on, Claude can run Apify actors for you.

Step 5: Ask Claude for the Judgments You Need

Now for the interesting part. With the legaltech/cendoj actor connected, you no longer need to worry about filters or forms — just tell Claude in natural language what case law you are looking for.

For example, type directly in the chat:

Use the legaltech/cendoj actor and give me the latest judgments on mortgage costs published in CENDOJ handed down by the Supreme Court

Claude will run the actor with the criteria you specified (subject mortgage costs and court Supreme Court) and return the list of CENDOJ judgments that match your request.

Step 6: Analyse the Judgments from the Chat

Once Claude has the judgments in front of it, you can keep working with them without leaving the conversation. Just ask whatever you need in natural language, for example:

• Summarise the facts and ruling of each judgment.
• What position does the Supreme Court take on the allocation of mortgage costs?
• Sort them by date and tell me which three are the most recent.
• Identify whether there has been any change of criteria between the oldest and the newest judgments.
• Generate a table with the date, judgment number, and a one-sentence summary of the ruling.

From that point on, the analysis is a conversation: you refine your questions and Claude responds drawing on the judgments it retrieved from CENDOJ, saving you the initial search and reading time.

Written by Miguel Gonzalez Herrera