add-generation-to-space
ChatGPTUse this when the user wants to save, publish, or add an existing generated output/result into a documentation Space. State-changing: creates a generation-backed Space item after authorization. Requires generation_id, destination space_id, and optional parent_id/title.
apply-space-suggestion
ChatGPTUse this when the user wants to apply or accept one pending Autopilot/repository-sync documentation suggestion. Destructive state-changing action: writes the suggested content to the target Space document and marks the suggestion applied after authorization. Requires suggestion_id from list-space-suggestions.
archive-generation
ChatGPTUse this when the user wants to archive, hide, or remove an existing generation from the active generation list without deleting it. State-changing: archives the visible generation after authorization. Requires generation_id from list-generations.
bulk-manage-space-suggestions
ChatGPTUse this when the user wants to apply or discard multiple Autopilot/repository-sync suggestions at once. Destructive state-changing action: bulk apply can update multiple Space documents, and bulk discard removes suggestions from active review after authorization. Requires suggestion IDs from list-space-suggestions; bulk apply requires Enterprise access.
cancel-team-invitation
ChatGPTUse this when the user wants to cancel a pending team invitation before it is accepted. After authorization, this destructive action removes the specified invitation_id so that invitation can no longer be accepted.
copy-space-item
ChatGPTUse this when the user wants to copy, duplicate, or clone a Space page/document, folder, or external link and its children into another Space. State-changing: creates copied items in the target Space after authorization. Requires source_space_id, item_id, target_space_id, and optional target_parent_id.
count-space-suggestions
ChatGPTUse this when the user asks how many Autopilot/repository-sync suggestions are pending, snoozed, done, high-confidence, or waiting for review. Read-only: returns grouped counts without changing suggestions or documents. Optionally filter by numeric space_id.
create-generation-share-link
ChatGPTUse this when the user wants to share an existing generated output, generation, or result through a public URL. State-changing public-link action: creates and returns a signed public share link after authorization. Requires owned generation_id from list-generations and optional expiration.
create-space
ChatGPTUse this when the user wants to create a new documentation Space or knowledge base container. State-changing: creates the Space directly after the MCP client authorizes the call. Requires a Space name and may include description, public visibility, and slug.
create-space-document
ChatGPTUse this when the user wants to create a markdown document/page in a Space from provided content. State-changing: creates the document directly after authorization. Requires numeric space_id, title, and markdown content. Use create-space-item for folders or external links.
create-space-item
ChatGPTUse this when the user wants to create a Space page/document, folder, or external link inside an existing Space. State-changing: creates the item directly after authorization. Requires numeric space_id, item type, title, and content or URL when relevant.
create-space-item-share-link
ChatGPTUse this when the user wants to share a Space page/document, folder, or external link with a public URL. State-changing public-link action: creates and returns a signed public share link after authorization. Requires owned Space access, space_id, item_id, and optional expiration.
create-space-repository-link
ChatGPTUse this when the user wants to link an authorized provider repository to a Space for Autopilot sync. After authorization, this state-changing external action creates the link with triggers, path filters, notifications, or auto-apply settings and requires Enterprise access.
create-webhook-subscription
ChatGPTUse this when the user wants to add a webhook, callback URL, n8n/Zapier endpoint, or integration subscription for supported DocuWriter events. State-changing external action: creates the subscription after authorization. Use list-webhook-events first for valid event keys; webhook test dispatch is not exposed.
delete-space
ChatGPTUse this when the user explicitly wants to delete a whole documentation Space. Destructive state-changing action: removes the manageable Space directly after the MCP client authorizes the call. Requires numeric space_id from list-spaces and should not be used for deleting individual pages.
delete-space-document
ChatGPTUse this when the user explicitly wants to delete one existing Space document/page. Destructive state-changing action: deletes the document directly after authorization. Requires the document ID from list-space-documents or search results; use delete-space-items for folders or bulk item deletion.
delete-space-items
ChatGPTUse this when the user wants to delete one or more Space pages, documents, folders, or external links from a Space. Destructive state-changing action: deletes the selected items directly after the MCP client authorizes the call. Requires numeric space_id and item_ids from list-space-documents.
delete-space-repository-link
ChatGPTUse this when the user wants to remove an Autopilot repository link from a Space. Destructive external-provider action: deletes the link after authorization and may remove provider webhook configuration. Requires Enterprise access, manageable Space permission, space_id, and link_id.
delete-webhook-subscription
ChatGPTUse this when the user wants to remove a webhook subscription or stop sending events to an endpoint. Destructive external action: deletes the owned subscription after authorization. Requires subscription_id from list-webhook-subscriptions; webhook test dispatch is not exposed.
disable-space-repository-link
ChatGPTUse this when the user wants to pause, turn off, or disable an Autopilot repository link for a Space. State-changing external-provider action: disables the link and attempts to remove the provider webhook after authorization. Requires Enterprise access, manageable Space permission, space_id, and link_id.
discard-space-suggestion
ChatGPTUse this when the user wants to reject, dismiss, remove from review, or discard one Autopilot/repository-sync documentation suggestion. Destructive state-changing action: marks the pending suggestion discarded directly after authorization. Requires suggestion_id from list-space-suggestions.
enable-space-repository-link
ChatGPTUse this when the user wants to turn on or resume an existing Autopilot repository sync link for a Space. State-changing external-provider action: enables the link and registers the provider webhook after authorization. Requires Enterprise access, manageable Space permission, provider access, space_id, and link_id.
export-space-items-markdown
ChatGPTUse this when the user wants a Markdown export of selected Space pages, folders, or docs that can be returned in the MCP response. Read-only: returns merged Markdown without changing Space content. Use browser guidance for PDF, ZIP, or download-only export flows.
generate-and-add-documentation
ChatGPTUse this when the user supplies source files and wants the generated documentation saved directly in an existing Space. After authorization, this state-changing action consumes AI credits, creates a generation, and writes a document to the specified space_id.
generate-code-documentation
ChatGPTUse this when the user supplies source code and asks to generate markdown documentation, explain code, or document one or more files. State-changing generation action: consumes AI credits, creates a generation, and returns documentation after authorization. Use browser guidance for local upload or repository/full-tree flows.
generate-code-optimization
ChatGPTUse this when the user supplies source code and asks for an optimized or refactored version. After authorization, this state-changing action consumes AI credits, creates a generation, and returns the revised code.
generate-code-tests
ChatGPTUse this when the user supplies source code and asks to generate unit, feature, integration, or framework-specific tests. State-changing generation action: consumes AI credits, creates a generation, and returns test code after authorization. Use browser guidance for local uploads or repository-wide test generation.
generate-codebase-documentation
ChatGPTUse this when the user wants a new documentation Space built from selected files in an imported repository. After authorization, this state-changing action consumes AI credits, creates a private Space, links the repository, and queues per-file jobs using repository_id and selected_files.
generate-full-tree-documentation
ChatGPTUse this when the user has reviewed a full-tree preview and asks to create its documentation Space. After authorization, this state-changing action consumes AI credits, creates a private linked Space, and queues documentation from the stored preview using repository_id and accepted_tree_hash.
generate-language-conversion
ChatGPTUse this when the user supplies one source-code file and asks to convert it to another programming language or framework. After authorization, this state-changing action consumes AI credits, creates a generation, and returns converted code using source_code, filename, from_language, and to_language.
generate-repository-documentation
ChatGPTUse this when the user wants one markdown document generated from selected files in an imported repository. After authorization, this state-changing action consumes AI credits and creates a generation using numeric repository_id and selected_files, with optional Space saving.
generate-repository-readme
ChatGPTUse this when the user asks to generate or refresh a README for an imported repository. After authorization, this state-changing action consumes AI credits, creates a generation, and can save it to a Space; it requires the numeric repository_id.
generate-repository-release-notes
ChatGPTUse this when the user wants release notes from two branches of a connected provider repository. After authorization, this state-changing action compares base_branch with compare_branch, consumes AI credits, creates a generation, and can save it to a Space.
generate-swagger-api
ChatGPTUse this when the user supplies API source code and asks for an OpenAPI or Swagger specification. After authorization, this state-changing action consumes AI credits, creates a generation, and returns OpenAPI JSON; it accepts one source_code file or multiple files entries.
generate-uml-diagram
ChatGPTUse this when the user supplies source code and asks for UML, Mermaid, sequence, class, component, or architecture diagrams. State-changing generation action: consumes AI credits, creates a generation, and optionally writes markdown to a Space after authorization. Use browser guidance for local uploads or full repository diagrams.
get-ai-preferences
ChatGPTUse this when the user wants to view current AI writing guidelines, templates, strict mode, generator scope, or team-enforced generation preferences. Read-only: returns effective personal/team preferences and whether they are editable without changing settings.
get-full-tree-documentation-preview
ChatGPTUse this when the user wants to inspect an existing full-tree documentation preview before creating a Space. Read-only: returns repository details, tree titles, page counts, source-file counts, credit impact, and an acceptance hash for the numeric repository_id.
get-generation
ChatGPTUse this when the user wants to read a specific generated output/result, inspect version metadata, see generated markdown, or choose a version for later actions. Read-only: returns the generation by numeric generation_id without changing it.
get-space-activity-log
ChatGPTUse this when the user asks what changed in a Space, who changed settings, sync events, document actions, or recent activity. Read-only Enterprise feature: returns the Space activity/audit log newest first. Requires numeric space_id and Enterprise access.
get-space-document
ChatGPTUse this when the user wants to read the full markdown content of a specific Space document/page after search or listing. Read-only: returns the selected document without changing content. Requires the document ID from list-space-documents, search-space-documents, or global-search.
get-user-info
ChatGPTUse this when the user asks which DocuWriter.ai account is connected or whether it can run a generator. Read-only: returns the account name and a can_generate boolean without changing account data.
get-workspace-suggestion
ChatGPTUse this when the user wants to compare the stored before and proposed Markdown for one Autopilot suggestion in the documentation workspace. Read-only and app-only: requires numeric space_id and suggestion_id from the suggestion inbox; does not apply, discard, or snooze changes.
global-search
ChatGPTUse this when the user wants to search documents across every accessible Space rather than one known Space. Read-only: returns matching titles, snippets, Space details, and URLs for a query without changing content.
invite-team-member
ChatGPTUse this when the user wants to invite a teammate by email with an editor or viewer role. After authorization, this state-changing external action creates a pending invitation and sends one email; invitation acceptance occurs in the browser.
list-generations
ChatGPTUse this when the user asks to find generated outputs, generation history, previous results, archived items, or IDs for later generation actions. Read-only: lists visible personal/team generations and can include previews or full content without changing anything.
list-generators
ChatGPTUse this when the user asks which DocuWriter.ai generators are available or what inputs a generator requires. Read-only: returns generator identifiers, required inputs, credit behavior, Space output behavior, and browser-only setup boundaries without running a generator.
list-provider-connections
ChatGPTUse this when the user asks whether GitHub, GitLab, Bitbucket, or Azure DevOps is connected, or asks which imported repository records already exist. Read-only: returns provider status and browser-only connect/reconnect guidance without exposing credentials. Use repository-link tools for Space Autopilot links.
list-provider-repositories
ChatGPTUse this when the user wants to choose a repository from a connected GitHub, GitLab, Bitbucket, or Azure DevOps provider before creating an Autopilot link. Read-only external-provider lookup: fetches repository choices or returns reauthorization/browser guidance. Requires provider and space_id.
list-space-documents
ChatGPTUse this when the user wants to browse a Space tree, list pages/docs/documents/folders, find numeric document or item IDs, or inspect structure before editing. Read-only: returns documents and folders for one numeric space_id without changing content.
list-space-repository-links
ChatGPTUse this when the user asks which repositories are linked to a Space for Autopilot, repo sync, suggestion generation, trigger events, or recent sync activity. Read-only: returns configured repository links plus bounded sync status/activity without exposing raw provider payloads.
list-space-suggestions
ChatGPTUse this when the user wants to review pending, snoozed, done, high-confidence, or filtered Autopilot/repository-sync documentation suggestions for a Space. Read-only: returns suggestion inbox items and IDs for later apply/discard/snooze tools without changing documents.
list-spaces
ChatGPTUse this when the user asks to see, choose, or look up their documentation Spaces, especially before using tools that need a numeric space_id. Read-only: returns accessible Spaces and does not change settings or documents.
list-team-members
ChatGPTUse this when the user asks who is on their team, which teammates or seats exist, what roles are available, whether pending team invitations exist, or what team-member actions they can perform. Read-only: returns the current team roster, pending invitations, available roles, capabilities, and invitation-acceptance guidance without changing state.
list-webhook-events
ChatGPTUse this when the user asks what webhook events, event names, or callback triggers are available before creating or editing a webhook subscription. Read-only: returns supported event keys and labels without changing subscriptions.
list-webhook-logs
ChatGPTUse this when the user asks whether webhooks delivered, failed, retried, or what payload event logs exist for their webhook subscriptions. Read-only: returns bounded delivery log summaries for owned subscriptions. Use list-webhook-subscriptions first when a subscription ID is needed.
list-webhook-subscriptions
ChatGPTUse this when the user asks which webhooks, callback URLs, integration subscriptions, or event endpoints are configured. Read-only: returns owned webhook subscriptions without changing them. Use list-webhook-events to discover valid event keys.
move-space-item
ChatGPTUse this when the user wants to move, nest, unnest, reorder, or reposition a Space page/document, folder, or external link. State-changing: updates the item location/order directly after authorization. Requires numeric space_id and item_id, plus optional parent_id/order from list-space-documents.
remove-team-member
ChatGPTUse this when the user explicitly wants to remove an existing teammate and revoke their access to team Spaces. After authorization, this destructive action removes the specified member_id from the team; owners and the acting user cannot be removed.
report-feedback
ChatGPTUse this when the user explicitly asks to submit feedback about DocuWriter.ai or its MCP integration. After authorization, this state-changing action records the supplied feedback in DocuWriter.ai internal feedback logs.
restore-generation
ChatGPTUse this when the user wants to unarchive, restore, or show an archived generation again in the active generation list. State-changing: restores the visible archived generation after authorization. Requires generation_id from list-generations with archived=true.
revoke-provider-connection
ChatGPTUse this when the user explicitly asks to disconnect GitHub, GitLab, Bitbucket, or Azure DevOps. After authorization, this destructive action revokes the selected provider connection; it requires a provider key from the connection list.
search-documentation-mentions
ChatGPTUse this when the desktop composer needs documentation pages for the user to mention in a prompt. Read-only: matches page titles and Space names in readable Spaces, returning up to 20 authenticated resource references without document bodies. Requires query, which may be empty for recently updated pages. Use global-search for semantic content questions instead.
search-docuwriter-platform-docs
ChatGPTUse this when the user asks how the DocuWriter.ai platform works or requests its published product instructions. Read-only: searches DocuWriter Platform Docs and returns relevant page excerpts with source URLs. It does not search the user's Spaces or the separate API Docs, and it cannot change documentation.
search-space-documents
ChatGPTUse this when the user wants to find pages, docs, documents, or content inside one specific Space. Read-only: searches the selected Space and returns matching document snippets without changing content. Requires numeric space_id from list-spaces.
set-generation-definitive-version
ChatGPTUse this when the user wants a specific version to become the current content of an existing generation. After authorization, this state-changing action applies version_number to the specified generation_id.
snooze-space-suggestion
ChatGPTUse this when the user wants to postpone, remind later, or snooze one Autopilot/repository-sync documentation suggestion. State-changing: hides the pending suggestion until the specified date/time after authorization. Requires suggestion_id from list-space-suggestions and an until timestamp.
update-ai-preferences
ChatGPTUse this when the user wants to change AI writing guidelines, templates, strict mode, generator scope, or team enforcement. After authorization, this state-changing action updates personal or owner-managed team preferences; team-enforced settings can prevent member edits.
update-generation
ChatGPTUse this when the user wants to rename an existing generated result. After authorization, this state-changing action updates the filename for the specified generation_id.
update-space
ChatGPTUse this when the user wants to rename a Space, edit its description, make it public/private, publish/unpublish it, or change its public slug. State-changing: updates manageable Space settings after authorization. Requires numeric space_id from list-spaces.
update-space-document
ChatGPTUse this when the user wants to replace or update the markdown content/title of an existing Space document. State-changing and content-destructive: writes the new document content directly after authorization. Read the document first when preserving existing content matters.
update-space-item
ChatGPTUse this when the user wants to rename or edit a Space page/document, folder, or external link, including markdown content, external URL, or parent folder changes. State-changing: updates the Space item directly after the MCP client authorizes the call. Requires numeric space_id and item_id from list-space-documents.
update-space-repository-link
ChatGPTUse this when the user wants to change an existing Space Autopilot repository link. After authorization, this state-changing external action updates its branch, triggers, path filters, AI context, notifications, or auto-apply settings and requires Enterprise access.
update-team-member-role
ChatGPTUse this when the user wants to change an existing teammate between configured editor and viewer roles. After authorization, this state-changing action updates the specified member_id; the team owner role cannot be changed.
update-webhook-subscription
ChatGPTUse this when the user wants to change a webhook endpoint URL, subscribed events, active/inactive status, or metadata. State-changing external action: updates the owned webhook subscription after authorization. Requires subscription_id from list-webhook-subscriptions; use list-webhook-events for valid keys.
