whale_complete_image_upload
ChatGPTComplete a direct image upload to Whale. Always use after transferring an image prepared by whale_prepare_image_upload. image_id: Image ID returned by whale_prepare_image_upload. Returns the permanent image URL after server-side validation. Example: direct image transfer finished → whale_complete_image_upload.
whale_delete_object
ChatGPTDelete a board, library, playbook, card, guide, or quiz. Use when the user explicitly asks to delete one of these object types and the target object has been confirmed (name, ID, or prior look-up). Do not use for restoring deleted objects (use the relevant whale_manage_* tool with operation='restore' instead), or for reading or updating objects. Example: 'Delete this card' → whale_delete_object with object_type='card'.
whale_get_card
ChatGPTGet card detail for a playbook. Use when the user asks for a specific card by id or URL, or needs the full card body after finding a card in search or playbook items. Do not use for keyword discovery (whale_search), listing playbook items (whale_get_playbook), or creating or editing cards (whale_manage_card). card_id: UUID from search results or listings. Example: 'Show me card abc-123' → whale_get_card.
whale_get_guide
ChatGPTGet guide detail with ordered steps for a playbook guide. Use when the user asks for a specific guide by id or URL, or when you already have a guide UUID from whale_search or whale_get_playbook items. Do not use when searching or listing guides; use whale_search with content_types=['stepbystep'] or browse via whale_get_playbook instead. stepbystep_id: UUID from search results or listings. Example: 'Show me guide abc-123' → whale_get_guide with stepbystep_id.
whale_get_library
ChatGPTGet library detail or list libraries on a board. Use when browsing a known board's libraries without keyword search, or when the user asks for a specific library by id. Do not use for keyword discovery (whale_search), playbook or card detail (whale_get_playbook, whale_get_card), or listing libraries without a board (board_id is required for list mode). Pass library_id for one library with nested playbooks, or board_id to list libraries on that board. page_token and limit apply only in list mode. Example: 'Show libraries on this board' → whale_get_library with board_id.
whale_get_playbook
ChatGPTGet playbook detail with cards and guides. Use when the user asks for a specific playbook by id or URL, or needs ordered cards and guides inside a known playbook. Do not use when browsing boards or libraries (whale_list_boards, whale_get_library), searching by keyword (whale_search), or mutating content (whale_manage_card). playbook_id: UUID from library nested playbooks, search results, or the user. Example: 'Show me playbook abc-123' → whale_get_playbook with playbook_id='abc-123'.
whale_get_quizzes
ChatGPTGet quiz detail or list quizzes in the workspace. Use when the user asks for a specific quiz by id or wants to browse quizzes. Detail mode returns the quiz questions and answers, including the question ids needed to edit them. Do not use for creating or editing quizzes (use whale_manage_quiz) or for broad content discovery; use whale_search for content search. Pass quiz_id for detail mode. In list mode, subject_tag_ids filters results while page_token and limit control pagination. Example: 'How many people are enrolled in quiz abc-123' → whale_get_quizzes with quiz_id.
whale_get_subject_tags
ChatGPTGet subject tag detail or list subject tags in the workspace. Use when you need to apply a subject tag to a content item or browse the subject tag catalog. Do not use for making or changing subject tags; this tool only retrieves tags. Example: 'Apply the subject tag "Security" to the card' → Find the "Security" tag with whale_get_subject_tags and apply it to the card.
whale_list_boards
ChatGPTList boards in the workspace for browsing content hierarchy. Use when the user wants to see available boards, pick a board to explore, or navigate board → library → playbook without keyword search. Do not use for a single board by id (not supported), keyword discovery (whale_search), or listing libraries (whale_get_library after picking a board). write_only and has_writable_libraries filter the list for edit workflows. page_token and limit control pagination; pass next from a prior response unchanged. Example: 'What boards can I see?' → whale_list_boards.
whale_list_skills
ChatGPTList the workspace's skills: procedures its admins marked for agents to carry out. Use when the user wants a task done, not for a question answered from Whale content. If a skill's description fits, read its card with whale_get_card or its guide with whale_get_guide (object_id) and carry out the steps with your tools instead of describing them to the user. Only skills whose card or guide the user can read are listed. Example: 'Refund order 1042' → whale_list_skills, read the skill that covers refunds, and do its steps.
whale_manage_board
ChatGPTManage board create, update, move, and restore operations. Use after finding and verifying the relevant board state. Do not use for reading boards, deleting boards, or admin-only permission management. Example: 'Rename this board' → whale_manage_board with operation='update'.
whale_manage_card
ChatGPTManage card create, update, restore, move, and duplicate operations. Use after finding and verifying the relevant card or playbook state. Do not use for reading content, deleting cards, or for any operation other than the create, update, restore, move, and duplicate actions defined here. Example: 'Create a card in this playbook' → whale_manage_card with operation='create'.
whale_manage_guide
ChatGPTManage guide create, update, restore, move, and duplicate operations. Guides are called StepBySteps internally, but this tool uses guide terminology for users. Use after finding and verifying the relevant guide, playbook, or playbook item state. Do not use for reading guide content, deleting guides, running guides, comments, assignments, analytics, or approval-flow draft/proposal/version operations. When updating steps, preserve existing step metadata unless intentionally changing it. The steps field is a complete ordered sync list. Example: 'Add a step to this guide' → whale_manage_guide with operation='update' and the complete steps list.
whale_manage_library
ChatGPTManage library create, update, restore, and move operations. Use after finding and verifying the relevant board or library state. Do not use for reading library content, deleting libraries, searching workspace content, or managing permissions. Example: 'Rename this library' → whale_manage_library with operation='update'.
whale_manage_playbook
ChatGPTManage playbook create, update, move, and restore operations. Use after finding and verifying the relevant library or playbook state. Do not use for reading playbook contents, deleting playbooks, managing cards or guides, or changing custom playbook permissions. Example: 'Create a playbook in this library' → whale_manage_playbook with operation='create'.
whale_manage_quiz
ChatGPTManage quiz create, update, and restore operations. Use after finding and verifying the relevant quiz state. One call handles quiz settings and questions together. Do not use for reading quizzes (use whale_get_quizzes), deleting quizzes (use whale_delete_object), or assigning quizzes. When updating questions, send the complete ordered list: include a question id to edit it in place, omit the id to add a question, and leave out questions to delete them. Question ids come from whale_get_quizzes. Example: 'Create a draft quiz with two questions' → whale_manage_quiz with operation='create'.
whale_manage_subject_tag
ChatGPTManage subject tag mutations. Use for creating a subject tag or changing an existing tag. Do not use for reading tags (use whale_get_subject_tags), or assigning tags to cards, playbooks, and guides (use the corresponding whale_manage_* tool). For create, provide a name and optional color. For update, provide the tag UUID and at least one changed field. Authentication and workspace selection come from the active session. Example: 'Create a Security tag' → whale_manage_subject_tag with operation='create'.
whale_prepare_image_upload
ChatGPTPrepare a direct image upload to Whale when needing to use an image in Whale. filename: Image filename including extension. content_type: PNG, JPEG, GIF, or WebP MIME type. file_size: Image size in bytes, up to 10 MiB. Upload the image bytes to the returned URL with the returned headers, then call whale_complete_image_upload with image_id. Example: 'Add this word document' → per image in the document → whale_prepare_image_upload → direct transfer → whale_complete_image_upload → use the image in Whale.
whale_search
ChatGPTSearch company knowledge across boards, libraries, playbooks, cards, and more. Use first when the user asks a question, needs to find content by topic or keyword, or needs citation-friendly company knowledge results. Do not use for the current user's profile or permissions (whale_whoami), or for uploaded file search (not exposed as an MCP tool). Parameters use Whale content type values directly. Use content_types=['stepbystep'] when searching guides; there is no separate guide content_type value. stepbystep is a guide. Returned results include the url to the source content when the content type can be opened directly in Whale. Example: 'Find onboarding playbooks' → whale_search with query='onboarding' and content_types=['playbook'].
whale_whoami
ChatGPTReturn the authenticated user's profile and workspace permissions. Use at session start or when the user asks about their identity, email, role, or edit access to boards, libraries, or playbooks. Do not use to look up other users or to discover content; use whale_search or the relevant detail tools instead. Example: 'What is my email?' or 'Can I edit playbooks?' → whale_whoami.