> ## Documentation Index
> Fetch the complete documentation index at: https://docs.melius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tool reference

> Every tool exposed by the Melius MCP server.

The Melius MCP server currently exposes 52 GA tools. The agent picks the right ones based on your prompt — you don't have to call them directly.

Tools are grouped below by category.

## Guide

| Tool        | Purpose                                                                             |
| ----------- | ----------------------------------------------------------------------------------- |
| `get_guide` | **Mandatory first call.** Returns the agent's working context for the current task. |
| `get_docs`  | Fetch Melius documentation pages by topic.                                          |

## Teams & Projects

| Tool             | Purpose                                    |
| ---------------- | ------------------------------------------ |
| `team_list`      | List teams your API key has access to.     |
| `project_list`   | List projects in a team.                   |
| `project_get`    | Get a project by ID.                       |
| `project_create` | Create a new project with an empty canvas. |

## Canvas

| Tool                 | Purpose                                                                                                   |
| -------------------- | --------------------------------------------------------------------------------------------------------- |
| `canvas_list`        | List canvases in a project.                                                                               |
| `canvas_get`         | Get canvas metadata.                                                                                      |
| `canvas_content`     | Get all nodes and edges on a canvas.                                                                      |
| `canvas_create`      | Create a new canvas.                                                                                      |
| `canvas_delete`      | Delete a canvas and everything on it.                                                                     |
| `canvas_plan_layout` | Compute positions for new nodes that don't overlap existing content. **Call before `bulk_create_nodes`.** |

## Nodes

| Tool                | Purpose                                                           |
| ------------------- | ----------------------------------------------------------------- |
| `node_create`       | Create a node (text, image, video, file, custom\_text, or group). |
| `node_update`       | Update a node's prompt, model, or settings.                       |
| `node_set_text`     | Set the literal text content of a `custom_text` node.             |
| `node_set_version`  | Select a specific generation version on a node.                   |
| `node_delete`       | Delete a node.                                                    |
| `bulk_delete_node`  | Delete multiple nodes in one batch. Requires user confirmation.   |
| `bulk_create_nodes` | Create multiple nodes — and optionally edges — in one call.       |

## Groups

| Tool           | Purpose                                    |
| -------------- | ------------------------------------------ |
| `node_group`   | Group a set of nodes into a container.     |
| `node_ungroup` | Dissolve a group and release its children. |

## Edges

| Tool                | Purpose                            |
| ------------------- | ---------------------------------- |
| `edge_create`       | Connect two nodes with an edge.    |
| `bulk_create_edges` | Create multiple edges in one call. |
| `edge_delete`       | Remove an edge.                    |

## Runs

| Tool             | Purpose                                                 |
| ---------------- | ------------------------------------------------------- |
| `run_start`      | Start an AI generation on a single node.                |
| `run_get`        | Get the status and result of a run.                     |
| `run_wait`       | Wait for a single run to finish, fail, or be cancelled. |
| `run_latest`     | Get the most recent run for every node on a canvas.     |
| `bulk_run_start` | Start runs on multiple nodes at once.                   |
| `bulk_run_get`   | Get the status of a bulk run.                           |
| `bulk_run_wait`  | Wait for a bulk run to finish.                          |

## Downloads

| Tool                | Purpose                                        |
| ------------------- | ---------------------------------------------- |
| `run_download`      | Download outputs from a single run.            |
| `bulk_run_download` | Download outputs from a bulk run.              |
| `creative_download` | Download all creatives from a canvas as a ZIP. |

## Models

| Tool             | Purpose                                                     |
| ---------------- | ----------------------------------------------------------- |
| `model_list`     | List available AI models, variants, and supported settings. |
| `model_defaults` | See which models are used when none is specified.           |

## Audio

| Tool                | Purpose                                                                          |
| ------------------- | -------------------------------------------------------------------------------- |
| `audio_voice_list`  | List stock ElevenLabs voices for audio nodes (text-to-speech or audio-to-audio). |
| `custom_voice_list` | List the team's saved custom voices (cloned, designed, or imported).             |

## Comments

| Tool              | Purpose                                              |
| ----------------- | ---------------------------------------------------- |
| `comment_list`    | List comments on a canvas.                           |
| `comment_create`  | Create a comment thread at a position on the canvas. |
| `comment_reply`   | Reply to an existing comment.                        |
| `comment_resolve` | Mark a comment as resolved.                          |

## Presence

| Tool               | Purpose                                                                  |
| ------------------ | ------------------------------------------------------------------------ |
| `show_presence`    | Claim a region of the canvas. **Required before node-scoped mutations.** |
| `release_presence` | Release the current presence claim.                                      |

## Presets

| Tool           | Purpose                                                                                       |
| -------------- | --------------------------------------------------------------------------------------------- |
| `preset_list`  | List available canvas presets — pre-built node + edge templates for common workflows.         |
| `preset_apply` | Apply a preset to a canvas in one call. Auto-positions to avoid overlapping existing content. |

## Files & imports

| Tool                   | Purpose                                                                |
| ---------------------- | ---------------------------------------------------------------------- |
| `file_upload`          | Start a file upload. Returns a signed URL.                             |
| `file_upload_complete` | Finalize the upload after the bytes are PUT to the signed URL.         |
| `url_to_canvas`        | Download image or video URLs and add them as file nodes on the canvas. |

## Team skills

| Tool                      | Purpose                                                                                                  |
| ------------------------- | -------------------------------------------------------------------------------------------------------- |
| `create_agent_team_skill` | Save a reusable team skill — a named set of agent instructions invokable from chat by its slash command. |

## Agent context

| Tool                   | Purpose                                                                                                            |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `import_agent_context` | Materialize the team's agent-context images on the canvas as a default group with matching description text nodes. |

## Display

| Tool             | Purpose                                                                 |
| ---------------- | ----------------------------------------------------------------------- |
| `display_canvas` | Render an inline preview of the current canvas state in the agent chat. |
