Deal Rooms

Deal Rooms tools include field-level argument descriptions and runnable examples for MCP clients.

Tools Covered

dealroom_list

List deal rooms with search/sort/pagination.

Backend routes: /view-all-pitches-sorted

Arguments

Example Request

List active deal rooms

{
  "jsonrpc": "2.0",
  "id": "dealroom_list-1",
  "method": "tools/call",
  "params": {
    "name": "dealroom_list",
    "arguments": {
      "page": 1,
      "page_size": 50,
      "sort_order": "DESC",
      "search": "Mural",
      "only_owner": false,
      "archived": false
    }
  }
}

Example Success

{
  "success": true,
  "data": {
    "tool": "dealroom_list",
    "note": "Payload shape depends on tenant data and backend route output."
  },
  "error": null
}

Example Failure

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_ARGUMENTS",
    "message": "Missing or invalid parameters for dealroom_list.",
    "status": 400,
    "retryable": false
  }
}

dealroom_open

Open deal room and return canonical metadata.

Backend routes: /retrieve-pitch

Arguments

Example Request

Open one deal room

{
  "jsonrpc": "2.0",
  "id": "dealroom_open-1",
  "method": "tools/call",
  "params": {
    "name": "dealroom_open",
    "arguments": {
      "pitch_id": "PCH1774126974294428638749"
    }
  }
}

Example Success

{
  "success": true,
  "data": {
    "tool": "dealroom_open",
    "note": "Payload shape depends on tenant data and backend route output."
  },
  "error": null
}

Example Failure

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_ARGUMENTS",
    "message": "Missing or invalid parameters for dealroom_open.",
    "status": 400,
    "retryable": false
  }
}

dealroom_edit

Edit a deal room using the same payload contract as /edit-pitch-with-sections-and-contents.

Backend routes: Derived/indirect handler route.

Arguments

Example Request

Update deal room metadata without changing sections

{
  "jsonrpc": "2.0",
  "id": "dealroom_edit-1",
  "method": "tools/call",
  "params": {
    "name": "dealroom_edit",
    "arguments": {
      "pitch_id": "PCH1774126974294428638749",
      "dealroom_name": "Mural - Security Review Room",
      "title": "Mural x Revspire Security Review",
      "headline": "Updated stakeholder workspace",
      "public_access": true
    }
  }
}

Update metadata and send explicit sections payload

{
  "jsonrpc": "2.0",
  "id": "dealroom_edit-2",
  "method": "tools/call",
  "params": {
    "name": "dealroom_edit",
    "arguments": {
      "pitch_id": "PCH1774126974294428638749",
      "pitch_data": {
        "description": "Updated workspace for procurement and legal review."
      },
      "sections": [
        {
          "id": "SEC1774126974294428638749",
          "name": "Procurement",
          "order": 1,
          "visibility": "Internal & External",
          "contents": [
            {
              "id": "HXP1774126974294428638749",
              "content": "KBD0215806635290000000000",
              "arrangement": 1,
              "tagline": "Pricing Pack",
              "visibility": "Internal & External"
            }
          ]
        }
      ],
      "content_groups": [],
      "custom_field_values": {
        "target_close_date": "2026-06-30"
      },
      "allow_empty_sections": false
    }
  }
}

Example Success

{
  "success": true,
  "data": {
    "tool": "dealroom_edit",
    "note": "Payload shape depends on tenant data and backend route output."
  },
  "error": null
}

Example Failure

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_ARGUMENTS",
    "message": "Missing or invalid parameters for dealroom_edit.",
    "status": 400,
    "retryable": false
  }
}

dealroom_create_from_playbook

Create deal room from playbook with optional placeholder rendering and usage increment.

Backend routes: Derived/indirect handler route.

Arguments

Example Request

Create deal room from playbook template

{
  "jsonrpc": "2.0",
  "id": "dealroom_create_from_playbook-1",
  "method": "tools/call",
  "params": {
    "name": "dealroom_create_from_playbook",
    "arguments": {
      "playbook_id": "ITV8581355464240000000000",
      "dealroom_name": "Mural - Openspace Mid Market Deal Room",
      "client_name": "Mural",
      "public_access": true,
      "content_option_selections": {
        "KBD0215806635290000000000": "KBD5567454989590000000000"
      },
      "placeholder_replacements": {
        "company_name": "Mural"
      },
      "allow_placeholder_failures": true,
      "copy_background_assets": true
    }
  }
}

Example Success

{
  "success": true,
  "data": {
    "tool": "dealroom_create_from_playbook",
    "note": "Payload shape depends on tenant data and backend route output."
  },
  "error": null
}

Example Failure

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_ARGUMENTS",
    "message": "Missing or invalid parameters for dealroom_create_from_playbook.",
    "status": 400,
    "retryable": false
  }
}