API para Agentes de IA: Integra TuContrato en tu Agente

Existen dos formas de integrar TuContrato con un agente de IA:

1. API REST (V2)

API HTTP estándar con autenticación por API key. Ideal para integraciones custom, backends y aplicaciones que necesitan control granular sobre el flujo de generación de contratos.

2. Servidor MCP (Model Context Protocol)

Protocolo nativo para agentes de IA como Claude, ChatGPT y otros. Permite que el agente descubra e invoque herramientas de TuContrato directamente, sin necesidad de código intermedio.

Ambas opciones generan contratos legalmente válidos para 16 jurisdicciones de LATAM y España, con todas las cláusulas adaptadas a la legislación local.

La API utiliza API keys para autenticación. Cada key está vinculada a una cuenta de usuario y sus contratos cuentan dentro del plan del usuario.

Obtener tu API key

1. Inicia sesión en tucontrato.com/configuracion
2. Ve a la sección "API y desarrolladores"
3. Genera una nueva API key

Usar la API key

Incluye tu API key en el header Authorization de cada request:

Authorization: Bearer tc_live_xxxxxxxxxxxxxxxxxxxx

Importante: Nunca expongas tu API key en código del lado del cliente. Úsala exclusivamente en tu backend o entorno seguro.

Crear contrato

POST /api/v2/contracts

{
  "type": "arrendamiento",
  "country": "MX",
  "parties": {
    "landlord": {
      "name": "María García López",
      "id_number": "GALM850101HDFRRL09",
      "email": "maria@ejemplo.com"
    },
    "tenant": {
      "name": "Carlos Rodríguez Pérez",
      "id_number": "ROPC900215HMCDRR05",
      "email": "carlos@ejemplo.com"
    }
  },
  "terms": {
    "property_address": "Av. Reforma 222, Col. Juárez, CDMX",
    "monthly_rent": 15000,
    "currency": "MXN",
    "duration_months": 12,
    "deposit_months": 1,
    "start_date": "2026-05-01"
  }
}

// Response: { data: { id, status, preview_url, pdf_url }, error: null }

Generar con IA (chat)

POST /api/v2/contracts/generate

{
  "prompt": "Necesito un contrato de arrendamiento para un departamento en CDMX, renta de $15,000 MXN mensuales, duración 1 año",
  "country": "MX"
}

// Response: { data: { id, status, contract, follow_up_questions }, error: null }

Listar contratos

GET /api/v2/contracts?status=draft&limit=10

// Response: { data: [{ id, type, status, created_at }], meta: { total, page } }

Obtener contrato

GET /api/v2/contracts/:id

// Response: { data: { id, type, status, content, parties, pdf_url }, error: null }

Enviar a firma

POST /api/v2/contracts/:id/sign

{
  "signers": [
    { "email": "maria@ejemplo.com", "role": "landlord" },
    { "email": "carlos@ejemplo.com", "role": "tenant" }
  ]
}

// Response: { data: { signature_request_id, status, signing_urls }, error: null }

El servidor MCP de TuContrato permite que agentes de IA invoquen herramientas de generación de contratos usando el Model Context Protocol.

Configuración

{
  "mcpServers": {
    "tucontrato": {
      "url": "https://tucontrato.com/mcp",
      "headers": {
        "Authorization": "Bearer tc_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Herramientas disponibles

• create_contract: Genera un contrato nuevo a partir de tipo, país y parámetros.
• generate_contract_from_description: Genera un contrato a partir de una descripción en lenguaje natural.
• list_contracts: Lista los contratos del usuario.
• get_contract: Obtiene los detalles de un contrato específico.
• update_contract: Modifica cláusulas de un contrato existente.
• send_for_signature: Envía un contrato para firma electrónica.
• get_contract_types: Lista los tipos de contrato disponibles por país.
• get_supported_countries: Lista los 16 países soportados con sus códigos.

Ejemplo de uso con un agente

Un usuario le dice a su agente de IA: "Necesito un NDA para compartir mi idea de negocio con un potencial inversor en Colombia". El agente:

1. Invoca get_contract_types con country: "CO" para confirmar que NDA está disponible.
2. Recopila la información necesaria del usuario (nombres, datos de identificación).
3. Invoca create_contract con los parámetros.
4. Retorna al usuario el enlace de preview y la opción de enviar a firma.

La API soporta los siguientes tipos de contrato:

Tipo (type)	Nombre	Descripción
arrendamiento	Arrendamiento	Alquiler de vivienda, comercial u oficina
trabajo	Trabajo	Contrato laboral (indefinido, plazo fijo, temporal)
servicios	Servicios Profesionales	Freelancers, consultores, proveedores
nda	Confidencialidad (NDA)	Unilateral, bilateral o multilateral
compraventa	Compraventa	Venta de bienes muebles o inmuebles
socios	Pacto de Socios	Acuerdos entre cofundadores o socios
prestamo	Préstamo	Préstamo de dinero entre particulares
poder	Poder	Otorgamiento de poder a un representante

Todas las respuestas siguen el formato estándar:

{
  "data": { ... } | null,
  "error": { "code": "string", "message": "string" } | null,
  "meta": { "request_id": "string", "timestamp": "ISO 8601" }
}

Códigos HTTP

Código	Significado
200	OK — solicitud exitosa
201	Created — recurso creado exitosamente
400	Bad Request — parámetros inválidos
401	Unauthorized — API key inválida o ausente
403	Forbidden — sin permisos (plan insuficiente)
404	Not Found — recurso no encontrado
429	Too Many Requests — rate limit excedido
500	Internal Error — error del servidor

Rate limits

• Plan Gratis: 10 requests/minuto, 100 requests/día
• Plan Pro: 60 requests/minuto, 5,000 requests/día