# MCP tools

> Every tool Fiddle's MCP server gives your agent, grouped by what it's for.

Server: `https://fiddle.fyi/mcp`. Every tool acts as the person who connected the agent. See [Connect an agent](https://docs.fiddle.fyi/connect-an-agent.md).

## Workspaces and artifacts

| Tool | What it does |
| --- | --- |
| `list_workspaces` | The workspaces you can work in, with your role in each |
| `list_artifacts` | A workspace's artifacts and apps, most recently updated first |
| `get_artifact` | One artifact: its versions, share link, type and who has it open |
| `create_artifact` | A blank document, slides, media or clip |
| `publish_artifact` | Create an artifact from files, or publish a new version (`merge`, `if_match`, `edits`) |
| `create_upload_url` | A one-hour URL to `PUT` a zip, page, PDF, video or picture to |
| `read_artifact_file` | A file from a version, plus the version's file list |
| `update_artifact` | Rename, describe, or change settings |
| `duplicate_artifact` | Copy the latest version into a new private artifact |
| `move_artifact` | Move to another of your workspaces, with versions, comments and data |
| `delete_artifact` | Delete with every version and comment. Irreversible |
| `export_artifact` | A 15-minute download link for a zip of everything |
| `list_folders` | A workspace's folders, by path |
| `create_folder` | Make a folder |
| `file_artifact` | Put an artifact in a folder, or take it out |

## Documents

| Tool | What it does |
| --- | --- |
| `read_doc` | The doc as Markdown, with each block's id and hash |
| `edit_doc` | Insert, replace, delete or move blocks, live, each guarded by the hash it read |
| `list_people` | Who can be @mentioned in a doc |
| `writing_guide` | How to write a document well |
| `visualization_guide` | How to draw charts and diagrams in a doc |
| `visualization_recipes` | Working charts and diagrams to start from |
| `render_visualization` | Draw a visualization block and see the result |

## Types and rendering

| Tool | What it does |
| --- | --- |
| `list_viewers` | Every artifact type, the files it opens, and its skill |
| `read_skill` | A type's guide to making one well |
| `render_slides` | A picture of a deck's slides, with layout problems found |
| `render_clip_frame` | A picture of a clip at a moment, with its scenes |

## Sharing

| Tool | What it does |
| --- | --- |
| `get_sharing` | Who has access and the general access setting |
| `share_artifact` | Invite by email, or change someone's role |
| `unshare_artifact` | Remove someone's invite |
| `set_general_access` | Only invited, anyone in the workspace, or anyone with the link |

## Comments and activity

| Tool | What it does |
| --- | --- |
| `list_inbox` | Open threads on everything you can edit, across workspaces |
| `list_comments` | An artifact's threads with their anchors |
| `get_thread` | One thread, by id or link |
| `get_comment_image` | The picture or video frame a comment is on, as its author saw it |
| `create_comment` | Start a thread pinned to text or an element |
| `reply_to_comment` | Reply, refused with what's new if someone wrote meanwhile (`after`) |
| `resolve_comment` | Resolve or reopen, optionally replying first |
| `list_activity` | Recent events in a workspace or artifact |

## Page data

| Tool | What it does |
| --- | --- |
| `list_collections` | An artifact's collections with their rules and counts |
| `list_records` | Every record in a collection |
| `write_record` | Add, set, update or delete a record (`if_match`) |

## Apps and stories

| Tool | What it does |
| --- | --- |
| `create_app` | Make an app; returns its script tag and GitHub webhook |
| `add_deployment` | Report that a branch was deployed somewhere |
| `add_allowed_domain` | Let the toolbar load on a domain GitHub doesn't report |
| `create_build_upload_url` | A one-hour URL to upload a stories build to |
| `list_builds` | An app's hosted builds, newest first |
| `list_stories` | The stories on a hosted build, with their controls |
