> For the complete documentation index, see [llms.txt](https://help.parta.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.parta.io/mcp/explore-parta-mcp-tools.md).

# Explore Parta MCP tools

Explore the tools of Parta MCP by category and purpose.

Parta MCP comes as two connectors. **Parta MCP Instructional Design** works with your projects and their content. **Parta MCP Block Builder** builds custom blocks.

{% hint style="info" %}
Use the search fields to quickly navigate the table contents.
{% endhint %}

## Parta MCP Instructional Design

### Blocks

| Tool ID                          | Description                                                                                                                |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `apply_block_proposal`           | Applies a block change from propose\_block\_change or compare\_block\_versions after the user approves it.                 |
| `apply_editor_block_template`    | Replaces a block structure with a template, then applies content on top.                                                   |
| `compare_block_versions`         | Shows two versions of a block side by side, so the user can restore an earlier version.                                    |
| `copy_editor_block_content`      | Replaces a block structure and content with another block's, then applies content on top. The source block stays as it is. |
| `create_editor_block`            | Creates new blocks in a section from one or more templates.                                                                |
| `delete_editor_block`            | Soft-deletes a block and removes it from the section order.                                                                |
| `duplicate_editor_block`         | Duplicates a block within its section.                                                                                     |
| `get_edit_project_content_guide` | Explains the workflow for locating, reading, editing, and verifying block content.                                         |
| `get_editor_block`               | Returns full block details, including the current content schema.                                                          |
| `get_editor_element_schemas`     | Returns the content schema for one or more element types.                                                                  |
| `list_editor_blocks`             | Lists active blocks in a section in order.                                                                                 |
| `move_editor_block`              | Moves a block within a section or to another section.                                                                      |
| `propose_block_change`           | Shows a preview of a block change next to the current block. Nothing is saved until the user approves it.                  |
| `update_editor_block`            | Updates one block by replacing bankContentItems.                                                                           |
| `update_editor_blocks`           | Updates up to 50 blocks, with each update committed independently.                                                         |

### Branding

<table data-search="false"><thead><tr><th>Tool ID</th><th>Description</th></tr></thead><tbody><tr><td><code>get_branding</code></td><td>Returns one company-level branding by ID.</td></tr><tr><td><code>list_brandings</code></td><td>Lists company-level brandings and presets.</td></tr><tr><td><code>update_project_branding</code></td><td>Assigns a company branding to a project or resets it.</td></tr></tbody></table>

### Comments

| Tool ID               | Description                                                    |
| --------------------- | -------------------------------------------------------------- |
| `create_comment`      | Creates a comment on a section, task, block, or element.       |
| `delete_comment`      | Soft-deletes a comment and its replies.                        |
| `get_comment`         | Returns one comment by ID.                                     |
| `list_comments`       | Lists comments by location, author, mentions, state, or order. |
| `mark_comment_read`   | Marks a top-level comment thread as read.                      |
| `subscribe_comment`   | Subscribes the current user to a comment thread.               |
| `unsubscribe_comment` | Unsubscribes the current user from a comment thread.           |
| `update_comment`      | Updates comment text or status.                                |

### Tasks

<table data-search="false"><thead><tr><th>Tool ID</th><th>Description</th></tr></thead><tbody><tr><td><code>archive_tasks</code></td><td>Archives up to 50 tasks. Archived tasks leave the board and can't be changed.</td></tr><tr><td><code>create_task</code></td><td>Creates a task in a project's task board, optionally linked to a section or block.</td></tr><tr><td><code>list_tasks</code></td><td>Lists tasks of a company or project, filtered by status or assignee.</td></tr><tr><td><code>update_task</code></td><td>Updates a task's title, description, status, deadline, or assignees.</td></tr></tbody></table>

### Workspace

<table data-search="false"><thead><tr><th>Tool ID</th><th>Description</th></tr></thead><tbody><tr><td><code>get_link</code></td><td>Returns a direct URL to a resource in the app, such as a project, section, or block.</td></tr><tr><td><code>list_companies</code></td><td>Lists companies available to the current user.</td></tr><tr><td><code>list_employees</code></td><td>Lists active people in a company or project, for mentions and task assignment.</td></tr><tr><td><code>list_lms_integrations</code></td><td>Lists the LMS integrations set up for the company.</td></tr></tbody></table>

### Resources

| Tool ID                          | Description                                                                                                                                  |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `cancel_s3_upload`               | Aborts one multipart upload and removes pending metadata.                                                                                    |
| `cancel_s3_uploads`              | Aborts several multipart uploads and cleans up related metadata.                                                                             |
| `complete_s3_upload`             | Finalizes one multipart upload after parts are uploaded.                                                                                     |
| `complete_s3_uploads`            | Finalizes several multipart uploads independently.                                                                                           |
| `copy_file_to_project`           | Shares an existing file with another project without duplicating the S3 object.                                                              |
| `create_file_directory`          | Creates a new folder in a project or company media library.                                                                                  |
| `create_file_from_text`          | Creates a text file, such as Markdown, CSV, JSON, subtitles, or SVG, in a media library.                                                     |
| `create_s3_upload`               | Starts a multipart upload for one file of known size.                                                                                        |
| `create_s3_uploads`              | Starts multipart uploads for several files at once.                                                                                          |
| `delete_file`                    | Soft-deletes a file from a media library. A file still used in blocks, a branding or a font is kept unless the deletion is confirmed.        |
| `delete_file_directory`          | Soft-deletes a folder and all its contents.                                                                                                  |
| `get_file_url`                   | Returns direct download URLs for a file and its variants.                                                                                    |
| `get_manage_project_files_guide` | Explains file storage workflows, including upload, copy, replace, and delete.                                                                |
| `get_use_files_in_blocks_guide`  | Explains how to insert uploaded files into block content.                                                                                    |
| `list_files`                     | Lists files and folders in a project or company media library.                                                                               |
| `rename_file_directory`          | Renames a directory in a media library.                                                                                                      |
| `replace_asset`                  | Replaces a file everywhere it is used across the company library. Requires Digital Asset Management (DAM) to be enabled for the company.     |
| `upload_file_from_url`           | Imports a public file URL into a media library.                                                                                              |
| `upload_files_from_chat`         | Shows an upload form in the chat, so the user can add their own files to a media library. Available only in AI agents that support MCP Apps. |

### Projects

| Tool ID                               | Description                                                                          |
| ------------------------------------- | ------------------------------------------------------------------------------------ |
| `create_editor_project`               | Creates a new project in a company.                                                  |
| `create_project_group`                | Creates a new project folder in a company.                                           |
| `delete_editor_project`               | Deletes a project the same way the app does: the project moves to the company trash. |
| `delete_project_group`                | Deletes an empty project folder.                                                     |
| `duplicate_editor_project`            | Duplicates a project with its sections, blocks, and tags.                            |
| `get_explore_project_structure_guide` | Explains how to read a project structure.                                            |
| `get_project_tree`                    | Returns a project as a nested document at a chosen depth.                            |
| `list_editor_projects`                | Lists non-archived projects in a company.                                            |
| `list_project_groups`                 | Lists project folders in a company.                                                  |
| `move_editor_project`                 | Moves a project into another folder or to the company root.                          |
| `update_editor_project`               | Updates the name of an existing project.                                             |
| `update_project_group`                | Updates a project folder name, description, color, or location.                      |

### Export

| Tool ID                    | Description                                                    |
| -------------------------- | -------------------------------------------------------------- |
| `start_project_export`     | Starts a project export in a selected format or LMS.           |
| `get_project_export`       | Returns export progress, errors, and completed download links. |
| `get_export_project_guide` | Explains how to choose and start a project export.             |

### Sections

| Tool ID                      | Description                                                                             |
| ---------------------------- | --------------------------------------------------------------------------------------- |
| `create_editor_section`      | Creates one new section in a project.                                                   |
| `create_editor_sections`     | Creates several sections in one call.                                                   |
| `delete_editor_section`      | Soft-deletes a section and its tasks. Deleting a chapter also deletes its pages.        |
| `duplicate_editor_section`   | Duplicates a section and its blocks.                                                    |
| `ensure_editor_zone_section` | Returns the project's header or footer zone section and creates it if it doesn't exist. |
| `list_editor_sections`       | Lists project sections with positions, levels, and types.                               |
| `move_editor_section`        | Moves a section and can re-nest it.                                                     |
| `update_editor_section`      | Updates the settings of an existing section.                                            |

### System

| Tool ID               | Description                                       |
| --------------------- | ------------------------------------------------- |
| `clear_session_cache` | Clears per-session caches after external changes. |

### Templates

| Tool ID                                 | Description                                                         |
| --------------------------------------- | ------------------------------------------------------------------- |
| `create_editor_template_from_block`     | Saves one or more blocks as a new editor template.                  |
| `create_editor_template_group`          | Creates a template collection for editor templates and tags.        |
| `delete_editor_template`                | Deletes an editor template.                                         |
| `delete_editor_template_group`          | Archives a template collection if it is empty.                      |
| `get_build_project_from_template_guide` | Explains how to create a project from a template.                   |
| `get_chapter_creation_defaults`         | Returns editorial defaults for chapter grouping.                    |
| `get_course_creation_defaults`          | Returns editorial defaults for new course structure.                |
| `get_cover_creation_defaults`           | Returns editorial defaults for the course cover.                    |
| `get_editor_block_by_template_id`       | Returns a block content schema for a template ID.                   |
| `get_page_creation_defaults`            | Returns editorial defaults for content pages.                       |
| `get_parta_quick_start_templates_guide` | Lists templates in the Parta Quick-Start Collection.                |
| `get_quiz_creation_defaults`            | Returns editorial defaults for quiz sections.                       |
| `get_template_choice_defaults`          | Returns the default template collection to use for course creation. |
| `get_template_structure_guide`          | Explains how to inspect a template content schema.                  |
| `list_editor_template_groups`           | Lists template collections in a company.                            |
| `list_editor_templates`                 | Lists editor templates inside a template collection.                |
| `update_editor_template`                | Updates a template name, tags, or collection.                       |
| `update_editor_template_group`          | Updates a template collection name, color, or branding.             |

### Translation

| Tool ID                       | Description                                                                                                  |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `list_project_locales`        | Lists the languages of a project with their translation status.                                              |
| `start_locale_translation`    | Starts an AI translation of a Language Version.                                                              |
| `get_locale_content`          | Returns the content of a Language Version.                                                                   |
| `update_locale_content`       | Updates the content of a Language Version, up to 50 blocks per call.                                         |
| `delete_project_locales`      | Deletes Language Versions of a project.                                                                      |
| `update_project_language`     | Changes the source language of a project.                                                                    |
| `start_project_translation`   | Starts a standalone translation of a project into a new project (legacy flow).                               |
| `list_project_translations`   | Lists standalone translations of a project (legacy flow).                                                    |
| `export_translation_file`     | Exports a translation file (XLIFF or CSV).                                                                   |
| `import_translation_file`     | Imports a translated XLIFF or CSV file into a Language Version or into a new translated copy of the project. |
| `get_translate_project_guide` | Explains how to translate a project with Parta MCP.                                                          |

{% hint style="info" %}
Language Versions must be enabled for the workspace to translate into a Language Version (**start\_locale\_translation**, **update\_locale\_content**, **import\_translation\_file**). Without them, translate into a separate project with **start\_project\_translation**.
{% endhint %}

{% hint style="info" %}
**start\_project\_export** accepts the languages to include, and **create\_editor\_project** accepts the project language. Exports with an unfinished language are rejected.
{% endhint %}

### Feedback

| Tool ID              | Description                                                                                                                     |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `create_feedback`    | Submits feedback (bug report, idea, or other) about the MCP tools. A person reviews it; no reply comes back through the tool.   |
| `get_feedback_guide` | Explains when to file feedback yourself or ask the user to. Also covers what to include and how to attach files or screenshots. |

## Parta MCP Block Builder

| Tool ID                     | Description                                                                                                                 |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `get_block_builder_guide`   | Explains how to build custom blocks. Read it first.                                                                         |
| `list_block_element_types`  | Lists the element types that create\_custom\_block supports.                                                                |
| `create_custom_block`       | Builds a custom block from a description of its nodes and elements.                                                         |
| `create_block_draft`        | Starts a draft for building a custom block step by step.                                                                    |
| `update_block_draft`        | Applies a batch of structure changes to a block draft. All changes apply or none do.                                        |
| `get_block_draft`           | Returns a block draft as a short tree summary or as the full definition.                                                    |
| `list_block_drafts`         | Lists your open block drafts. A draft expires about 30 minutes after its last change.                                       |
| `complete_block_draft`      | Validates and saves a block draft as a new block, a new template, or in place of an existing block, then deletes the draft. |
| `cancel_block_draft`        | Discards a block draft.                                                                                                     |
| `create_block_preview_link` | Creates a link that shows one block or an unsaved draft without signing in. The link expires in 30 minutes.                 |
