Jusratio

Listed on Anthropic Connectors Directory Status

JusRatio is a hosted Remote MCP server providing semantic + lexical search of Brazilian jurisprudence (STF, STJ, state courts) and federal legislation — with verifiable citations (every result links back to the canonical source) and overruling alerts (knows when a precedent has been superseded).

This repository contains the public manifest, integration guides, and tool reference. The server implementation is hosted at https://mcp.jusratio.com.br/mcp — no local installation required.

---

What it does

• Hybrid retrieval — dense embeddings (Gemini) + BM25 lexical scoring + LLM reranking
• Authority-aware ranking — privileges binding precedents (Súmula Vinculante, Tema Repetitivo, Repercussão Geral) over orientative case law
• Verifiable citations — every result includes the canonical URL of the source court (no fabrication)
• Overruling alerts — surfaces when a precedent has been superseded
• Coverage — 327k STJ panel decisions, 537k STF/STJ canonical documents, 9,673 articles across 37 federal diplomas

Tools (12)

Tool	Title	What it does
pesquisar_documentos	Pesquisar jurisprudência	Hybrid search of Brazilian case law with verifiable citations
buscar_legislacao	Buscar legislação federal	Search federal legislation (CF, CC, CPC, CLT, etc.)
obter_resultado_pesquisa	Verificar status da pesquisa	Poll status of async search jobs
obter_documento	Ler decisão completa	Retrieve full text of a decision
obter_documento_chunk	Ler trecho de decisão	Paginated chunk reader for large documents
read_decisao_pdf_chunk	Ler PDF do acórdão	Read full PDF of a decision (chunked)
listar_overruling_por_tema	Listar precedentes superados	List superseded precedents on a topic
listar_tribunais	Listar tribunais	List indexed courts and document counts
listar_ramos_direito	Listar ramos do direito	List indexed areas of law
timeline_decisoes	Linha do tempo de decisões	Chronological view of decisions
informativo_juridico	Listar informativos do STF e STJ	Recent STF/STJ informational bulletins
listar_estatisticas_uso	Ver estatísticas de uso	Server usage stats

All tools are read-only (readOnlyHint=true). The server does not mutate user data.

Connect

Claude Desktop / Claude.ai web

1. Settings → Connectors → Add custom connector
2. URL: https://mcp.jusratio.com.br/mcp
3. Sign in with the JusRatio account you created at jusratio.com.br

Full guide: jusratio.com.br/docs/instalacao-claude-desktop

Codex Desktop / OpenAI

Settings → Connectors → Add Custom MCP Server with the same URL.

Full guide: jusratio.com.br/docs/codex-desktop

Google Antigravity

Full guide: jusratio.com.br/docs/antigravity

Other MCP-compatible clients

The server speaks streamable HTTP MCP with OAuth 2.1 + PKCE (S256) and Dynamic Client Registration (RFC 7591). Any spec-compliant client should work.

Authentication

• OAuth 2.1 with PKCE (S256) — interactive sign-in via browser
• RFC 8414 — server metadata at /.well-known/oauth-authorization-server
• RFC 9728 — protected resource metadata at /.well-known/oauth-protected-resource
• RFC 7591 — Dynamic Client Registration at /oauth/register
• Bearer tokens — long-lived API keys for headless / programmatic clients (manage at jusratio.com.br/app/chaves)

Pricing

Plan	Price	Searches/month
Free	R$ 0 (no credit card)	10
Pro Annual	R$ 21.90/month (R$ 262.80/year)	60
Pro Monthly	R$ 29.90/month	60

Gemini reranking costs are absorbed by JusRatio in all tiers — no BYOK required, no Google Cloud account needed.

Multiple tool calls within ~5 minutes of the same session count as one search (burst grouping). Don't be conservative on tool calls; the server groups them.

Privacy & Terms

• Privacy Policy (LGPD-compliant): jusratio.com.br/privacidade
• Terms of Use: jusratio.com.br/termos
• DPO contact: [email protected]
• Brazil-based (Lei nº 13.709/2018 — LGPD applies)

Support

• Status: jusratio.com.br/status
• Email: [email protected]
• Integration issues: open an issue in this repository
• Server bugs / data quality: same email above

License

This documentation repository is MIT-licensed (see LICENSE). The server implementation is proprietary.

---

Built by Carlos Victor Rodrigues. Hosted on Fly.io (gru region, São Paulo) with Postgres (Supabase) + Qdrant Cloud + Gemini (Google).