CNJ Datajud MCP. Query Brazil's official judicial records directly from your agent.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
CNJ (Datajud API Pública) MCP Server lets you query the Brazilian National Council of Justice (CNJ) Datajud API. It gives your AI client access to detailed metadata on lawsuits, court movements, and procedural history across Brazil.
You can run deep searches using unique CNJ numbers, filter processes by specific Procedural Classes (TPU), or execute advanced Elasticsearch queries across various courts like TRF and TJ.
What your AI agents can do
Search process by number
Searches for a specific judicial process using its full CNJ number, across multiple API aliases like TRF1 or TJSP.
Search processes advanced
Runs complex, full-featured searches using Elasticsearch Query DSL against the Datajud API.
Search processes by class and organ
Finds processes by filtering on the Procedural Class (TPU) and specific Court Organ code.
It retrieves all details for a single judicial process using its unique CNJ tracking number and the specific court alias.
It executes complex queries using Elasticsearch DSL to filter process records by dates, parties, or custom metadata fields.
It searches for processes based on predefined Procedural Class (TPU) codes and specific Court Organ identifiers.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
CNJ Datajud API Pública MCP Server: 3 Tools for Judicial Data
These three tools allow your AI client to search, filter, and query the Brazilian judicial database using specific criteria like CNJ numbers, procedural classes, or advanced date ranges.
019e3879search process by number
Searches for a specific judicial process using its full CNJ number, across multiple API aliases like TRF1 or TJSP.
019e3879search processes advanced
Runs complex, full-featured searches using Elasticsearch Query DSL against the Datajud API.
019e3879search processes by class and organ
Finds processes by filtering on the Procedural Class (TPU) and specific Court Organ code.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with CNJ (Datajud API Pública), then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
CNJ Datajud API Pública lets your AI client dig deep into the Brazilian judicial system. You'll get detailed metadata on lawsuits, court movements, and procedural history from the official national database. You can run deep searches using unique CNJ numbers, filter processes by specific Procedural Classes (TPU), or execute advanced Elasticsearch queries across various courts like TRF and TJ. search_process_by_number finds a single lawsuit by its full CNJ number, working across aliases like TRF1 or TJSP. search_processes_by_class_and_organ lets you filter processes by a specific Procedural Class (TPU) and a Court Organ code. search_processes_advanced runs complex searches using Elasticsearch Query DSL, letting you filter records by dates, parties, or custom metadata fields.
You'll find data from TRFs, TJs, and more via their respective API aliases.
How CNJ Datajud MCP Works
- 1 First, subscribe to the server and enter your CNJ Datajud API Key.
- 2 Next, prompt your AI client (Claude, Cursor, etc.) with the specific search criteria—like a CNJ number, a date range, or a class code.
- 3 The server runs the appropriate tool against the Brazilian judicial database and returns the structured process metadata.
The bottom line is: you get immediate, structured access to the official Brazilian judicial record system without manual portal interaction.
Who Is CNJ Datajud MCP For?
This is for legal professionals, compliance teams, and data researchers who need reliable, deep access to official judicial records. If your job involves tracking lawsuit status, performing legal risk assessments, or analyzing legal trends, this server cuts out the manual, clicking-heavy process of navigating government portals.
Runs bulk queries and advanced data extractions to track legal trends or compile statistics on specific types of lawsuits.
Automates background checks and legal risk assessments by verifying the status and history of corporate entities in the judicial system.
Quickly checks the status and procedural history of specific lawsuits using their unique CNJ numbers, saving hours of portal navigation.
What Changes When You Connect
- Check a lawsuit's full history instantly. Use
search_process_by_numberto get all metadata for a specific case just by providing the CNJ number, skipping manual portal lookups. - Run highly specific data queries.
search_processes_advancedlets your agent execute complex Elasticsearch searches, filtering by dates or parties that a standard search form can't reach. - Target by legal category. Use
search_processes_by_class_and_organto narrow down results, finding processes based on their Procedural Class (TPU) and the court organ. - Access multiple court systems. The server covers data from TRFs, TJs, TST, and more, letting you compare records across various Brazilian courts.
- Automate compliance checks. Your agent can systematically run checks across multiple processes to perform bulk legal risk assessments, which is crucial for due diligence.
Real-World Use Cases
Verifying a corporate dispute status
A compliance officer needs to know the current status of a company mentioned in a lawsuit. Instead of navigating to multiple court sites, they ask their agent to run search_process_by_number with the CNJ number. The agent returns the current status and the most recent court movement immediately.
Analyzing legal sector trends
A research analyst wants to see how many 'Tax Execution' cases happened in the last quarter. They ask their agent to run search_processes_advanced with specific date ranges and metadata filters, getting a structured list of relevant cases.
Finding all similar lawsuits
A paralegal needs to find all ongoing lawsuits related to a specific type of dispute (e.g., labor disputes). They ask the agent to use search_processes_by_class_and_organ, filtering by the known Procedural Class (TPU) code and the relevant court organ.
Comprehensive due diligence
A legal team needs to check a client's history across three different courts (TRF1, TST, TJSP). They configure their agent to run search_process_by_number three times, once for each court alias, consolidating the data into a single risk report.
The Tradeoffs
Searching by vague keywords
Asking the agent to 'find processes about money problems in São Paulo'. This is too broad and the API needs structured data, not general text search.
→
You must use the structured tools. Use search_processes_by_class_and_organ to filter by the specific Procedural Class (TPU) code, or use search_processes_advanced to narrow the search by date range or specific party names.
Manually checking court websites
Opening the TRF1 site, finding the search box, entering the number, waiting for the page to load, and copying the status. This is slow and prone to human error.
→
Just ask your agent to run search_process_by_number and specify the correct court alias. The agent handles the connection and extraction, giving you the result in seconds.
Trying to query all data at once
Asking the agent to 'give me every single process ever filed'. The database is too large, and the API requires specific filters to run efficiently.
→
Always use search_processes_advanced. You must provide constraints like a date range, specific parties, or a Procedural Class to get actionable, filtered results.
When It Fits, When It Doesn't
Use this server if your job requires deep, systematic querying of official Brazilian judicial records. Specifically, if you need to check a case by its unique CNJ number, or if you need to filter massive datasets using specific legal codes (Procedural Class/Organ). Don't use this if you just need general legal definitions or basic web browsing; your agent can't read the law itself. If your goal is to compare records across different court types (e.g., TRF vs. TST), this server is built for that. However, if you only need to check a single, simple record and don't know the CNJ number, you might first need a tool that helps locate the correct alias or class code before using search_processes_by_class_and_organ.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by CNJ Datajud. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 3 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Tracking a case status shouldn't require three different government portals.
Today, checking a single lawsuit's history means logging into the court's specific website. You enter the number, hit submit, and then you wait for the page to load. If the process is complex, you might have to navigate through five different tabs just to see the most recent movement, risking copy-paste errors every time.
With the CNJ Datajud MCP Server, you just tell your agent the CNJ number. It runs `search_process_by_number` and returns the full, structured history—status, class, and movements—in a single block of text. You get the answer, not a webpage.
CNJ Datajud MCP Server: Query Brazil's judicial records.
Forget the manual process of researching legal trends. You used to pull data in small batches, requiring you to repeat searches for different dates or different types of cases. This was tedious, manual data assembly.
Now, your agent runs `search_processes_advanced` with complex Elasticsearch queries, allowing you to define date ranges, party filters, and metadata fields all at once. You get a structured, comprehensive dataset instantly.
Common Questions About CNJ Datajud MCP
How do I search for a process using the CNJ Datajud API Pública with the CNJ (Datajud API Pública) MCP Server? +
You use the search_process_by_number tool. Just provide the unique CNJ number and the specific court alias (like TRF3). The agent handles the connection and data retrieval for you.
Can I run a complex query on dates using the CNJ Datajud API Pública with the CNJ (Datajud API Pública) MCP Server? +
Yes, you use the search_processes_advanced tool. This tool executes full Elasticsearch queries, letting you filter results by specific date ranges, parties, or other metadata.
What if I don't know the CNJ number but know the class and organ? +
Use the search_processes_by_class_and_organ tool. You provide the Procedural Class (TPU) code and the Court Organ code, and the server finds all matching processes.
Is the CNJ Datajud API Pública with the CNJ (Datajud API Pública) MCP Server reliable? +
Yes, it connects directly to the official national database. This server provides structured access to official records from various Brazilian courts (TRFs, TJs, TST, etc.).
How do I use the `search_processes_advanced` tool to filter by parties and dates? +
You execute the advanced Elasticsearch query using your AI client. You specify the date range, party names, and other metadata fields directly in the prompt. This lets you filter results far beyond just the process number.
What do I need to set up the CNJ (Datajud API Pública) MCP Server? +
You must subscribe to the server and provide your valid CNJ Datajud API Key. Once authenticated, your AI client connects to the service. You'll start querying the Brazilian judicial database from your preferred environment.
Can the `search_processes_by_class_and_organ` tool handle multiple court aliases? +
Yes, the server supports data from various courts like TRFs, TJs, and TST. You simply need to specify the desired court alias when requesting the search. The tool handles the correct data source connection.
What happens if my query fails or returns an error code? +
The server returns an explicit error message detailing the failure. This message includes the specific reason—for instance, invalid API key, malformed query syntax, or unsupported field. You can then adjust your prompt accordingly.
How do I find a process if I only have the CNJ number? +
Use the search_process_by_number tool. You will need the unformatted digits of the process and the specific court alias (e.g., api_publica_tjsp for São Paulo State Court).
Can I list multiple processes from a specific court organ? +
Yes, use search_processes_by_class_and_organ. Provide the court alias, the procedural class code, and the organ code. You can also control the result size and use pagination.
What is the 'Advanced Search' tool for? +
The search_processes_advanced tool allows you to send a raw Elasticsearch query body. This is useful for complex filtering that isn't covered by standard search tools, such as filtering by specific dates or nested metadata.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Mistral AI
Build with European open-weight language models that deliver strong reasoning, multilingual capability, and efficient inference.
CountryStateCity
Access global geographic data — list countries, states, and cities with ISO codes and metadata directly from any AI agent.
Airparser
AI data extraction orchestration — parse PDFs, emails, and images into structured data via AI.
You might also like
Play.ht (AI Voice Generation & TTS)
Generate ultra-realistic AI voices and convert text to speech instantly using Play.ht's advanced neural engine.
Datadog
Monitor applications via Datadog — query performance metrics, search logs, and list active monitors directly from any AI agent.
IMDB API (Unofficial)
Search movies and TV shows — audit ratings, cast, and metadata via IA.