Tools de legal
El dominio legal es legal-dynamo, la fuente de verdad de
lo que cada cliente tiene contratado: clientes, contratantes,
contratos, SKUs, políticas, documentos y la oferta comercial. Estas
56 tools le dan a un agente la consulta y la gestión de ese
expediente, incluida la publicación de políticas y plantillas. Cada tool es una cáscara fina sobre una función
(legal.*): quién puede qué lo decide la base, nunca acá.
Corre con tu propia sesión, sobre un pool dedicado
(app_legal), nunca con una clave de servicio.
En producción legal todavía no está montado.
El gateway de producción (mcp.dynamotech.co) arranca sin
el dominio legal hasta que exista su base en producción:
estas 56 tools no aparecen en la lista del conector y el resto del
gateway funciona igual. Para comprobarlo, pedile al asistente que corra
dynamo_session_status: si
versiones.legal dice
no montado (fuera de GATEWAY_DOMAINS), legal no se sirve en
ese ambiente. En QA (mcp-qa.dynamotech.co) está montado.
Lo que devuelven es dato, no instrucciones. Cada resultado llega dentro de un bloque delimitado y nada de lo que diga un nombre, una razón social o un motivo es una orden para el asistente.
Lo que NO se hace por MCP. Publicar políticas o plantillas, terminar un contrato, enviar documentos por correo, subir archivos (firmados, propuesta, certificados), cargar la firma del representante legal, el perfil de DynamoTech y los reintentos son actos humanos y se hacen en la app de legal. Ninguna tool devuelve la firma de DynamoTech, su secreto ni la URL de un archivo: la versión final de un documento la firma el sistema.
Revocar apps pide confirmación.
legal_set_client_type, legal_end_sku,
legal_end_contract_sku y legal_set_contract_orgs
(al quitar) primero consultan la vista previa: si apagarían apps en
proyectos reales, no escriben y devuelven la lista. Solo se repite con
confirm_revocation: true si es lo que se quiere; la
revocación no se restaura.
Lectura (12)
| Tool | Qué hace | Inputs | Qué permiso hace falta | Ejemplo de prompt |
|---|---|---|---|---|
legal_list_clients |
Los clientes (una organización = un cliente) con su tipo, SKUs de demo, historial de pruebas y contratos vigentes que los cubren. |
client_type (demo, real o interna, opcional) ·
client_id (uuid, opcional)
|
Lectura del staff de legal (la base decide quién ve qué). | "¿Qué clientes demo tenemos y qué SKUs tienen?" |
legal_list_parties |
Los contratantes (persona jurídica que firma): razón social, NIT, representante, contacto y números de sus contratos. |
party_id (uuid, opcional)
|
Sesión autenticada; la base decide qué ves. | "Mostrame el contratante de Acme." |
legal_list_contracts |
Los contratos: número DT-CM, estado, proyecto del plan de trabajo, fechas, organizaciones cubiertas y SKUs activos. |
party_id (opcional) ·
contract_id (opcional)
|
Sesión autenticada; la base decide qué ves. | "¿Qué contratos vigentes tiene Acme?" |
legal_list_contract_skus |
Los SKUs de un contrato (activos y terminados) con su contract_sku_id y si ya aparecen en un documento firmado. |
contract_id
|
Sesión autenticada; la base decide qué ves. | "¿Qué SKUs tiene el contrato DT-CM-0007?" |
legal_list_contract_plan_projects |
Los proyectos que legal_set_contract_plan_project acepta como plan de trabajo (Anexo F): de las organizaciones del contrato y con Presentation habilitada.
|
contract_id
|
Sesión autenticada; la base decide qué ves. | "¿Qué proyectos puedo usar como plan de trabajo del contrato?" |
legal_list_skus |
El catálogo de SKUs con su app, estado y si está listo para la venta. |
only_ready_to_sale (opcional) ·
sku_id (opcional)
|
Sesión autenticada; la base decide qué ves. | "¿Qué SKUs están listos para la venta?" |
legal_list_client_skus |
Los SKUs de demo de un cliente (activos, suspendidos y terminados) con su client_sku_id. |
client_id
|
Sesión autenticada; la base decide qué ves. | "¿Qué SKUs de demo tiene este cliente?" |
legal_list_org_entitled_apps |
Las apps que una organización puede habilitar según lo que tiene contratado: es lo que exige el gate de auth_set_project_app. |
organization_id
|
Sesión autenticada; la base decide qué ves. | "¿Qué apps puede habilitar la organización Acme?" |
legal_list_policies |
Las versiones de las políticas (DT-PO-*, DT-PS-*) con su anexo, si es pública, si es la vigente y su hash. |
code (opcional) ·
only_current (opcional)
|
Sesión autenticada; la base decide qué ves. | "¿Cuál es la versión vigente de DT-PO-01?" |
legal_list_documents |
Los documentos de un contratante con número, versión, estado, si hay DOCX, PDF o firmado, intentos y último error. No devuelve archivos ni enlaces. |
party_id ·
contract_id (opcional)
|
Sesión autenticada; la base decide qué ves. | "¿En qué estado está el contrato marco de Acme?" |
legal_get_offer |
Las ofertas comerciales de un contrato con versión, estado, origen y veredicto. Con include_data agrega el JSON completo (precios y alcance). |
contract_id ·
include_data (opcional)
|
Sesión autenticada; la base decide qué ves. | "¿Está lista la oferta del contrato DT-CM-0007?" |
legal_get_mail_package |
El paquete de envío del contrato marco generado más reciente, en su orden, con nombre legible y tamaño de cada adjunto. No devuelve archivos ni enlaces y no envía nada. |
contract_id
|
Sesión autenticada; la base decide qué ves. | "¿Qué lleva el paquete de envío del contrato de Acme?" |
Escritura (11)
| Tool | Qué hace | Inputs | Qué permiso hace falta | Ejemplo de prompt |
|---|---|---|---|---|
legal_set_client_type |
Cambia un cliente entre demo y real. Si el cambio apagaría apps en sus proyectos, no escribe y devuelve la lista; se repite con confirm_revocation solo si es lo que se quiere. Volver real a demo exige reason. Acepta idempotency_key. |
client_id ·
client_type (demo o real) ·
confirm_revocation (opcional) ·
reason (opcional, hasta 500)
|
Sesión de scope write; la base decide quién puede. | "Pasá el cliente Acme a real." |
legal_upsert_party |
Crea o edita un contratante. Una edición reemplaza todos los campos: se manda el perfil completo. Acepta idempotency_key. |
party_id (opcional: sin él crea) ·
legal_name ·
nit ·
address ·
legal_rep_name ·
legal_rep_id ·
contact_name ·
contact_email ·
contact_role ·
organization_id (opcional)
|
Sesión de scope write; la base decide quién puede. | "Creá el contratante Acme S.A.S. con este perfil." |
legal_create_contract |
Crea un contrato en borrador para un contratante, con su número DT-CM de la numeración global. Acepta idempotency_key. |
party_id
|
Sesión de scope write; la base decide quién puede. | "Creá un contrato para Acme." |
legal_set_contract_orgs |
Agrega y/o quita clientes que cubre un contrato, en una sola transacción. Quitar en un contrato vigente exige reason y, si apagaría apps, confirm_revocation. Acepta idempotency_key. |
contract_id ·
add (hasta 50 uuid) ·
remove (hasta 50 uuid) ·
confirm_revocation ·
reason
|
Sesión de scope write; la base decide quién puede. | "Sumá la organización Acme Norte al contrato DT-CM-0007." |
legal_add_contract_sku |
Agrega un SKU listo para la venta a un contrato. No habilita la app: queda habilitable cuando el documento que lo incluye se firma. Acepta idempotency_key. |
contract_id ·
sku_id
|
Sesión de scope write; la base decide quién puede. | "Agregá el SKU de Forms al contrato DT-CM-0007." |
legal_end_contract_sku |
Termina un SKU de un contrato y revoca en la misma transacción las apps que dejan de estar respaldadas. Sin confirm_revocation no escribe si apagaría algo. Acepta idempotency_key. |
contract_id ·
contract_sku_id ·
reason (3-500) ·
confirm_revocation
|
Sesión de scope write; la base decide quién puede. | "Terminá el SKU de Analytics del contrato DT-CM-0007 por cambio de alcance." |
legal_set_contract_plan_project |
Asigna al contrato el proyecto cuyo plan de trabajo en Dynamo Presentation es el Anexo F. Acepta idempotency_key. |
contract_id ·
project_id
|
Sesión de scope write; la base decide quién puede. | "Usá el proyecto Implementación Acme como plan del contrato." |
legal_assign_sku |
Asigna un SKU a un cliente demo (si es real falla con client_not_demo). No habilita la app en ningún proyecto. Acepta idempotency_key. |
client_id ·
sku_id
|
Sesión de scope write; la base decide quién puede. | "Asignale el SKU de Forms al cliente demo." |
legal_end_sku |
Suspende o termina un SKU de demo y revoca las apps que dejan de estar respaldadas. Sin confirm_revocation no escribe si apagaría algo. Acepta idempotency_key. |
client_id ·
client_sku_id ·
status (suspendido o terminado) ·
reason (3-500) ·
confirm_revocation
|
Sesión de scope write; la base decide quién puede. | "Terminá la demo de Analytics de este cliente." |
legal_generate_document |
Pide la generación asíncrona de un documento: NDA (sin contrato), contrato marco, otrosí o propuesta comercial (Anexo A). La versión final lleva la firma de DynamoTech, que la pone el sistema y nunca se devuelve. Acepta idempotency_key. |
party_id ·
doc_type (nda, contrato_marco, otrosi, propuesta_comercial) ·
contract_id ·
is_final ·
offer_id ·
draft_for_client ·
ciudad ·
fecha
|
Sesión de scope write; la base decide quién puede. | "Generá el borrador del contrato marco de Acme para el cliente." |
legal_upsert_offer |
Crea o edita la oferta comercial (Anexo A) de un contrato y devuelve su veredicto. Acepta idempotency_key. |
contract_id ·
data (JSON de la oferta) ·
source (legal o crm, opcional)
|
Solo global-admin, con sesión de scope write (lo decide la base). | "Cargá esta oferta como Anexo A del contrato." |
legal_begin_policy_upload |
Paso 1 de publicar una política: crea (con code) o reusa (con policy_id) un borrador sin publicar y devuelve una URL de subida del PDF (credencial de escritura, 10 min); el archivo no pasa por MCP. |
code o policy_id (uno solo) ·
size_bytes ·
mime_type (application/pdf)
|
Sesión de scope write; solo global-admin con sesión humana (lo decide la API de legal). | "Creá el borrador de la política DT-AP-001 y dame la URL para subir el PDF." |
legal_begin_policy_text_upload |
Devuelve la URL de subida (credencial de escritura, 10 min) del texto web .md de una política pública que sigue en borrador (máx 64 KB, UTF-8, sin HTML). No tiene finish propio: se confirma con legal_finish_policy_upload. |
policy_id ·
size_bytes (máx 64 KB) ·
mime_type (text/markdown; charset=utf-8)
|
Sesión de scope write; solo global-admin con sesión humana (lo decide la API de legal). | "Dame la URL para subir el texto web del borrador de la política pública." |
legal_finish_policy_upload |
Paso 2 de publicar una política: confirma el PDF subido, verifica tamaño y sha256 contra los tuyos (y el del .md si es pública) y devuelve la vista previa del publish con destinatarios y confirm_digest. No publica nada. |
policy_id ·
expected_size_bytes ·
content_sha256 ·
text_sha256 (obligatorio si es pública)
|
Sesión de scope write; solo global-admin con sesión humana (lo decide la API de legal). | "Confirmá el PDF que subí al borrador de la política con este sha256." |
legal_publish_policy |
Publica una versión de política: es irreversible y avisa por correo a los clientes afectados. Por defecto dry_run es true y solo muestra la vista previa; publicar de verdad exige dry_run:false, confirm_recipients y confirm_digest. |
policy_id ·
dry_run (opcional, por defecto true) ·
confirm_recipients ·
confirm_digest
|
Vista previa (dry_run omitido o true) con scope read; dry_run:false exige scope write. Solo global-admin con sesión humana (lo decide la API de legal). |
"Mostrame la vista previa de publicar este borrador de política." |
legal_begin_template_upload |
Paso 1 de publicar una plantilla de contrato (DT-CT-00x): crea (con code) o reusa (con template_id) un borrador y devuelve la URL de subida del DOCX (credencial de escritura, 10 min). |
code o template_id (uno solo) ·
size_bytes ·
mime_type (DOCX)
|
Sesión de scope write; solo global-admin con sesión humana (lo decide la API de legal). | "Creá el borrador de la plantilla DT-CT-001 y dame la URL para subir el DOCX." |
legal_finish_template_upload |
Paso 2 de publicar una plantilla: confirma el DOCX subido, verifica su sha256 y devuelve la vista previa del publish (variables, marcas de borrador, versión que se retiraría) con confirm_digest. No publica. Acepta idempotency_key. |
template_id ·
expected_size_bytes ·
content_sha256
|
Sesión de scope write; solo global-admin con sesión humana (lo decide la API de legal). | "Confirmá el DOCX que subí al borrador de la plantilla con este sha256." |
legal_publish_template |
Publica una plantilla de contrato: pasa a ser la vigente y retira la anterior (irreversible). Por defecto dry_run es true y solo muestra la vista previa; publicar de verdad exige dry_run:false y confirm_digest. Acepta idempotency_key. |
template_id ·
dry_run (opcional, por defecto true) ·
confirm_digest
|
Vista previa (dry_run omitido o true) con scope read; dry_run:false exige scope write. Solo global-admin con sesión humana (lo decide la API de legal). |
"Mostrame la vista previa de publicar esta plantilla." |
legal_update_client |
Cambia el estado (prospecto, activo, inactivo) y/o las notas internas de un cliente. Parcial; hay que mandar al menos un campo. No cambia el tipo (legal_set_client_type). Acepta idempotency_key. |
client_id · status (opcional) · notes (opcional)
|
Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Pasá el cliente X a activo." |
legal_create_sku |
Crea un SKU en el catálogo. El code lleva prefijo DYN-PROD- o DYN-SVC- según category y es único. Nace activo, sin app y no listo para vender. Acepta idempotency_key. |
code · name · description (opcional) · category (PROD o SVC)
|
Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Creá el SKU DYN-SVC-... de categoría SVC." |
legal_update_sku |
Edita un SKU del catálogo (parcial). status descontinuado es la baja suave. El code solo cambia si el SKU no está asignado. Acepta idempotency_key. |
sku_id · code, name, description, category, status (opcionales)
|
Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Descontinuá el SKU X." |
legal_remove_sku |
BORRA un SKU sin vuelta atrás, solo si nadie lo usa (asignado, en un contrato o en un documento lo rechaza el servidor). Acepta idempotency_key. |
sku_id · confirm_code (el code exacto del SKU)
|
Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Borrá el SKU de prueba X (confirmo el código)." |
legal_list_sku_files |
Lista los archivos públicos ya subidos de un SKU, por tipo y versión descendente, con la vigente marcada. Son metadatos: no descarga el archivo. |
sku_id
|
Sesión de scope read; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "¿Qué archivos tiene subidos el SKU X?" |
legal_list_templates |
Lista las versiones de las plantillas de documentos con su estado, si es la vigente, su hash y las variables detectadas. Da el template_id de los pasos de publicar. |
code (opcional) · only_current (opcional)
|
Sesión de scope read; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Listame las plantillas vigentes." |
legal_get_org_legal_profile |
Lee el perfil legal de una organización (razón social, NIT, representante legal y su documento, dirección, ciudad, teléfono y correo). Contiene datos personales del representante. |
organization_id
|
Sesión de scope read; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Mostrame el perfil legal de la organización X." |
legal_set_org_legal_profile |
Edita el perfil legal de una organización. Parcial: cadena vacía borra el campo; hay que mandar al menos uno. Devuelve el perfil resultante. Acepta idempotency_key. |
organization_id · legal_name, nit, legal_rep_name, legal_rep_id, legal_rep_id_city, address, city, phone, email (opcionales)
|
Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Actualizá el NIT del perfil legal de la organización X." |
legal_get_download_url |
Devuelve una URL SAS de lectura (15 min) de un archivo de legal: política, plantilla, términos o archivo de un SKU, o un archivo del cliente. Es una credencial: no se guarda en el registro de idempotencia. | purpose y el id que pida cada uno (policy_id, template_id, sku_id, document_id, ...) | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Dame el enlace de descarga del contrato firmado X." |
legal_begin_sku_attachment_upload |
Paso 1 de cargar los términos de un SKU (PDF): devuelve la URL de subida directa (credencial de escritura, 10 min). Cada SKU tiene un solo adjunto y subir uno reemplaza el anterior. | sku_id · size_bytes · mime_type | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Preparame la subida de los términos del SKU X." |
legal_finish_sku_attachment_upload |
Paso 2: después del PUT, registra el PDF en el SKU. La Function exige que sea la ruta exacta del SKU, no vacío y PDF. Acepta idempotency_key. | sku_id · blob_name del paso 1 | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Confirmá la subida de los términos del SKU X." |
legal_begin_sku_file_upload |
Paso 1 de subir una versión nueva de un archivo público de un SKU: crea el borrador y devuelve la URL de subida directa. El archivo queda público e inmutable al confirmarlo. | sku_id · kind · size_bytes · mime_type | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Preparame una versión nueva de la política de datos del SKU X." |
legal_finish_sku_file_upload |
Paso 2: confirma la versión (queda como la vigente de su kind). Desde ese momento es público e inmutable. Acepta idempotency_key. | sku_id · kind · file_id · blob_name | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Confirmá la versión subida del archivo del SKU X." |
legal_terminate_contract |
Termina un contrato entero (irreversible) y revoca las apps que dejan de estar respaldadas en todas las organizaciones que cubre. Sin confirm_revocation:true solo previsualiza lo que se apagaría. Acepta idempotency_key. | contract_id · reason · confirm_revocation (opcional) | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Mostrame qué pasa si termino el contrato X." |
legal_retry_document |
Reencola un documento cuya generación quedó en error. Sin confirm_error_digest no escribe: devuelve el último error y su huella. Acepta idempotency_key. | document_id · confirm_error_digest (opcional) | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Reintentá la generación del documento X (ya arreglé la causa)." |
legal_retry_outbox |
Reencola un correo fallido; el worker lo envía a un tercero. Sin confirm_error_digest no escribe: devuelve a quién iría y la huella. Acepta idempotency_key. | outbox_id · confirm_error_digest (opcional) | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Reintentá el envío fallido X." |
legal_send_contract |
Envía por correo el contrato marco generado al contacto del contratante, con el paquete de anexos. No se puede deshacer. Sin confirm_recipient solo previsualiza el destinatario. No lleva idempotency_key: el envío vivo ya es único en la base. | document_id · confirm_recipient (opcional) | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Mostrame a quién se enviaría el contrato X." |
legal_list_outbox |
El historial de correos de un contratante: destinatario, asunto, estado, intentos, último error y adjuntos. Contiene correos de terceros. Solo lectura. | party_id · status (opcional) | Sesión de scope read; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "¿Qué correos se le enviaron al contratante X?" |
legal_get_company_profile |
El perfil legal de DynamoTech (quien firma NDA y contratos), con cédula, correo y celular enmascarados, y si hay firma y certificado cargados. Solo lectura. | — | Sesión de scope read; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "¿Quién firma por DynamoTech y qué tiene cargado?" |
legal_set_company_profile |
Edita el perfil legal de DynamoTech (parcial; cadena vacía borra el campo). Devuelve el perfil enmascarado. No toca firma ni certificado. Acepta idempotency_key. | rep_legal_nombre, rep_legal_cc, rep_legal_correo, rep_legal_celular, ciudad_firma (al menos uno) | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Cambiá la ciudad de firma de DynamoTech a Medellín." |
legal_get_signature_status |
Dice si el representante legal de DynamoTech tiene su firma cargada, y cuándo y por quién. Nunca devuelve la imagen. Solo lectura. | — | Sesión de scope read; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "¿Está cargada la firma del representante legal?" |
legal_set_sku_commercial |
Marca un SKU como listo (o no) para la venta. El motivo es obligatorio pero hoy no se guarda. Acepta idempotency_key. | sku_id · ready_to_sale · reason | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Marcá el SKU X como listo para vender." |
legal_begin_document_upload |
Paso 1 de subir el PDF de un documento del cliente (propuesta, cronograma, certificado o firmado): devuelve la URL de subida directa. Crea y anula borradores, así que sin confirm_replaces_document_id solo muestra una vista previa. | kind · contract_id, party_id o document_id según kind · confirm_replaces_document_id (opcional) | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Preparame la subida de la propuesta del contrato X." |
legal_finish_document_upload |
Paso 2: el servidor lee el PDF de la ruta derivada, mide su sha256 y lo registra. Con kind signed firma el documento (irreversible) y deja el contrato vigente; sin confirm_signature_digest solo muestra la vista previa. Acepta idempotency_key. | kind · document_id · signed_at y party_id (signed) · confirm_signature_digest (opcional) | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Confirmá la subida de la propuesta del contrato X." |
legal_begin_company_certificate_upload |
Paso 1 de cargar el certificado de existencia y representación de DynamoTech: devuelve la URL de subida directa. Sube otro y reemplaza el anterior. | size_bytes · mime_type | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Preparame la subida del certificado de DynamoTech." |
legal_finish_company_certificate_upload |
Paso 2: el servidor lee el PDF de su ruta fija, mide su sha256 y lo registra (reemplaza el anterior). Acepta idempotency_key. | profile_id del paso 1 | Sesión de scope write; solo global-admin con sesión humana (rechaza tokens de máquina; lo decide la API de legal). | "Confirmá la subida del certificado de DynamoTech." |