Dealroom para desarrolladores

Tres pasos

1. 1

   Consigue una clave API

   Inicia sesión, abre Ajustes, Claves API y elige Crear clave. Cópiala: empieza por drk_ y solo se muestra una vez.

   Abrir Ajustes, Claves API
2. 2

   Compra créditos

   En la misma página, elige Comprar créditos. Cada contrato creado con la API o con MCP gasta un crédito.

3. 3

   Haz la llamada

   Envía el tipo de contrato y tus datos. La respuesta incluye el contrato y los enlaces para leerlo y descargarlo.

La llamada

Con curl. Sustituye drk_YOUR_KEY por tu clave.

curl -X POST https://dealroom.todo.law/api/v1/agent/contracts \
  -H "Authorization: Bearer drk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "contractType": "NDA",
    "governingLaw": "SPAIN",
    "language": "es",
    "party": {
      "legalName": "Tu Empresa, S.L.",
      "signatoryName": "Ana García",
      "signatoryTitle": "Administradora única",
      "email": "ana@tuempresa.example"
    },
    "counterparty": {
      "legalName": "Otra Empresa, S.A."
    },
    "inline": "md"
  }'

{
  "dealId": "cm9abc123",
  "dealRoomId": "cm9def456",
  "status": "AGREED",
  "contractType": "NDA",
  "governingLaw": "SPAIN",
  "language": "es",
  "paid": "credit",
  "dealUrl": "https://dealroom.todo.law/deals/cm9def456",
  "documents": {
    "pdf": "https://dealroom.todo.law/api/v1/agent/deals/cm9abc123/document",
    "docx": "https://dealroom.todo.law/api/v1/agent/deals/cm9abc123/document/docx",
    "txt": "https://dealroom.todo.law/api/v1/agent/deals/cm9abc123/document/txt",
    "md": "https://dealroom.todo.law/api/v1/agent/deals/cm9abc123/document/md",
    "html": "https://dealroom.todo.law/api/v1/agent/deals/cm9abc123/document/html"
  },
  "guide": "https://dealroom.todo.law/contracts/nda",
  "document": {
    "format": "md",
    "content": "# Acuerdo de confidencialidad\n\n## Partes\n..."
  }
}

Conviene saber

• Si no te quedan créditos, la respuesta es HTTP 402 y no se crea nada.
• Cuando repitas una llamada, envía la misma cabecera Idempotency-Key: la repetición devuelve la primera respuesta y no se cobra otra vez.
• Un contrato pagado se puede volver a descargar gratis en cualquier formato.
• El enlace dealUrl se abre para la persona cuyo correo es el titular de la clave API, una vez que inicia sesión.

Conecta un agente de IA con MCP

La dirección del servidor MCP. Tu clave va en la cabecera Authorization.

https://dealroom.todo.law/api/v1/agent/mcp

Configuración por cliente

claude mcp add --transport http dealroom https://dealroom.todo.law/api/v1/agent/mcp \
  --header "Authorization: Bearer drk_YOUR_KEY"

{
  "mcpServers": {
    "dealroom": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://dealroom.todo.law/api/v1/agent/mcp",
        "--header",
        "Authorization:${DEALROOM_AUTH}"
      ],
      "env": {
        "DEALROOM_AUTH": "Bearer drk_YOUR_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "dealroom": {
      "url": "https://dealroom.todo.law/api/v1/agent/mcp",
      "headers": {
        "Authorization": "Bearer drk_YOUR_KEY"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "dealroom-key",
      "description": "Dealroom API key",
      "password": true
    }
  ],
  "servers": {
    "dealroom": {
      "type": "http",
      "url": "https://dealroom.todo.law/api/v1/agent/mcp",
      "headers": {
        "Authorization": "Bearer ${input:dealroom-key}"
      }
    }
  }
}

{
  "mcpServers": {
    "dealroom": {
      "type": "http",
      "url": "https://dealroom.todo.law/api/v1/agent/mcp",
      "headers": {
        "Authorization": "Bearer drk_YOUR_KEY"
      }
    }
  }
}

Herramientas

list_contract_types

Todos los tipos de contrato y los datos que pide cada uno. Sin clave.

generate_contract

Crea un contrato en una sola llamada. Lo devuelve en Markdown, con los enlaces.

download_contract

Un contrato en Markdown, HTML, PDF, DOCX o TXT.

get_deal

Las cláusulas y el estado de un acuerdo.

buy_credits

Un enlace de pago de un pack de créditos, para que lo abra una persona.

get_credit_balance

Los créditos que quedan en la cuenta.

list_templates, get_template

Las cláusulas y opciones de cada contrato.

create_playbook, initiate_negotiation, join_negotiation

Negociar un contrato entre dos agentes.

API REST

Sirve cualquier lenguaje que pueda enviar peticiones HTTP. Todas las rutas empiezan por https://dealroom.todo.law.

Ejemplo

curl https://dealroom.todo.law/api/v1/agent/contract-types?lang=es

curl -X POST https://dealroom.todo.law/api/v1/agent/contracts \
  -H "Authorization: Bearer drk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "contractType": "NDA",
    "governingLaw": "SPAIN",
    "language": "es",
    "party": {
      "legalName": "Tu Empresa, S.L.",
      "signatoryName": "Ana García",
      "signatoryTitle": "Administradora única",
      "email": "ana@tuempresa.example"
    },
    "counterparty": {
      "legalName": "Otra Empresa, S.A."
    },
    "inline": "md"
  }'

Tipos de contrato

Todos los contratos que puede crear la llamada, agrupados como en las guías de contratos. Envía el código como contractType. Los datos con valor por defecto se pueden omitir.

Formatos

Un contrato, cinco formatos, todos a partir del mismo texto. Un contrato pagado se puede descargar en todos los formatos sin coste adicional.

Precio

Para máquinas

• Esta página en Markdown/es/developers.md
• Tipos de contrato y los datos que pide cada uno (JSON)/api/v1/agent/contract-types?lang=es
• Herramientas MCP con sus endpoints REST (JSON)/api/v1/agent/mcp
• Tarjeta del agente/.well-known/agent.json
• Resumen para modelos de IA/llms.txt