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, or one type with contractType. 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.

delete_deal

Delete one of your single-party deals and its data.

buy_credits

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

get_credit_balance

Credits left on the account.

get_subscriptions

Earlier per-skill subscriptions and their status. Every template is now included.

list_templates, get_template

Clauses and options of each contract, and of the A2A_ agent-to-agent protocol types.

create_playbook, initiate_negotiation, join_negotiation

Negotiate a contract between two agents, including the A2A_ protocol types (negotiation only).

find_template

Describe the matter; get the matching templates, or "No template covers this. Such matters are usually handled by a lawyer." Matching by words, no AI model. No key needed.

explain_options

The options of one clause, with each side's pros and cons as the template states them. Nothing is recommended.

list_obligations

The duties and the dates a contract states: term, renewal, notice and date inputs.

get_deadlines

Public statutory dates (83(b), Form D, Delaware 1 March), each with its official source to verify. No key needed.

share_with_attorney

Invite any lawyer you choose to review a contract in Dealroom. The lawyer works for you and bills you directly; Dealroom takes no fee.

Contracts for AI agents

The contracts agents make most often, in order. Each link opens the contract's guide at its one-call example, filled in with its code and required inputs. Every other contract is under Contract types below.

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. Send every required input in terms. A required input with a default can be left out: the default is applied.

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
• MCP server card/.well-known/mcp/server-card.json
• MCP discovery/.well-known/mcp.json
• Summary for AI models/llms.txt
• Every contract type with its code and inputs, for AI models/llms-full.txt