
box-legal-workflows-ma
★ 5by box · part of box/box-for-ai
Build and manage M&A Virtual Data Rooms with Box MCP — create secure folder structures with numbered prefixes for due diligence, assign role-based access to…
This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.
by box
Build and manage M&A Virtual Data Rooms with Box MCP — create secure folder structures with numbered prefixes for due diligence, assign role-based access to…
npx skills add https://github.com/box/box-for-ai --skill box-legal-workflows-ma
Download ZIPGitHub5
M&A Deal Room Management
PREREQUISITES:
-
Read
box:boxfor Box MCP auth, tool selection, base workflows. If missing, run:npx skills add https://github.com/box/box-for-ai --skill box -
Read
box-legal-workflowsfor Box collaboration role definitions, Box AI usage boundaries, and reusable confirmation phrasings. If missing, run:npx skills add box/box-for-ai --skill box-legal-workflows
Build and run an M&A data room in Box : create the folder hierarchy, scope role-based access with Box collaborations, validate permissions before sharing, and answer due-diligence questions with Box AI plus citations. This skill is the deal-room-specific recipe; the underlying Box tool mechanics live in the capability references below. Deal risk, materiality, and terms are attorney calls. Not legal advice.
Box capability references
Reach for these for tool mechanics rather than restating them here:
-
box:references/content-workflows.md— create the folder hierarchy, upload/copy, classify-and-file submissions -
box:references/collaboration.md— role-based access, shared links, permission audits (list_item_collaborations) -
box:references/mcp-search.md— locate documents, folder-scoped search -
box:references/ai-and-retrieval.md— due-diligence Q&A and term extraction with citations
Folder structure
Create the tree using the MCP tools in box:references/content-workflows.md (top-down, parent before child; reuse the existing folder on a 409 name conflict). Confirm the firm's template first. Example numbered structure — numeric prefixes keep ordering consistent and segregate external submissions:
[Deal Name] M&A Deal Room/
├── 01 - Financial Statements/
├── 02 - Legal Documents/
├── 03 - HR & Employment/
├── 04 - Intellectual Property/
├── 05 - Commercial Contracts/
├── 06 - Real Estate & Assets/
├── 07 - IT & Cybersecurity/
└── 08 - External Submissions/
Access model
Scope access least-privilege and folder-specific rather than root (role capabilities and external-sharing confirmation rules are in box:references/collaboration.md and box-legal-workflows). Example deal-room mapping (confirm with the user):
-
Internal: Deal Lead → Editor/Co-Owner on root; Finance → Viewer on Financial Statements; Legal → Editor on Legal Documents.
-
External: External Counsel → Uploader on their own folder; Auditors → Viewer on Financial Statements; Prospective Buyer → Viewer on a curated subset, not the full room.
Tool selection
Deal-room task Tool Notes
Create folders create_folder Batch the hierarchy, top-down
Add files upload_file / copy_file New uploads or copy existing Box files
Grant access create_collaboration Confirm first for any external party
Shared link add_folder_shared_link Confirm audience/expiration
Audit/verify access list_item_collaborations Before and after external changes
Find docs search_files_keyword Scope with ancestor_folder_id
Due-diligence Q&A ai_qa_multi_file Cross-document; surface citations
Extract terms ai_extract_structured_from_fields_enhanced Persist with set_file_metadata
Classify submissions ai_qa_single_file Then copy_file into the right folder
Workflow
-
Setup: create the folder tree → grant internal access with
create_collaboration. [CONFIRM: structure, emails/roles] -
Populate:
upload_file/copy_file; classify submissions withai_qa_single_file, thencopy_fileinto the right category folder. -
External access:
list_item_collaborations(audit) → [CONFIRM: who, folders, permission, expiration] →create_collaborationoradd_folder_shared_link→list_item_collaborations(verify). -
Due diligence:
search_files_keyword(folder-scoped) →ai_qa_multi_file→ present the answer with citations;ai_extract_structured_from_fields_enhancedfor terms →set_file_metadatato persist.
Legal guardrails
Box mechanics (external-sharing confirmation, shared-link settings, AI pacing/limits/citations) are governed by the capability references above and box-legal-workflows. Specific to deal rooms:
-
Deal risk, materiality, and term interpretation are attorney calls, never the agent's.
-
Validate permissions with
list_item_collaborationsbefore and after external changes — a folder grant exposes everything inside it, including files added later. -
Audit trail: record returned folder/file/collaboration IDs and write DD summaries back to Box.
npx skills add https://github.com/box/box-for-ai --skill box-legal-workflows-maRun this in your project — your agent picks the skill up automatically.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.