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

ToolWhat it does
list_workspacesThe workspaces you can work in, with your role in each
list_artifactsA workspace's artifacts and apps, most recently updated first
get_artifactOne artifact: its versions, share link, type and who has it open
create_artifactA blank document, slides, media or clip
publish_artifactCreate an artifact from files, or publish a new version (merge, if_match, edits)
create_upload_urlA one-hour URL to PUT a zip, page, PDF, video or picture to
read_artifact_fileA file from a version, plus the version's file list
update_artifactRename, describe, or change settings
duplicate_artifactCopy the latest version into a new private artifact
move_artifactMove to another of your workspaces, with versions, comments and data
delete_artifactDelete with every version and comment. Irreversible
export_artifactA 15-minute download link for a zip of everything
list_foldersA workspace's folders, by path
create_folderMake a folder
file_artifactPut an artifact in a folder, or take it out

Documents

ToolWhat it does
read_docThe doc as Markdown, with each block's id and hash
edit_docInsert, replace, delete or move blocks, live, each guarded by the hash it read
list_peopleWho can be @mentioned in a doc
writing_guideHow to write a document well
visualization_guideHow to draw charts and diagrams in a doc
visualization_recipesWorking charts and diagrams to start from
render_visualizationDraw a visualization block and see the result

Types and rendering

ToolWhat it does
list_viewersEvery artifact type, the files it opens, and its skill
read_skillA type's guide to making one well
render_slidesA picture of a deck's slides, with layout problems found
render_clip_frameA picture of a clip at a moment, with its scenes

Sharing

ToolWhat it does
get_sharingWho has access and the general access setting
share_artifactInvite by email, or change someone's role
unshare_artifactRemove someone's invite
set_general_accessOnly invited, anyone in the workspace, or anyone with the link

Comments and activity

ToolWhat it does
list_inboxOpen threads on everything you can edit, across workspaces
list_commentsAn artifact's threads with their anchors
get_threadOne thread, by id or link
get_comment_imageThe picture or video frame a comment is on, as its author saw it
create_commentStart a thread pinned to text or an element
reply_to_commentReply, refused with what's new if someone wrote meanwhile (after)
resolve_commentResolve or reopen, optionally replying first
list_activityRecent events in a workspace or artifact

Page data

ToolWhat it does
list_collectionsAn artifact's collections with their rules and counts
list_recordsEvery record in a collection
write_recordAdd, set, update or delete a record (if_match)

Apps and stories

ToolWhat it does
create_appMake an app; returns its script tag and GitHub webhook
add_deploymentReport that a branch was deployed somewhere
add_allowed_domainLet the toolbar load on a domain GitHub doesn't report
create_build_upload_urlA one-hour URL to upload a stories build to
list_buildsAn app's hosted builds, newest first
list_storiesThe stories on a hosted build, with their controls