Lumina
DocumentationSupportTerms of UsePrivacy Policy
Português

Lumina connector documentation

Updated on November 12, 2026. Leia esta página em português, with screenshots of every step.

Lumina is a searchable collection of Brazilian federal case law. The connector lets an AI assistant such as Claude or ChatGPT search decisions of the TRF1 (Federal Regional Court of the 1st Region), the STJ (Superior Court of Justice) and the STF (Supreme Federal Court), read the full text and cite each decision by its case number. The documents are in Portuguese, and so are the tool descriptions and responses.

Lumina is operated by Rafael Coutinho Rocha Mello Consultoria em TI Ltda. (Lumina Juris), Brasília, Brazil.

  • Requirements
  • How to connect
  • Authentication and permissions
  • Tools
  • Example prompts
  • Limitations
  • Privacy and data
  • Disconnecting
  • Support

Requirements

  • A Lumina account with active access to the collection. Accounts are created at luminajuris.com.br/register.
  • Your own Claude or ChatGPT account, on a plan that supports connectors.

The server is a remote MCP server (streamable HTTP). The address is the same for everyone and is not a secret; access is granted by signing in to Lumina.

https://luminajuris.com.br/mcp

How to connect

Claude

  1. In Claude (claude.ai), open Settings and then Connectors.
  2. Select Add, then Add custom connector. Name it Lumina, paste the address above and continue.
  3. Claude detects the authentication settings on its own (sign in now, automatic registration). Leave them as they are and select Add.
  4. Lumina now appears in the list. Select Connect. Lumina opens its authorization screen: sign in with your Lumina e-mail and password if asked, check the account shown and select Autorizar (Authorize).
  5. On the Lumina connector page, under tool permissions, choose Always allow, so Claude does not ask before every search.

ChatGPT

  1. In ChatGPT (chatgpt.com), open Settings, then Plugins, then Explore catalog.
  2. Select Add, then Add custom MCP server. Name it Lumina, keep “Server URL”, paste the address above, keep OAuth as the authentication, accept the notice and create the plugin.
  3. Select Connect Lumina. Lumina opens its authorization screen: sign in with your Lumina e-mail and password if asked, check the account shown and select Autorizar (Authorize).
  4. Back in Settings and Plugins, open Lumina and choose Allow all tools, so ChatGPT does not ask before every search.
  5. Start a new conversation in Work mode before writing the request.

Other MCP clients

Any client that supports remote MCP servers with OAuth can use the same address. The server supports OAuth 2.1 with PKCE and Dynamic Client Registration, and publishes its discovery metadata at the standard /.well-known/ paths.

After connecting, start a request with “Use a Lumina” (“Use Lumina”).

Authentication and permissions

Each person signs in with their own Lumina account through OAuth 2.1. The AI assistant never receives the password. The authorization screen names the assistant that is asking for access and lists what it will be able to do:

  • search decisions of the TRF1, the STJ and the STF;
  • read the full text of the documents it finds;
  • look up binding precedents and their current status;
  • read the court map and the lists of judges, case classes and document types.

Access is read-only. No tool changes anything in the account or in the collection.

Tools

All tools are read-only and query Lumina's own collection, not the open web.

ToolWhat it does
buscar_jurisprudenciaSearches decisions by text and filters: court, panel, reporting judge, case class, document type, dates, case number and, for TRF1, judgment date, voting outcome and extended panel. Returns each document's metadata and an excerpt, not the full text.
obter_documentoReturns the full text of one document, by the id returned by the search. Long documents can be read in parts.
consultar_precedentesLooks up binding precedents of the STJ, the STF, the TRF1 and the TNU (repetitive-appeal themes, general-repercussion themes, súmulas, IRDR and IAC): the holding, today's status and any suspension order, with the official source of each field.
obter_mapa_tribunalShows the court's structure (Sections, Panels and chambers) and how much of each chamber the collection covers.
listar_gabinetesLists the chambers present in the collection, with panel, section and instance.
listar_magistradosLists the judge names accepted by the reporting-judge filter.
listar_tiposLists the document types in the collection (judgment, vote, headnote, decision and others).
listar_classesLists the case classes in the collection, with the number of documents in each.
searchPlain text search over the TRF1 collection. It exists for AI clients that require a tool with this exact name.
fetchReturns the full text of a TRF1 document found by the plain search.

The collection holds judgments, headnotes, votes, reports and single-judge decisions of the TRF1 (full coverage of the appellate level since May 2023), judgments and single-judge decisions of the STJ, and judgments, decisions, súmulas and bulletins of the STF. All of it is public court material, indexed and stored by Lumina.

Example prompts

Prompts are written in Portuguese, as the users write them.

Use a Lumina e me traga 5 ementas recentes da 6ª Turma do TRF1 sobre carência do FIES durante a residência médica, com número do processo, relator e data.

Use a Lumina. Qual é a tese do Tema 985 do STF e qual a situação dele hoje? Depois mostre como a 4ª Seção do TRF1 vem aplicando.

Use a Lumina para buscar no STJ acórdãos da Primeira Seção sobre exclusão do ICMS da base de cálculo do PIS e da Cofins e resuma os três mais recentes.

Use a Lumina e abra o inteiro teor do acórdão mais recente que você encontrou. Diga quem foi o relator e como foi a votação.

Limitations

  • Read-only: the AI searches and reads the collection. It does not file petitions, track case dockets or change anything in your account.
  • The collection covers the TRF1, the STJ and the STF. No other courts.
  • Sealed cases only appear when the court itself has published the act.
  • Answers are written by your AI assistant, not by Lumina. Check the decision by its case number before relying on it.
  • Each account keeps one AI assistant connected at a time. Connecting another one disconnects the previous one.

Privacy and data

Lumina does not store what the person asked the AI assistant, the search terms or the case numbers typed. For each tool call it stores the account, the time, the tool used, the duration, the number of results, the shape of the query (how many terms and which filters, without their values) and the ids of documents opened in full. The connector does not read conversation history, memory or files from the assistant. The full text is in the Privacy Policy (in Portuguese).

Disconnecting

Remove Lumina in the assistant's settings, or sign in to Lumina and open the Connector page, which lists the connected assistants and revokes each one. Changing the Lumina password also revokes every connection.

Support

Write to [email protected], in English or in Portuguese, or see the support page. To report a security issue, use the same address with “Security” in the subject.