# 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](/docs/mcp) for what the server does and [Setup](/docs/mcp/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](/docs/mcp/management).

## 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\_instructions](/docs/mcp/tools/instructions/get%5Finstructions)Get general instructions for using the Layer MCP server.
* [get\_workflow\_instructions](/docs/mcp/tools/instructions/get%5Fworkflow%5Finstructions)Get detailed instructions for running generation workflows.
* [get\_forge\_instructions](/docs/mcp/tools/instructions/get%5Fforge%5Finstructions)Get detailed instructions for running forge (direct model execution).

## Workspaces

List and inspect the Layer workspaces you belong to.

* [list\_workspaces](/docs/mcp/tools/workspaces/list%5Fworkspaces)List every workspace the current user belongs to.
* [get\_workspace](/docs/mcp/tools/workspaces/get%5Fworkspace)Get details for a single workspace including Creative Units balance.

## Models

Discover and inspect the generative models available to your workspace.

* [get\_model\_recommendations](/docs/mcp/tools/models/get%5Fmodel%5Frecommendations)Get curated model recommendations for common game asset creation tasks.
* [list\_models](/docs/mcp/tools/models/list%5Fmodels)List available AI models/styles in a workspace.
* [get\_model](/docs/mcp/tools/models/get%5Fmodel)Get full details for a specific model/style.

## Workflows

Workflows are multi-step pipelines built in the Layer app’s Blueprint editor.

* [list\_workflows](/docs/mcp/tools/workflows/list%5Fworkflows)List available generation workflows (published blueprints) in a workspace.
* [estimate\_workflow\_price](/docs/mcp/tools/workflows/estimate%5Fworkflow%5Fprice)Estimate the Creative Units price of running a workflow before executing it.
* [execute\_workflow](/docs/mcp/tools/workflows/execute%5Fworkflow)Execute a workflow run to produce images or videos via a multi-step pipeline.
* [get\_workflow\_run](/docs/mcp/tools/workflows/get%5Fworkflow%5Frun)Check status of a running workflow.
* [cancel\_workflow\_run](/docs/mcp/tools/workflows/cancel%5Fworkflow%5Frun)Cancel a running workflow.

## Forge

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

* [estimate\_forge\_price](/docs/mcp/tools/forge/estimate%5Fforge%5Fprice)Estimate the Creative Units price of a forge run before executing it.
* [execute\_forge](/docs/mcp/tools/forge/execute%5Fforge)Execute a forge run to generate images, videos, 3D models, or audio.
* [get\_forge\_run](/docs/mcp/tools/forge/get%5Fforge%5Frun)Check status of an inference run launched 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\_price](/docs/mcp/tools/video-timeline/estimate%5Fvideo%5Ftimeline%5Fprice)Estimate the Creative Units price of a video timeline render without rendering anything.
* [render\_video\_timeline](/docs/mcp/tools/video-timeline/render%5Fvideo%5Ftimeline)Compose assets the user already has into ONE finished video and return immediately with a handle.
* [get\_generation\_run](/docs/mcp/tools/video-timeline/get%5Fgeneration%5Frun)Check 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\_url](/docs/mcp/tools/files/request%5Ffile%5Fupload%5Furl)Request a signed URL to upload a file directly to storage.
* [upload\_file](/docs/mcp/tools/files/upload%5Ffile)Upload an image or video file from a URL for use as workflow input.