General Legal

Confirm that a file has been uploaded and trigger processing. Call this after the file has been transferred through upload_document's link. Confirmation releases the version and can notify the legal team. Repeating the call skips the completed state transition but may repeat a notification whose delivery was not recorded. Args: contract_id: The document ID returned by upload_document. version_id: The version ID returned by upload_document. notify_legal: Whether to notify the legal team and trigger AI review. context_for_legal: Context or instructions for the legal team. It's important to provide as much detail as you can so the human lawyer can review the contract accurately and get the results you want.

confirm_upload

Return a download link for a released contract version. Returns a short-lived link (valid ~15 min): a person opens it in a browser, or a shell agent runs the returned `curl -o` command. Clients that can read MCP resources may instead use the attached resource link. Use list_deals for IDs. Args: version_id: The version ID to download.

download_contract

List contract files for the authenticated client. Use this when the user asks to list their contracts, or when you need a contract ID to upload a new version to an existing contract. Contract lifecycle status lives on deals; use list_deals to check review status and conversation threads. Args: exclude_contract_id: Optional contract ID to exclude from the list.

list_contracts

List deals/matters for the authenticated client. Use this to check legal review status, find deal IDs for thread messages, see which contracts belong to each deal, and find version IDs for download. Args: status: Optional deal status filter: "in_progress", "awaiting_client", "ready_for_review", "closed", or "new". Leave empty for all. page: Page number, starting from 1. page_size: Number of deals per page, max 100.

list_deals

Read messages in the lawyer-client conversation thread for a deal.

list_thread_messages

Post a message to the lawyer-client conversation thread for a deal. Use this to answer the attorney's clarifying questions during contract review. Keep replies concise — Slack truncates message bodies at 3000 characters. The thread must already exist (the deal must be in lawyer review). Call list_thread_messages first if you're unsure whether a thread is open. Args: deal_id: The deal/matter ID whose thread to post in. text: The message body. Plain text. Will be sanitized server-side.

reply_to_thread

Open a new legal matter (deal) from a question or request — no document required. Use this to start a matter when you have a question, want advice, or want to describe a contract or issue for the legal team before (or without) uploading a file. To attach a document later, call upload_document with the returned deal_id. Args: initial_request: The question or description of what you need help with. Be as specific as possible so the lawyer can give you an accurate answer. deal_name: Optional short title for the matter. If omitted, one is assigned.

start_deal

Submit a DOCX, PDF, PNG, JPEG, or Markdown file for legal review. Returns a short-lived upload link (valid ~1 hour, 20 MiB max). File bytes never pass through this tool: a person opens the link in a browser to pick the file, or a shell-capable agent runs the returned `curl -T` command. Do not attempt to read, encode, or transcribe the file's contents yourself. If you cannot run the curl command or it fails, don't explain the limitation — share the link with the user (open it, choose the file, say when done). Where the document lands: - Pass deal_id to attach this document to an existing matter (e.g. one started with start_deal). Use list_deals to find deal IDs. - Pass contract_id to upload a new version of an existing document. Use list_contracts to find IDs. - Pass neither to start a fresh matter for this document. deal_id and contract_id are mutually exclusive. After the file is uploaded through the link, call confirm_upload to trigger review. Args: file_name: The filename (must end in .docx, .pdf, .png, .jpg, .jpeg, or .md). idempotency_key: Caller-generated unique token, reused only for retries of this exact upload and destination. last_edit_by: Who last edited the document — "client" or "counterparty". contract_id: Optional. Pass an existing document ID to upload a new version of it. deal_id: Optional. Pass an existing deal ID to attach this document to that matter.

upload_document