Dealroom for developers

Three steps

1. 1

   Get an API key

   Sign in, open Settings, API keys and choose Create key. Copy the key: it starts with drk_ and is shown once.

   Open Settings, API keys
2. 2

   Buy credits

   On the same page, choose Buy credits. Each contract made through the API or MCP spends one credit.

3. 3

   Make the call

   Send the contract type and your details. The answer holds the contract and the links to read and download it.

The one call

With curl. Replace drk_YOUR_KEY with your key.

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": "CALIFORNIA",
    "language": "en",
    "party": {
      "legalName": "Your Company, Inc.",
      "signatoryName": "Alex Smith",
      "signatoryTitle": "CEO",
      "email": "alex@yourcompany.example"
    },
    "counterparty": {
      "legalName": "Other Company, LLC"
    },
    "inline": "md"
  }'

{
  "dealId": "cm9abc123",
  "dealRoomId": "cm9def456",
  "status": "AGREED",
  "contractType": "NDA",
  "governingLaw": "CALIFORNIA",
  "language": "en",
  "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": "# Mutual Non-Disclosure Agreement\n\n## Parties\n..."
  }
}

Good to know

• With no credit left, the answer is HTTP 402 and nothing is created.
• When you retry, send the same Idempotency-Key header: the retry returns the first answer and is not charged again.
• Every format of a paid contract can be downloaded again for free.
• The dealUrl link opens for the person whose e-mail owns the API key, once signed in.

Connect an AI agent through MCP

The MCP server address. Your key goes in the Authorization header.

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

Setup by client

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"
      }
    }
  }
}

Tools

list_contract_types

Every contract type and the facts it needs. No key needed.

generate_contract

Make a contract in one call. Returns it as Markdown, with the links.

download_contract

One contract as Markdown, HTML, PDF, DOCX or TXT.

get_deal

A deal's clauses and status.

buy_credits

A payment link for a pack of credits, for a person to open.

get_credit_balance

Credits left on the account.

list_templates, get_template

Clauses and options of each contract.

create_playbook, initiate_negotiation, join_negotiation

Negotiate a contract between two agents.

REST API

Any language that can send HTTP requests works. All paths start with https://dealroom.todo.law.

Example

curl https://dealroom.todo.law/api/v1/agent/contract-types

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": "CALIFORNIA",
    "language": "en",
    "party": {
      "legalName": "Your Company, Inc.",
      "signatoryName": "Alex Smith",
      "signatoryTitle": "CEO",
      "email": "alex@yourcompany.example"
    },
    "counterparty": {
      "legalName": "Other Company, LLC"
    },
    "inline": "md"
  }'

Contract types

Every contract the one call can make, grouped as in the contract guides. Send the code as contractType. Inputs marked with a default can be left out.

Formats

One contract, five formats, all from the same text. A paid contract can be downloaded in every format at no extra cost.

Price

For machines

• This page as Markdown/developers.md
• Contract types and the facts each one needs (JSON)/api/v1/agent/contract-types
• MCP tools with their REST endpoints (JSON)/api/v1/agent/mcp
• Agent card/.well-known/agent.json
• Summary for AI models/llms.txt