Reference
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.
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 |