MCP tools

Your AI agent selects and calls these tools automatically based on your prompts: you don’t invoke them by hand. Each tool has its own page with full parameter details. See the MCP server overview for what the server does and Setup for connecting your client.

These are the creative server tools (generation, models, workflows, files). Workspace administration lives on a separate server. See Management MCP.

Instructions

These tools return platform guidance. Your AI agent calls them automatically to understand how to use Layer — you don’t need to invoke them directly.

• get_instructionsGet general instructions for using the Layer MCP server.
• get_workflow_instructionsGet detailed instructions for running generation workflows.
• get_forge_instructionsGet the guide for generating with a single model (execute_forge, get_forge_run, estimate_forge_price, cancel_inference).

Workspaces

List and inspect the Layer workspaces you belong to.

• list_workspacesList every workspace the current user belongs to.
• get_workspaceGet details for a single workspace including Creative Units balance.

Models

Discover and inspect the generative models available to your workspace.

• list_base_modelsList the base AI models available for generation in a workspace.
• get_base_modelGet full details for a specific base model.

Workflows

Workflows are multi-step pipelines built in the Layer app’s Blueprint editor, or imported whole from a graph.

• list_workflowsList the saved generation workflows (published blueprints) in a workspace.
• estimate_workflow_priceEstimate the Creative Units price of running a workflow before executing it.
• execute_workflowRun one of the workspace's saved workflows to produce images, videos, 3D models, or audio.
• get_workflow_runCheck status of a running workflow.
• cancel_workflow_runCancel a running workflow.
• get_blueprint_system_configDiscover every Blueprint type, node kind, and casting rule available in this workspace.
• import_workflowImport a complete workflow graph as a new private workflow, optionally into a project.

Forge

Forge runs a single model directly, giving you full control over parameters.

• estimate_forge_priceEstimate the Creative Units price of a forge run before executing it.
• execute_forgeExecute a forge run to generate images, videos, 3D models, or audio.
• get_forge_runGet the status and output files of a single-model generation started with execute_forge.

Video timeline

Compose assets the user already has into a single finished video, estimate the cost first, and poll the render.

• estimate_video_timeline_priceEstimate the Creative Units price of a video editor render without rendering anything.
• render_video_timelineEdit assets the user already has into ONE finished video — sequence clips, add transitions, overlay text or logos, layer audio.
• get_generation_runCheck status of a generation run launched with a generation tool (e.g.

Files

Upload local files or public URLs for use as inputs in workflows and forge.

• request_file_upload_urlRequest a signed URL to upload a file directly to storage.
• upload_fileUpload an image or video file from a URL for use as workflow input.