zyta-expedientes-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@zyta-expedientes-mcp list my expedientes from PJN"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
zyta-expedientes-mcp (Clio)
Servidor MCP (stdio) para Clio (Expedientes): portales judiciales (PJN, MEV, CABA) y causas sin portal.
Arquitectura
Componente | Rol |
Zyta-be | Login JWT, device flow OAuth, perfil usuario |
expedientes-api | Portales, listado, sync, CRUD causas sin portal, actuaciones cursor |
Zyta-expedientes (web) | Página |
El MCP autentica contra Zyta-be y consulta expedientes-api con el mismo Bearer JWT.
Related MCP server: juscraper-mcp
Configuración en Cursor
{
"mcpServers": {
"zyta-expedientes": {
"command": "npx",
"args": ["-y", "zyta-expedientes-mcp@latest"],
"env": {
"ZYTA_API_BASE_URL": "http://localhost:3333",
"EXPEDIENTES_API_BASE_URL": "http://localhost:8788",
"ZYTA_EXPEDIENTES_APP_URL": "http://localhost:8892"
}
}
}
}En producción:
ZYTA_API_BASE_URL=https://zyta-be-production.up.railway.app
EXPEDIENTES_API_BASE_URL=https://zyta-expedientes-api-production.up.railway.app
ZYTA_EXPEDIENTES_APP_URL=https://dashboard.zyta.appOpcional en Railway (Zyta-be): MCP_DEVICE_VERIFICATION_BASE_URL=https://dashboard.zyta.app
Herramientas
Tool | Descripción |
| Device flow / email / token manual |
| Cierra sesión del agente |
| Usuario actual |
| Estado + URLs |
| PJN / MEV / CABA / INPI conectados |
| Listar expedientes (filtro por portal) |
| Leer detalle + actuaciones |
| Crear causa sin portal |
| Editar causa sin portal (+ seguimiento opcional) |
| Borrar causa sin portal |
| Sincronizar portales (sin credenciales) |
| Actuación en causa sin portal |
| Honorarios del expediente |
| Alta de honorarios |
| Actualizar honorario |
| Borrar honorario |
| Vencimientos/tareas |
| Nueva tarea |
| Actualizar tarea |
| Borrar tarea |
| Alarmas |
| Nueva alarma |
| Actualizar alarma |
| Borrar alarma |
Token persistido en ~/.zyta-expedientes-mcp/token.
Desarrollo local
cd Zyta/zyta-expedientes-mcp
npm install
npm run build
npm run devSmoke test:
Levantá Zyta-be, expedientes-api y Zyta-expedientes
En Cursor:
zyta_expedientes_login→ autorizá en http://localhost:8892/mcp-devicezyta_expedientes_auth_status→hasToken: truezyta_expedientes_portales_status
Probar el stack completo
Sí, hay que probar los tres servicios juntos:
# Terminal 1 — monolito (auth)
cd BE/Zyta-be && npm run start:dev
# Terminal 2 — microservicio expedientes
cd Zyta/expedientes-api && npm run dev
# Terminal 3 — front
cd Zyta/Zyta-expedientes && npm run dev
# Terminal 4 — MCP (via Cursor o)
cd Zyta/zyta-expedientes-mcp && npm run devSin proxy en Zyta-be todavía, el front y el MCP apuntan directo a cada API por URL.
Available Tools
24 toolszyta_expedientes_alertas_createC
Crea alarma/recordatorio en un expediente. POST …/alertas
Inputs: titulo (required), expedienteId (required), fechaVencimiento (required), estado, +2 more.
zyta_expedientes_alertas_deleteC
Elimina una alarma. DELETE …/alertas/:id
Inputs: alertaId (required), expedienteId (required).
zyta_expedientes_alertas_listB
Lista alarmas de un expediente. GET …/alertas
Inputs: expedienteId (required), page, limit, estado, +2 more.
zyta_expedientes_alertas_updateC
Actualiza alarma (ej. resuelta). PATCH …/alertas/:id
Inputs: alertaId (required), expedienteId (required), estado, titulo, +3 more.
zyta_expedientes_auth_statusA
Estado de sesión: token, URLs de Zyta-be y expedientes-api. No muestra el token.
Inputs: no named parameters.
zyta_expedientes_createA
Crea una causa sin portal (fichero propio). POST /judicial/expedientes. Cuenta para el cupo del plan. No aplica a causas PJN/MEV/CABA.
Inputs: caratula (required), numeroExpediente (required), fuero, estado, +2 more.
zyta_expedientes_deleteA
Elimina una causa sin portal y sus actuaciones (cascada). DELETE /judicial/expedientes/:id. No borra causas sincronizadas desde PJN/MEV/CABA.
Inputs: id (required).
zyta_expedientes_disconnectA
Cierra sesión del agente (~/.zyta-expedientes-mcp/token).
Inputs: no named parameters.
zyta_expedientes_getA
Lee un expediente con actuaciones. GET /judicial/expedientes/:id (cualquier portal).
Inputs: id (required).
zyta_expedientes_honorarios_createC
Registra honorarios en un expediente. POST …/honorarios
Inputs: tipo (required), fecha (required), monto (required), concepto (required), +9 more.
zyta_expedientes_honorarios_deleteC
Elimina un honorario. DELETE …/honorarios/:id
Inputs: honorarioId (required), expedienteId (required).
zyta_expedientes_honorarios_listC
Lista honorarios de un expediente. GET …/honorarios
Inputs: expedienteId (required), page, limit, estado.
zyta_expedientes_honorarios_updateC
Actualiza un honorario (ej. marcar cobrado). PATCH …/honorarios/:id
Inputs: honorarioId (required), expedienteId (required), tipo, fecha, +9 more.
zyta_expedientes_listB
Lista expedientes del usuario. Filtro opcional por portal(s). GET /judicial/expedientes
Inputs: limit, portal, portals.
zyta_expedientes_loginA
Obligatorio antes de otras herramientas si no hay sesión. Device flow (prod: dashboard.zyta.app/mcp-device; local: :8892/mcp-device), email+password, o access_token manual.
Inputs: email, password, access_token.
zyta_expedientes_portales_statusA
Estado de conexión PJN, MEV (scba), CABA e INPI. GET /portales/status en expedientes-api.
Inputs: no named parameters.
zyta_expedientes_registrar_actuacionB
Registra actuación en causa sin portal (IA elige causa si no hay expedienteId). POST /judicial/cursor/registrar-actuacion
Inputs: message (required), link, expedienteId.
zyta_expedientes_syncA
Sincroniza expedientes desde portales conectados. POST /portales/sync o /portales/sync/:portal. No expone credenciales — solo dispara sync con sesión ya conectada en la app.
Inputs: portal.
zyta_expedientes_tareas_createC
Crea vencimiento/tarea en un expediente. POST …/tareas
Inputs: titulo (required), expedienteId (required), estado, prioridad, +2 more.
zyta_expedientes_tareas_deleteC
Elimina una tarea. DELETE …/tareas/:id
Inputs: tareaId (required), expedienteId (required).
zyta_expedientes_tareas_listC
Lista vencimientos/tareas de un expediente. GET …/tareas
Inputs: expedienteId (required), page, limit, estado, +1 more.
zyta_expedientes_tareas_updateC
Actualiza tarea (ej. completada). PATCH …/tareas/:id
Inputs: tareaId (required), expedienteId (required), estado, titulo, +3 more.
zyta_expedientes_updateC
Edita una causa sin portal. PATCH /judicial/expedientes/:id. Solo portal sin_portal. Opcional enSeguimiento → PATCH …/seguimiento.
Inputs: id (required), fuero, estado, juzgado, +4 more.
zyta_expedientes_whoamiB
Usuario del token JWT (GET /users en Zyta-be).
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Each tool targets a distinct resource-action pair (e.g., alertas_create vs. alertas_delete). The CRUD groups for expedientes, alertas, honorarios, and tareas are clearly separated, and authentication and status tools are unique.
All tool names follow the pattern zyta_expedientes_<resource>_<action>, with consistent use of snake_case and verb_noun ordering. The only minor variation is registrar_actuacion, which still fits the overall convention.
24 tools is slightly above the typical 3-15 range but still reasonable for a comprehensive legal case management system covering CRUD for multiple sub-resources plus authentication and synchronization. Each tool has a clear purpose.
The tool set covers full CRUD for expedientes, alertas, honorarios, and tareas, plus authentication, portal status, and sync. Minor gaps like document attachment might exist, but core workflows are well-covered.
Related MCP Connectors
MCP server for Muovi, Argentina's trust-first local services marketplace: find pros, draft tasks.
Brazilian legal stack in one MCP: lawsuits, court publications, case law, tenders, certificates.
Law firm management MCP: manage cases, clients, tasks, calendar and documents via Claude AI.
MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceRemote MCP server that provides access to over 285K Argentine court rulings and user's own case files via Streamable HTTP transport.-
- AlicenseNot gradedqualityDmaintenancePublic MCP server for querying Brazilian court jurisprudence, processes, and communications without authentication. Supports courts like TJSP, TJRS, TJRJ, TJGO, and more via eSAJ, Datajud, and CNJ systems.8MIT
- FlicenseAqualityBmaintenanceMCP server that provides access to Argentine legal documents (legislation, CSJN jurisprudence, international treaties) with verifiable provenance including SHA256 hashes and source URLs, enabling legal professionals to search and verify citations.13-
- FlicenseAqualityBmaintenanceUnofficial read-only MCP server for querying public civil court cases from the Chilean Judicial Branch, providing case data and notary actions with real diligence dates.142-