Skip to main content

Prodeal AI Connect: MCP Tool Guide

Written by Judy Ann Vargas

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

  1. Use create_room or scaffold_data_room to set up the room structure

  2. Use create_items to add checklists and folders

  3. Use create_team and batch_invite to add stakeholders

  4. Use set_team_item_access to control visibility

Workflow 2: Track Progress on a Deal

  1. Use get_room_counters to get status snapshots

  2. Use due_diligence_status to monitor due diligence completion

  3. Use list_activity_report for audit trails

  4. Use get_overview for overall workspace health

Workflow 3: Manage Documents

  1. Use upload_document to add files

  2. Use list_room_items to browse contents

  3. Use get_document_text to search within documents

  4. Use create_bulk_download to export for closing

Workflow 4: Collaborate on Items

  1. Use update_items to mark progress

  2. Use create_note to add comments

  3. Use list_notes to review discussion threads

  4. Use get_item_access to 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:

  1. Check that your user account has appropriate permissions in Prodeal

  2. Verify the room and item IDs you're using are correct

  3. Ensure required parameters are provided in the correct format

  4. 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.

Did this answer your question?