Overview
The Prodeal AI Connect MCP server provides 36 tools that enable seamless integration between your preferred AI models and your Prodeal data rooms. These tools allow you to automate workflows, manage room contents, collaborate on checklists, and generate reports directly from AI conversations.
Getting Started
To use Prodeal AI Connect, you must have:
A Prodeal account with the AI Connect MCP server enabled
An MCP-compatible AI model or application connected to your Prodeal workspace
Access to one or more data rooms
Appropriate permissions for the actions you want to perform
Tools are organized into eight functional categories. Browse the sections below to find the right tool for your workflow.
Room Management
These tools help you create, organize, and access data rooms.
create_room
Create a new, empty room for the authenticated user.
Use this to programmatically set up new deal rooms, project spaces, or collaboration areas.
clone_room
Create a room from a template (or any existing room) by cloning it.
Speed up room setup by cloning an existing structure. Useful for standardizing processes across multiple deals.
scaffold_data_room
Create a new, empty room and optional folder tree in one workflow.
Combine room creation and folder structure setup in a single operation for faster initialization.
list_rooms
List rooms visible to the authenticated user.
Retrieve all rooms you have access to. Useful for automation workflows that need to iterate across multiple rooms.
list_room_templates
List available room templates.
Discover pre-built templates available in your organization for creating standardized room structures.
list_templates_for_scaffold
List room templates to use when scaffolding a data room.
Find templates specifically available for the scaffold_data_room workflow.
Items & Folders
Manage the contents of your rooms with these item and folder tools.
create_items
Create folders, headings, line items, or documents.
Add new organizational elements to your room. Supports multiple item types in a single operation.
create_room_folders
Create folders in a room (supports nested children).
Build hierarchical folder structures with parent-child relationships.
copy_items
Copy items to another folder in the same room.
Duplicate items while maintaining their properties and structure. Supports copying multiple items at once.
move_items
Move items to another folder in the same room.
Reorganize your room structure by moving items between folders without duplicating them.
delete_items
Delete multiple items from a room.
Remove items you no longer need. Supports batch deletion of multiple items.
list_room_items
List folders and documents in a room with optional filters.
Browse the contents of a room with flexible filtering options to find specific items.
update_items
Update item status, name, due_date, or position.
Modify existing items' properties such as marking checklist items as complete, renaming items, or adjusting due dates.
Documents
Handle document uploads, downloads, and searching.
download_document
Download a single document (metadata, base64, or url mode).
Retrieve documents in multiple formats. Choose between metadata only, base64 encoded content, or direct download URL.
upload_document
Upload a document to a room via a presigned URL.
Add new documents to your room. Uses presigned URLs for secure, direct uploads.
get_document_text
Search indexed document attachment text within a room.
Search within document content across your room. Useful for finding specific information within uploaded files.
Notes
Collaborate and annotate with comment threads on items.
create_note
Create a note on an item.
Add comments, annotations, or discussion threads to any item in your room.
list_notes
List notes on an item.
Retrieve all comments and notes associated with a specific item.
update_note
Update a note on an item.
Edit existing notes to correct information or add additional details.
delete_note
Delete a note on an item.
Remove notes you no longer need.
Teams & Access
Manage team membership and access controls.
create_team
Create a team in a room.
Establish new teams for organizing stakeholders and managing permissions.
list_teams
List teams, optionally filtered by room.
View all teams in your organization or within a specific room.
batch_invite
Invite emails to a team.
Quickly add multiple stakeholders to a team with a single operation.
set_team_item_access
Grant or revoke a team's access to specific items in a confidential room.
Fine-tune access permissions by granting or removing team access to individual items.
get_item_access
Get team access information for an item.
Check which teams and users have access to a specific item.
Reporting & Analytics
Generate insights about your room status and activity.
get_room_counters
Get item counters for a room.
Retrieve statistics on items by status (open, closed, in progress, etc.). Useful for dashboards and progress tracking.
get_inventory_report
Generate a room inventory report.
Create comprehensive reports of all items in a room with their properties and status.
due_diligence_status
Aggregate due diligence counters and sample items for a room.
Get an overview of due diligence completion with status counts and sample items.
list_activity_report
List activity log entries for audit and closing.
Review all changes made to your room for audit trails and closing documentation.
get_overview
Get workspace overview entries.
Retrieve a high-level summary of items across your workspace with pagination support.
Bulk Downloads
Manage batch file exports from your rooms.
create_bulk_download
Start an async bulk ZIP download job.
Initiate a background job to package multiple items into a ZIP file for download.
bulk_download
Create and poll a bulk download until ready or failed.
Combine creation and status checking in one workflow for streamlined bulk exports.
get_bulk_download_status
Poll bulk download job status.
Check the status of an in-progress bulk download and retrieve the download URL when ready.
User & System
Access user information and system capabilities.
get_me
Return the authenticated user and optional organization context.
Retrieve information about the current user and their organization, including roles, permissions, and contact details.
search
Search documents, notes, rooms, and items.
Perform full-text search across your Prodeal workspace to find documents, notes, and items.
list_mcp_capability_categories
List documented MCP server capability categories for consent design.
View the available capability categories for permission and consent workflows.
Common Workflows
Workflow 1: Create and Populate a New Room
Use
create_roomorscaffold_data_roomto set up the room structureUse
create_itemsto add checklists and foldersUse
create_teamandbatch_inviteto add stakeholdersUse
set_team_item_accessto control visibility
Workflow 2: Track Progress on a Deal
Use
get_room_countersto get status snapshotsUse
due_diligence_statusto monitor due diligence completionUse
list_activity_reportfor audit trailsUse
get_overviewfor overall workspace health
Workflow 3: Manage Documents
Use
upload_documentto add filesUse
list_room_itemsto browse contentsUse
get_document_textto search within documentsUse
create_bulk_downloadto export for closing
Workflow 4: Collaborate on Items
Use
update_itemsto mark progressUse
create_noteto add commentsUse
list_notesto review discussion threadsUse
get_item_accessto manage who sees updates
Best Practices
Batch Operations: Use batch operations (copy_items, delete_items, batch_invite) instead of individual calls when working with multiple items
Pagination: When listing items, use pagination parameters to handle large result sets efficiently
Error Handling: Implement retry logic for async operations like bulk downloads
Access Control: Always verify user and team permissions before executing sensitive operations
Activity Logs: Use list_activity_report regularly for audit compliance and deal closing documentation
Need Help?
If you encounter issues with any tool:
Check that your user account has appropriate permissions in Prodeal
Verify the room and item IDs you're using are correct
Ensure required parameters are provided in the correct format
Contact your Prodeal administrator for permission-related issues
For technical support, reach out to the Prodeal support team with details about which tool you're using and the specific error message received.
