Skip to content
Layer

MCP server

Layer provides an MCP (Model Context Protocol) server that lets you generate images, 3D assets, video, and audio directly from AI conversations — no code required.

The server is available at https://mcp.app.layer.ai/mcp over Streamable HTTP. Most clients connect with OAuth; some use a Personal Access Token.

SetupConnect Claude, Cursor, VS Code, Codex, and more.
ToolsThe tools the server exposes, grouped by category.

Administering a workspace (projects, members, usage) is handled by a separate Management MCP server — kept apart so its admin tools don’t crowd the creative toolset.

How it works

Section titled “How it works”

Once connected, the MCP server exposes tools for workspaces, models, workflows, forge (direct model execution), and files. Your AI agent selects and calls them automatically based on your prompts — see MCP tools for the full list.

Example prompts

Section titled “Example prompts”

Once connected, try prompts like:

  • “Generate 4 variations of a crystal sword icon on a transparent background”
  • “Show me what image models are available for my workspace”
  • “Create a 3D model of a treasure chest from this reference image”
  • “Run the product shot workflow with a photo of my item”
  • “How many Creative Units do I have left?”

Your AI agent will pick the right tools, estimate costs, run the generation, and show you the results.

Error codes

Section titled “Error codes”
Code Status Meaning
UNAUTHENTICATED 401 OAuth connection not completed — reconnect in your Connectors settings
FORBIDDEN 403 You don’t have permission for this action
INSUFFICIENT_BALANCE 402 Not enough Creative Units — top up in Settings > Billing
RATE_LIMITED 429 Too many requests — generation is limited to 60/min (plus 30/min for video) per user. Retry after Retry-After.
WORKSPACE_NOT_FOUND 404 Workspace doesn’t exist or you’re not a member
MODEL_NOT_FOUND 404 Model not found or not available in this workspace
WORKFLOW_NOT_FOUND 404 Workflow not found or not linked to this workspace
RUN_NOT_FOUND 404 Workflow or forge run doesn’t exist
INVALID_INPUTS 400 Malformed parameters or UUIDs
UPLOAD_FAILED 400 File could not be downloaded or stored

Having trouble connecting? See the setup troubleshooting section.