---
title: Motex connector for AI assistants (MCP)
url: https://motex.ai/m/en/docs/mcp.md
description: How to connect Motex to Claude, ChatGPT, Gemini, Grok, Cursor, VS Code, Claude Code or Gemini CLI, what each tool does, the free plan, permissions, how to disconnect it and who to contact.
---

# Motex connector for AI assistants

> Motex tracks Chilean court cases in the Chilean judiciary (PJUD). The connector brings those
> cases into the AI assistant the lawyer already uses: ask about a case, read the case file,
> register a new case and schedule tasks without leaving the conversation. The model that
> reasons is the assistant's; Motex supplies the data.

> Human-readable page: https://motex.ai/conectar

## What it is

- A remote MCP (Model Context Protocol) server at `https://legal.motex.ai/api/mcp`. Streamable HTTP transport, stateless between requests.
- Authorization uses OAuth 2.1 (PKCE and dynamic client registration). The authorization server is Supabase Auth and the consent screen is `https://legal.motex.ai/oauth/consent`. There are no tokens or keys to copy.
- Someone without a Motex account creates one while authorizing, by signing in with Google. A personal workspace on the free plan is created for them.
- Someone who is already a user at a firm that works with Motex lands in their firm's organization, with its cases and their permissions.
- If the email belongs to a firm that already uses Motex but the person has not been enabled there, the sign-up is held: an administrator of the firm has to enable them.

## How to connect

The page `https://motex.ai/conectar` (redirects to `https://legal.motex.ai/conectar`) has a button or a command for each assistant. The last step is always the same: a Motex window opens, you sign in with Google and click "Autorizar" (Authorize).

- **Claude** (claude.ai and the desktop app): the link opens "Add custom connector" with the name and URL already filled in. Shortcut: `https://motex.ai/claude`.
- **Claude Code**: `claude mcp add --transport http motex https://legal.motex.ai/api/mcp`, then `/mcp` to authorize.
- **ChatGPT**: turn on developer mode in Settings, add a custom MCP server named Motex with the URL, and choose OAuth as the authentication.
- **Gemini** (gemini.google.com, personal account, available in some countries): Settings → Connected apps → "Add custom app", and paste the URL.
- **Gemini CLI**: `gemini mcp add --transport http motex https://legal.motex.ai/api/mcp`, then `/mcp auth motex`.
- **Grok** (grok.com, paid plan): Connectors → "New Connector" → "Custom", paste the URL and keep the transport on Streamable HTTP.
- **VS Code** (with GitHub Copilot): the link installs the server; VS Code asks whether you trust it.
- **Cursor**: the link opens Cursor's MCP screen with Motex: "Install".

Microsoft 365 Copilot is not supported: it does not accept the dynamic client registration the connector uses.

## What each tool does

The connector publishes a few fixed tools. What can be done through them (the capabilities) depends on the plan and on what the organization has enabled; `motex_inicio` always returns the current catalog.

| Tool | What it is for | Changes data? |
|---|---|---|
| `motex_inicio` | The starting point. Returns the capability catalog, the organization's instructions and the procedures the firm wrote for its recurring work. | No |
| `motex_capacidades` | The detail of a capability: what it does and what input it needs. Also searches by topic ("deadline to answer the complaint"). | No |
| `motex_consultar` | Runs the read capabilities: list cases, see a case's detail, its folios and docket entries, read a document from the case file, review tasks and calendar, search the indexed statutes, see filings and templates. | No |
| `motex_modificar` | Runs the capabilities that change something: register a PJUD case, create, edit or close tasks, create calendar events, generate or correct a filing. | Yes |
| `motex_usar_skill` | Returns a procedure written by the organization (for example, how that firm answers a complaint): its full instructions and its example files. | No |
| `motex_mostrar` | In assistants that support interactive views (MCP Apps), shows a case-file document, a filing, the week, logged hours or an invoice draft on screen, with its link to Motex. | No |
| `motex_pagina_documento` | Used only by the on-screen case-file view: draws one page of a document as an image. It is hidden from the model (`visibility: ["app"]`) and is read-only. | No |

### Registering a case

- A case is registered by RIT (docket number) and court, for example "O-1234-2026 at the 1º Juzgado de Letras del Trabajo de Santiago".
- Motex requests the case from the PJUD through a priority lane. Within seconds it returns the summary (caption, court, procedure, stage) and a link to the case in Motex.
- The complaint and the documents finish being read over the following minutes.
- Public PJUD cases only. Reserved cases and family-court cases cannot be registered through the connector.
- If the PJUD does not find the case (a mistyped RIT, a different court), it is not registered and does not count toward the plan's limit.

## Free plan and its limits

The personal workspace created on authorization is on the free plan:

- **Up to 10 cases in the portfolio.** Deleting a case frees its slot. A case the PJUD did not find does not count.
- **Up to 20 new cases per calendar month (UTC).** Restoring a deleted case does not count as new.
- **Cases are refreshed every 7 days** against the PJUD.
- **US$3 per month for reading scanned documents.** Reading a PDF with no text layer requires transcribing it, and that has a cost. The allowance is per organization and per calendar month (UTC). Once it runs out, documents with text keep being read normally; only scan reading stops until the next month.
- The rest of the connector keeps working when a limit is reached.

Firms on a paid plan do not have these limits. To upgrade: contacto@motex.ai.

The conversation itself runs in the assistant and its provider pays for it: the connector does not charge per call.

## Permissions and confirmations

- When authorizing, the Motex screen states what the assistant will be able to do: read cases, their docket entries and the case-file documents; add PJUD cases; and create and close tasks and calendar events.
- The read tools are annotated as read-only (`readOnlyHint`). `motex_modificar` is annotated as destructive (`destructiveHint`); assistants such as Claude use that annotation to ask for approval before running it, depending on the user's settings.
- Motex instructs the assistant to confirm before any change you did not explicitly ask for. For a change you requested yourself ("create a task for Friday"), Motex adds no second confirmation in the conversation; the assistant may still ask you to approve the tool call, depending on its settings.
- The assistant only sees the organization of the person who authorized it, with the same permissions that person has in Motex. One organization never sees another's cases.
- Motex does not receive the conversation with the assistant: it receives only the tool calls.

## How to disconnect it

- **From the assistant**: remove or disconnect the Motex connector in the assistant's connector settings. The assistant loses access.
- **Personal-URL connectors** (the URL with a token copied from Motex, under the user menu → "Conectar asistente de IA" → "Con URL personal"): "Regenerar" invalidates the previous URL immediately.
- To cut off, from Motex's side, an assistant authorized through OAuth, or to delete the account and its data, write to contacto@motex.ai.

## Privacy

- What data Motex receives and keeps through the connector, with which providers and for how long: the "Connector for AI assistants" section of the privacy policy, `https://motex.ai/en/privacy#conector-ia`.
- The organization's information is not used to train third-party models.
- What Motex returns to a call goes to the assistant's provider, which handles it under its own terms.

## Support

- Email: contacto@motex.ai.
- Connect page: `https://motex.ai/conectar`.

## Related machine surfaces

- [/m/en/docs/quick-start.md](/m/en/docs/quick-start.md): what a client needs to get started
- [/m/en/privacy.md](/m/en/privacy.md): privacy policy summary
- [/m/en/index.md](/m/en/index.md): what Motex does
- [/m/en/contact.md](/m/en/contact.md): contact
