MCP App Store
by KeenEthics
Whale icon

Whale MCP Server for ChatGPT

By Whale

Overview

Whale is where a company documents how it works and trains its people. With this plugin you can search your Whale workspace, read its boards, libraries, playbooks, guides and cards, answer questions from your company's own content, and create, edit or delete content where your Whale account has permission. It is for employees and managers at companies that use Whale. The plugin only accesses the workspace you sign in to and the content your account can see. It does not send messages, process payments or connect to other services.

How to connect

  1. ChatGPT: Open the Whale listing in the ChatGPT app directory and choose Connect. ChatGPT listing Whale exposes 20 tools here.

Tools

whale_complete_image_upload

ChatGPT
Complete 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

ChatGPT
Delete 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
List 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

ChatGPT
List 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

ChatGPT
Manage 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

ChatGPT
Manage 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

ChatGPT
Manage 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

ChatGPT
Manage 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

ChatGPT
Manage 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

ChatGPT
Manage 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

ChatGPT
Manage 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

ChatGPT
Prepare 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_whoami

ChatGPT
Return 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.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/whale"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/whale)