# Dealroom para desarrolladores

Crea un contrato en una sola llamada desde tu código o tu agente de IA, con la API o con MCP, y léelo en Dealroom.

Source: https://dealroom.todo.law/es/developers

## En esta página

- [Tres pasos](#steps)
- [La llamada](#one-call)
- [MCP](#mcp)
- [API REST](#rest)
- [Tipos de contrato](#contract-types)
- [Formatos](#formats)
- [Precio](#pricing)
- [Para máquinas](#machines)

<a id="steps"></a>

## Tres pasos

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](https://dealroom.todo.law/settings/api-keys)
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. **Haz la llamada.** Envía el tipo de contrato y tus datos. La respuesta incluye el contrato y los enlaces para leerlo y descargarlo.

<a id="one-call"></a>

## La llamada

Con curl. Sustituye drk_YOUR_KEY por tu clave.

### Petición

```sh
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"
  }'
```

### Campos

- `contractType`: Obligatorio. El código (NDA) o la dirección de la guía del contrato (nda). Consulta Tipos de contrato más abajo.
- `party`: Obligatorio. Tu parte: legalName (obligatorio), address, taxId, signatoryName, signatoryTitle, email.
- `counterparty`: La otra parte, con los mismos campos. Si no lo envías, su bloque queda en blanco para que lo complete ella.
- `governingLaw`: CALIFORNIA, NEW_YORK, ENGLAND_WALES o SPAIN. Solo hace falta cuando el contrato se ofrece con más de una.
- `language`: en o es, cuando el contrato se ofrece en los dos. Por defecto, en.
- `terms`: Los datos que pide el contrato, por id, como una ciudad o un importe. Los que no envíes toman su valor por defecto.
- `clauses`: Elección de cláusulas opcional: id de la cláusula y código de la opción. Las que no indiques toman la opción estándar.
- `role`: Solo DPA y BAA: el papel que asumes, como PROCESSOR o CONTROLLER.
- `inline`: md, html o txt: el propio contrato en la respuesta. Con MCP, md por defecto.
- `title`: Un nombre para el acuerdo. Si no lo envías, se forma con las partes.

### Respuesta

```json
{
  "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.

<a id="mcp"></a>

## 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 Code

Ejecuta esto en un terminal.

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

#### Claude Desktop

Claude Desktop se conecta a servidores remotos mediante el puente mcp-remote, que necesita Node.js. Añade esto a claude_desktop_config.json y reinicia Claude Desktop.

```json
{
  "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"
      }
    }
  }
}
```

#### Cursor

Añade esto a ~/.cursor/mcp.json, o a .cursor/mcp.json en un proyecto.

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

#### VS Code

Añade esto a .vscode/mcp.json. VS Code te pide la clave la primera vez y la guarda.

```json
{
  "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}"
      }
    }
  }
}
```

#### Otros clientes

La mayoría de los clientes MCP aceptan esta forma.

```json
{
  "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.

<a id="rest"></a>

## API REST

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

| Método | Ruta | Qué hace | Clave |
| --- | --- | --- | --- |
| GET | `/api/v1/agent/contract-types` | Tipos de contrato y los datos que pide cada uno | No |
| POST | `/api/v1/agent/contracts` | Crear un contrato en una sola llamada | Sí |
| GET | `/api/v1/agent/deals/{dealId}/document/md` | El contrato en Markdown (también /html, /txt, /docx; PDF sin sufijo) | Sí |
| GET | `/api/v1/agent/deals/{dealId}` | Las cláusulas y el estado de un acuerdo | Sí |
| GET | `/api/v1/agent/credits/balance` | Créditos que quedan | Sí |
| POST | `/api/v1/agent/credits/checkout` | Un enlace de pago de un pack de créditos | Sí |
| GET | `/api/v1/agent/templates/{code}` | Cláusulas y opciones de un contrato | Sí |
| POST | `/api/v1/agent/negotiate` | Iniciar una negociación entre dos agentes | Sí |
| POST | `/api/v1/agent/mcp` | El servidor MCP | Sí |

### Ejemplo

```sh
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"
  }'
```

[Leer la guía completa de la API de agentes](https://dealroom.todo.law/docs/agent-api)

<a id="contract-types"></a>

## 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.

### Comercial y tecnología

| Contrato | Código | Leyes aplicables | Idiomas | Datos obligatorios |
| --- | --- | --- | --- | --- |
| [Acuerdo de Confidencialidad](https://dealroom.todo.law/es/contracts/nda) | `NDA` | California, Inglaterra y Gales, España | Inglés, Español | `dispute-forum-city (solo con España; por defecto Madrid)` |
| [Acuerdo de Joint Venture](https://dealroom.todo.law/es/contracts/joint-venture-agreement) | `JOINT_VENTURE` | California, Inglaterra y Gales, España | Inglés, Español | `jv-name`, `jv-purpose` |
| [Contrato de Desarrollo de Software](https://dealroom.todo.law/es/contracts/software-development-agreement) | `SOFTWARE_DEVELOPMENT` | California, Inglaterra y Gales, España | Inglés, Español | `project-name`, `project-description` |
| [Contrato de Licencia de Tecnología](https://dealroom.todo.law/es/contracts/technology-license-agreement) | `TECHNOLOGY_LICENSE` | California, Inglaterra y Gales, España | Inglés, Español | `technology-description` |
| [Contrato de Suscripción SaaS](https://dealroom.todo.law/es/contracts/saas-agreement) | `SAAS` | California, Inglaterra y Gales, España | Inglés, Español | Ninguno |
| [Contrato Marco de Prestación de Servicios](https://dealroom.todo.law/es/contracts/master-services-agreement) | `MSA` | California, Inglaterra y Gales, España | Inglés, Español | Ninguno |

### Protección de datos y privacidad

| Contrato | Código | Leyes aplicables | Idiomas | Datos obligatorios |
| --- | --- | --- | --- | --- |
| [Acuerdo de encargo de tratamiento de datos](https://dealroom.todo.law/es/contracts/data-processing-agreement) | `DPA` | California, Inglaterra y Gales, España | Inglés, Español | `processing-purpose`, `data-categories`, `processor-establishment (por defecto EEA)` |
| [Acuerdo de Licencia de Datos](https://dealroom.todo.law/es/contracts/data-licensing-agreement) | `DATA_LICENSING` | California, Inglaterra y Gales, España | Inglés, Español | `data-categories`, `license-fee`, `license-term (por defecto 12)` |
| [Aviso de Privacidad](https://dealroom.todo.law/es/contracts/privacy-notice) | `PRIVACY_NOTICE` | California, Inglaterra y Gales, España | Inglés, Español | `jurisdictions`, `company-name`, `company-website`, `dpo-email`, `effective-date` |
| [HIPAA Business Associate Agreement Negotiator](https://dealroom.todo.law/es/contracts/business-associate-agreement) | `BAA_NEGOTIATOR` | California | Inglés | Ninguno |

### Equipo y servicios

| Contrato | Código | Leyes aplicables | Idiomas | Datos obligatorios |
| --- | --- | --- | --- | --- |
| [Cesión de Propiedad Intelectual](https://dealroom.todo.law/es/contracts/ip-assignment-spain) | `CESION_PI` | España | Español, Inglés | Ninguno |
| [Contrato de Asesoramiento](https://dealroom.todo.law/es/contracts/advisory-agreement) | `ADVISORY` | California, Inglaterra y Gales, España | Inglés, Español | `advisor-name` |
| [Contrato de Cesión de Propiedad Intelectual e Industrial](https://dealroom.todo.law/es/contracts/ip-assignment-agreement) | `IP_ASSIGNMENT` | California, Inglaterra y Gales, España | Inglés, Español | `subject-matter`, `assignment-fee` |
| [Contrato de Consultoría](https://dealroom.todo.law/es/contracts/consulting-agreement) | `CONSULTING` | California, Inglaterra y Gales | Inglés, Español | `service-description`, `hourly-rate`, `rate-currency (por defecto USD)` |
| [Contrato de Prestación de Servicios](https://dealroom.todo.law/es/contracts/services-agreement-spain) | `CONTRATO_SERVICIOS` | España | Español, Inglés | `objeto-entregables`, `honorarios`, `plazo-pago-dias (por defecto 30)` |
| [Contrato de Trabajo](https://dealroom.todo.law/es/contracts/employment-agreement) | `EMPLOYMENT` | California, Inglaterra y Gales | Inglés, Español | `start-date`, `base-salary`, `salary-currency (por defecto USD)` |
| [Contrato Laboral](https://dealroom.todo.law/es/contracts/employment-contract-spain) | `CONTRATO_LABORAL` | España | Español, Inglés | `convenio-colectivo`, `salario-bruto-anual`, `puesto-grupo-profesional`, `centro-trabajo` |

### Startups e inversión

| Contrato | Código | Leyes aplicables | Idiomas | Datos obligatorios |
| --- | --- | --- | --- | --- |
| [Acuerdo de Fundadores](https://dealroom.todo.law/es/contracts/founders-agreement) | `FOUNDERS` | California, Inglaterra y Gales, España | Inglés, Español | Ninguno |
| [Acuerdo SAFE](https://dealroom.todo.law/es/contracts/safe-agreement) | `SAFE` | California, Inglaterra y Gales, España | Inglés, Español | `valuation-cap-amount` |
| [Certificate of Incorporation (Delaware C-Corp)](https://dealroom.todo.law/es/contracts/delaware-certificate-of-incorporation) | `DELAWARE_CERT_OF_INCORPORATION` | California | Inglés | `company-name`, `registered-agent`, `par-value`, `incorporator` |
| [Pacto de Accionistas](https://dealroom.todo.law/es/contracts/shareholders-agreement) | `SHAREHOLDERS` | California, Inglaterra y Gales | Inglés, Español | `company-name`, `company-jurisdiction`, `board-size` |
| [Pacto de Inversión](https://dealroom.todo.law/es/contracts/seed-investment-agreement) | `SEED_INVESTMENT` | California, Inglaterra y Gales, España | Inglés, Español | `pre-money-valuation`, `investment-amount`, `share-count`, `share-price`, `board-size` |
| [Pacto de Socios](https://dealroom.todo.law/es/contracts/shareholders-agreement-spain) | `PACTO_SOCIOS` | España | Español, Inglés | Ninguno |
| [Plan de Incentivos en Capital](https://dealroom.todo.law/es/contracts/equity-incentive-plan) | `EQUITY_INCENTIVE` | California, Inglaterra y Gales, España | Inglés, Español | `plan-name` |
| [Préstamo Convertible](https://dealroom.todo.law/es/contracts/convertible-note) | `CONVERTIBLE_NOTE` | California, Inglaterra y Gales, España | Inglés, Español | `principal-amount`, `valuation-cap-amount`, `qualified-financing-threshold` |
| [Term Sheet (Carta de Intenciones)](https://dealroom.todo.law/es/contracts/term-sheet) | `TERM_SHEET` | California, Inglaterra y Gales, España | Inglés, Español | `round-amount`, `pre-money-valuation` |

### Marketing y distribución

| Contrato | Código | Leyes aplicables | Idiomas | Datos obligatorios |
| --- | --- | --- | --- | --- |
| [Acuerdo de Marca Blanca / Distribución](https://dealroom.todo.law/es/contracts/reseller-agreement) | `WHITE_LABEL_RESELLER` | California, Inglaterra y Gales, España | Inglés, Español | Ninguno |
| [Acuerdo de Marketing con Influencers](https://dealroom.todo.law/es/contracts/influencer-marketing-agreement) | `INFLUENCER_MARKETING` | California, Inglaterra y Gales, España | Inglés, Español | `campaign-name`, `total-compensation`, `num-deliverables` |
| [Acuerdo de Programa de Afiliados / Referidos](https://dealroom.todo.law/es/contracts/affiliate-agreement) | `AFFILIATE_PROGRAM` | California, Inglaterra y Gales, España | Inglés, Español | `program-name`, `base-commission` |
| [Orden de Inserción Publicitaria](https://dealroom.todo.law/es/contracts/advertising-insertion-order) | `ADVERTISING_IO` | California, Inglaterra y Gales, España | Inglés, Español | `campaign-name`, `total-budget`, `start-date`, `end-date` |

### Derecho societario español

| Contrato | Código | Leyes aplicables | Idiomas | Datos obligatorios |
| --- | --- | --- | --- | --- |
| [Acta de Consejo de Administración](https://dealroom.todo.law/es/contracts/board-minutes-spain) | `ACTA_CONSEJO_ADMINISTRACION` | España | Español | `company-name`, `cif`, `registered-address`, `meeting-date`, `president-name`, `secretary-name` |
| [Acta de Junta General](https://dealroom.todo.law/es/contracts/general-meeting-minutes-spain) | `ACTA_JUNTA_GENERAL` | España | Español | `company-name`, `cif`, `registered-address`, `meeting-date`, `meeting-type`, `quorum-percentage`, `secretary-name`, `president-name` |
| [Asignación Individual de Phantom Shares](https://dealroom.todo.law/es/contracts/phantom-shares-grant) | `PHANTOM_SHARES_GRANT` | España | Español | `employee-name`, `phantom-count`, `grant-date`, `plan-date`, `individual-vesting-months` |
| [Marco de Phantom Shares](https://dealroom.todo.law/es/contracts/phantom-shares-plan) | `PHANTOM_SHARES_PLAN` | España | Español | `company-name`, `cif`, `total-pool-percentage`, `cliff-months`, `vesting-months`, `plan-effective-date`, `payment-term-days` |

### Inmobiliario

| Contrato | Código | Leyes aplicables | Idiomas | Datos obligatorios |
| --- | --- | --- | --- | --- |
| [Assured Periodic Tenancy Agreement](https://dealroom.todo.law/es/contracts/assured-periodic-tenancy) | `RESIDENTIAL_TENANCY_GB` | Inglaterra y Gales | Inglés | `property-address`, `monthly-rent`, `annual-rent (solo con Inglaterra y Gales)` |
| [California Residential Lease Agreement](https://dealroom.todo.law/es/contracts/california-residential-lease) | `RESIDENTIAL_TENANCY_US_CA` | California | Inglés | `property-address`, `monthly-rent` |
| [Contrato de Arrendamiento de Vivienda](https://dealroom.todo.law/es/contracts/residential-lease-spain) | `RESIDENTIAL_TENANCY_ES` | España | Español | `property-address`, `monthly-rent` |

### Otros

| Contrato | Código | Leyes aplicables | Idiomas | Datos obligatorios |
| --- | --- | --- | --- | --- |
| Template Agreement | `TEMPLATE` | California, Inglaterra y Gales, España | Inglés | Ninguno |

<a id="formats"></a>

## Formatos

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

| Formato | Tipo de medio | Para qué | Cómo obtenerlo |
| --- | --- | --- | --- |
| Markdown | `text/markdown` | Agentes de IA y herramientas que leen texto | `inline: "md", o /document/md` |
| HTML | `text/html` | Páginas web, vistas previas y lectores de pantalla; un solo archivo, sin recursos externos | `inline: "html", o /document/html` |
| Texto | `text/plain` | Sistemas de texto plano | `inline: "txt", o /document/txt` |
| PDF | `application/pdf` | Leer e imprimir | `/document` |
| DOCX | `Documento de Word` | Editar en un procesador de textos | `/document/docx` |

<a id="pricing"></a>

## Precio

Redactar y negociar es gratis. Cada contrato cuesta 29 US$, lo mismo en la web, con la API o con MCP.

Los agentes pagan con créditos de prepago, un crédito por contrato. Los créditos se venden en packs de 10: 217,50 US$ el pack.

[Ver la página de precios](https://dealroom.todo.law/pricing)

<a id="machines"></a>

## Para máquinas

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

---

Los contratos salen de modelos redactados por abogados. Lee cada contrato antes de firmarlo. Esta página es información general, no asesoramiento jurídico.