MCP tools

Fil's MCP server gives a connected agent 35 tools. You don't call them yourself: you ask in plain words, and the agent picks the tools and fills in their inputs. Reading and building is free; generate, edit_image, turn_into_skill and captions made with edit_video spend credits, never more than the max_credits they're given. This page walks through a short session, then lists every tool, what it does and its main inputs.

To see the list in Fil, click Agents in the sidebar (open Agents), then MCP tools. Each card says free or credits, and lists its inputs. edit_video's card says free: only the captions it makes cost credits. To connect an agent first, see Connect an agent.

#Example: generate an image and a video from Claude Code

You ask Claude Code: "Make a canvas called Phone launch film. Make a 16:9 hero still of our phone beside a dark boulder, then a 5-second clip from it: a slow push-in as the word Introducing fades in. Tell me the price first." It works through the tools like this:

1. create_canvas with the name. The agent gives you the canvas's link; open it to watch.
2. add_nodes puts down two nodes and the link between them in one call: an image node, Hero still (Nano Banana 2.1, 16:9, with its prompt), and a video node, Hero clip (Grok Imagine Video 1.5 Lite, 720p, 5 seconds), fed by the still. Nothing runs yet.
3. generate on each node with max_credits 0 returns the price without running: up to 7 credits for the still and 18 for the clip, as each node's Generate button shows too. The agent tells you, in words like "The still is up to 7 credits and the clip up to 18, 25 in all. Shall I run them?"
4. You say yes. log notes it on the canvas.
5. generate runs the still with max_credits 7, and check_node with wait returns it when it's done, with a preview the agent looks at.
6. generate runs the clip with max_credits 18, starting from the still, and check_node waits for it again. The agent gives you its link.

Each change, price check and note is a line in Claude Code log.md beside the nodes, newest first, and under Agents › Activity. Calls that only read, such as check_node, leave no line. The two runs cost at most 25 credits; each charges what it really used when it settles.

#Other things to ask for

Each group of tools below answers requests like these:

#Fil MCP tools list

Every tool that works on a canvas takes its canvas_id, from list_canvases or create_canvas, so the tables leave it out. Node ids come from get_canvas, and file ids (asset_id) from search_library or an upload. An input with a ? is optional.

#Account and models

Upscaling, removing a background, rigging and animating are image and 3D models in the list too.

#Canvases and the library

kind is image, video, 3d, code or audio (and pdf for the library). Agents read get_canvas before they change a canvas, since people may have changed it.

#Nodes, links and sections

update_node changes a node's text, prompt, model, settings, name, note, place, size or visibility; pick sets which of its results feeds the next node. The settings add_node, add_nodes, update_node and generate take are the ones in Fil's own menus, and list_models gives the values each model takes:

The tools that add a node (add_prompt, add_document, add_skill, add_file, add_node, add_nodes, make_video) and update_node also take note, a short note shown under the node (up to 500 characters), and x and y, where it goes; left out, it goes beside what it connects to. generate takes neither.

Calendars, task lists and social posts are code nodes with the format calendar, tasks or post; agents read and write them with read_file and write_file.

#Files and uploads

add_file takes a picture, sound, video or GLB model from a public link and saves it to your library first. After an upload, add_file puts the file on the canvas. A GLB model shows as a 3D model you can turn; a sound plays on the canvas and can be wired into an audio node or a prompt.

#Generate, edit and check

• edit_image adds an Edit node fed by the picture and runs it, on Nano Banana 2.1 unless a model is given.
• Runs return at once and show live on the canvas. A run sets aside its top price and refunds the rest when it's done; a run that fails or is blocked is refunded in full.
• payment is your own credits or the team's; on a team canvas, the team pays when it has credits.
• generate and edit_image take visibility. Left out, a new node on Starter, Pro or Max is private, and an edit follows its picture.

#Websites and React apps

Each tool here takes the node_id of the page, design system, data or app it works on; get_site takes any node of the site, or none for every site on the canvas.

Every change is a new version, free, and every page using what changed follows at once. Agents can build and edit sites but can't publish them: you click Publish (see Publish a website). See also Dynamic websites with data and React apps.

#Video edits

edit_video commands: add, move, reorder, trim, split, remove, duplicate, set (transitions, animations, volume and more), transitions, keyframe, lane, settings, captions, caption, cut, and replace (another picture or video in a scene's place, keeping its length and look). It also adds Fil's inserts: graphics, B-roll, shapes, blur boxes and sound effects.

The video tools are free, except captions made with edit_video, which cost credits by the length of sound, within max_credits. Its captions command takes a service for sounds and videos without a script (a voiceover made in Fil is matched to its own script either way): scribe (ElevenLabs Scribe v2, the default), 22 credits an hour of sound; grok (xAI Grok Voice Transcribe 2.0), 10 credits an hour; or gemini (Google Gemini 3.5 Transcribe), 30 credits an hour.

edit_video (while captions are made) and export_video take wait? as check_node does: up to 25 seconds, about 7 on fil.design. If the canvas isn't open anywhere, the export waits until you open it. See Edit videos with AI.

#Visibility

Public work is shared in Community with its prompt; private stays with the people on the canvas. Free work is always public. Agents make work public only when you ask. See Private nodes on a shared canvas.

#Credits: max_credits and the price first

On paid tools, max_credits is the most a call may spend: nothing runs above it. Fil tells agents to price a run with 0 first, tell you, and run once you agree, unless you've given them a budget. Each connection also has its daily cap; see Credits: the price first, and a daily cap.

For a script that calls the server itself, with a key: the server's tool list (tools/list) carries every tool's full input schema. A price check on the Hero still from the example above is a generate call with these arguments:

{
  "canvas_id": "…",
  "node_id": "…",
  "max_credits": 0
}

It answers with status "needs_approval", credits 7 and payment "personal", and in words (wrapped here):

“Hero still” would cost up to 7 credits
(Nano Banana 2.1, from your credits), over max_credits,
so nothing ran. It’s waiting on the canvas: https://fil.design/#canvas/…
Tell the user the price; to run it, call generate with
node_id … and max_credits of at least 7.

Called again with max_credits 7, it runs: status "generating" and a job_id, and check_node gets the result.

#Upload and size limits

• A file is known by its bytes, not its name: a .glb that isn't a glTF 2.0 model is turned down.
• Sounds, videos and models over 4 MB go straight to storage in three curl steps, which the upload's answer spells out.
• Every file also has to fit your plan's file size (1 MB on Free, 10 MB on Starter, 50 MB on Pro, 100 MB on Max) and your storage.
• When a run takes longer than one check_node wait, the agent calls it again.
• An agent can't use a canvas in the Trash, or change one you can only view.

#What's next

• Connect an agent: connect Claude Code, Codex, Cursor, VS Code or Claude.
• Prompts, documents and skills: the nodes agents add and wire.
• Video generation: the video models an agent can pick.
• Files and the library: where uploads and results land.