• DATA
  • ANALYSIS
  • REPORTING
  • HUMAN

How to filter processes by class with your AI

Connect the CNJ API to your AI client to isolate specific legal proceedings. Once connected, your agent handles the filtering logic using court codes.

Ask AI about this page

Short answer

How can I find specific legal cases using class and court codes?

Your AI calls the CNJ API to scan for proceedings that match your exact Procedural Class and Court Organ requirements. You'll get a targeted list of cases instead of wading through raw data. Here is what you get.

The results you get.

Where your data lands.

The AI processes your request and delivers these specific outcomes.

DATA

Filtered case lists

The AI uses the search tool to pull only the proceedings that match your class and organ codes. You get a clean set of results ready for analysis.

ANALYSIS

Pattern identification

Once the data is in the chat, your agent can spot trends or commonalities within that specific group of cases.

REPORTING

Structured summaries

Your agent can turn the raw process data into a summary or a table based on the filtered results.

HUMAN

Manual verification

You must review the specific case numbers and details provided to ensure the filtering met your legal requirements.

The workflow

What your AI does when you ask for specific cases.

The AI acts as the bridge between your prompt and the CNJ database.

  1. Parse your criteria

    Your agent looks at your request to extract the necessary Procedural Class and Court Organ codes.

    search_processes_by_class_and_organ

  2. Execute the search

    The AI sends the specific codes to the CNJ API to find matching legal proceedings.

    search_processes_by_class_and_organ

  3. Format the results

    The agent takes the raw JSON response from the API and turns it into a readable list for you.

    search_processes_by_class_and_organ

  4. Deep dive

    You can ask follow-up questions about the specific cases found in the initial search.

    search_processes_by_class_and_organ

Try it

Copy these to start.

Use these prompts to trigger the search immediately.

Starting points

Replace the bracketed text with your actual court and class codes.

CNJ Datajud Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_aUA43ZGXwIeUcu4xQJ3UprlIzZu7awEnioPwYGgR/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — CNJ Datajud capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "cnj-datajud-api-publica-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_aUA43ZGXwIeUcu4xQJ3UprlIzZu7awEnioPwYGgR/mcp"
    }
  }
}
Copy into chat04

  • Find all processes for Procedural Class [CODE] and Court Organ [CODE].

  • List the legal proceedings matching Class [CODE] within the [CODE] court organ.

  • Search for cases in the CNJ database using Class [CODE] and Organ [CODE].

  • Show me the most recent processes for Class [CODE] and Organ [CODE].

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect CNJ (Datajud API Pública) once, then ask.

Click the link to connect the MCP to your client. Your credentials stay encrypted and you can start querying the CNJ API right away.

Connect CNJ (Datajud API Pública) to your AI

FAQ

How this task behaves.

  • 01

    Can the AI change the status of a legal process?

    No. The AI can only read and filter data from the CNJ API; it cannot modify any court records.

  • 02

    Do I need to provide the exact codes for the search to work?

    Yes. The tool requires specific Procedural Class and Court Organ codes to return accurate results.

  • 03

    Can the AI delete processes from the database?

    No. This tool is strictly for searching and retrieving information.

  • 04

    Does the AI handle the API authentication for me?

    Yes. Once you connect the MCP, Vinkius manages the connection so your agent can call the tools directly.

  • 05

    Can I search by lawyer name instead of class?

    No. This specific tool is limited to filtering by Procedural Class and Court Organ codes.

  • More questions about CNJ (Datajud API Pública)? The Connector page answers them. See everything the CNJ (Datajud API Pública) Connector can do

Connect CNJ Datajud to Claude, Cursor, ChatGPT & more