How to Use the CNJ (Datajud API Pública) MCP in Claude Code

Q: How do I add the CNJ (Datajud API Pública) MCP Server to Claude Code?

Run claude mcp add --transport http cnj-datajud -- in your terminal. This command registers the server in your /.claude.json configuration file, making all three tools instantly available.

Query CNJ (Datajud API Pública) directly from your terminal and pipe Brazilian legal data into Claude Code using this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect CNJ (Datajud API Pública) MCP to Claude Code

Create your Vinkius account to connect CNJ (Datajud API Pública) to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup CNJ (Datajud API Pública) with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pull court records straight to stdout

The `search_process_by_number` tool fetches raw judicial records from specific Brazilian court APIs directly into your terminal session. You can pass a process number and target court, and Claude Code outputs the clean JSON payload. Because this runs in your terminal, you can pipe the output directly into utilities like jq, grep, or local databases. It makes integrating Brazilian legal data into backend pipelines incredibly straightforward.

Run batch legal searches via this MCP Server

The `search_processes_advanced` tool executes raw Elasticsearch queries against the public Datajud database. This lets your terminal agent run complex, multi-field searches without leaving the command line. You can write a quick bash script that feeds list inputs into Claude Code. The agent runs the queries in parallel, formats the results, and writes them to a CSV file in seconds.

Filter cases by class and organ in the shell

The `search_processes_by_class_and_organ` tool filters Brazilian lawsuits by their procedural class and court organ. It allows your command-line agent to quickly isolate specific types of cases during automated audits. This tool is perfect for CI/CD pipelines or cron jobs. You can set up a daily task that queries a specific court organ and alerts your team if any new cases match your search criteria.

Setup guide

Set up CNJ (Datajud API Pública) MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see cnj-datajud-api-publica-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest CNJ (Datajud API Pública) transactions." It will automatically discover and invoke the available CNJ (Datajud API Pública) tools.

Terminal

claude mcp add --transport http cnj-datajud-api-publica-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the CNJ (Datajud API Pública) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "cnj-datajud-api-publica-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect CNJ (Datajud API Pública) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about CNJ (Datajud API Pública) MCP in Claude Code

Run `claude mcp add --transport http cnj-datajud -- ` in your terminal. This command registers the server in your `~/.claude.json` configuration file, making all three tools instantly available.

Yes. You can tell Claude Code to run a search and pipe the output to a local file or a command-line tool like jq to filter out specific fields immediately.

The MCP Server manages the authentication headers for courts like TJSP or TRF1. You only need to provide your single Vinkius endpoint token when adding the server to Claude Code.

Absolutely. Since Claude Code operates headlessly, you can trigger it via shell scripts to run automated search queries against the Datajud API at scheduled intervals.

Yes, all communication is encrypted and processed through an ephemeral V8 sandbox. Your queries and retrieved court records are never logged or stored by Vinkius, ensuring your terminal-based legal research remains completely private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript