Lovision MCP Tools

Lovision MCP tools let an AI client read projects, manage design files, edit the canvas, check quality, and export results with your authorization. The exact tools available in a chat depend on your account, project permissions, and the scope you grant to the client. After connecting, ask the agent to call lovision.capabilities.list to see what is available in the current session.

Remote sign-in defaults to user-level project access for projects your Lovision account can already use. The agent can browse and open projects without a second approval step, but it must still bind one project with lovision.projects.open before using editor tools.

Recommended Flow

Lovision MCP is session-first. A good workflow is:

Start with lovision.session.init.
Use lovision.capabilities.list to inspect available tools.
Use lovision.document.getContext to read the current project, page, selection, and design context.
Perform the requested task.
Run lovision.quality.check and lovision.preview.capture after meaningful edits.
Finish with lovision.session.finishWork.

Session

Tool	What it does
`lovision.session.init`	Starts a Lovision MCP session and binds authorization, runtime, and any explicit target project.
`lovision.session.status`	Returns the current session identity, target, permissions, and capabilities.
`lovision.session.finishWork`	Ends the work and returns a summary, artifacts, and unresolved findings.
`lovision.session.abortWork`	Aborts the current work and cleans up session state.
`lovision.capabilities.list`	Lists tools that are available, blocked, or unavailable in the current session.

Projects

These tools browse and manage Lovision projects, folders, favorites, recent projects, and sharing settings. The default remote login enables project and folder read/write operations for your accessible projects, but project delete/export and sharing writes require additional authorization scope.

Tool	What it does
`lovision.projects.list`	Lists projects you can access.
`lovision.projects.get`	Reads details for one project.
`lovision.projects.create`	Creates a project.
`lovision.projects.update`	Updates project name, location, or metadata.
`lovision.projects.duplicate`	Duplicates a project.
`lovision.projects.move`	Moves a project to a folder.
`lovision.projects.delete`	Deletes a project.
`lovision.projects.restore`	Restores a recoverable project.
`lovision.projects.export`	Exports project-level content.
`lovision.projects.open`	Opens a project and binds its project-backed document as the active MCP design target.
`lovision.folders.list`	Lists folders.
`lovision.folders.create`	Creates a folder.
`lovision.folders.update`	Renames or moves a folder.
`lovision.folders.delete`	Deletes a folder.
`lovision.projectFavorites.set`	Sets or clears a project favorite.
`lovision.projectRecents.list`	Lists recently opened projects.
`lovision.projectSharing.get`	Reads project sharing state.
`lovision.projectSharing.updateLinkAccess`	Updates link access.
`lovision.projectSharing.invite`	Invites a collaborator.
`lovision.projectSharing.revoke`	Removes a collaborator or revokes an invite.
`lovision.projectSharing.updateRole`	Updates a collaborator role.

Document And Canvas

These tools read the current design context, create documents, adjust pages and view state, and apply canvas edits.

Tool	What it does
`lovision.document.create`	Creates a document after the target is explicit.
`lovision.document.getContext`	Reads page, selection, viewport, fonts, tokens, and capability summaries.
`lovision.lookup`	Looks up design objects or resources in the current session.
`lovision.viewport.fit`	Fits the viewport to nodes or bounds.

Pages And Layout Guides

Tool	What it does
`lovision.pages.list`	Lists pages in the current project.
`lovision.pages.switch`	Switches the active page.
`lovision.pages.create`	Creates a page.
`lovision.pages.rename`	Renames a page.
`lovision.pages.duplicate`	Duplicates a page.
`lovision.pages.delete`	Deletes a page.
`lovision.pages.getBackground`	Reads page background settings.
`lovision.pages.setBackground`	Sets page background settings.
`lovision.layoutGuides.getFrame`	Reads layout guides from a Frame.
`lovision.layoutGuides.setFrame`	Sets layout guides on a Frame.
`lovision.layoutGuides.addFrameGuide`	Adds one layout guide to a Frame.

Blueprint Design Generation

Lovision Blueprint is a structured format for expressing larger design intents. It is useful when an agent needs to create a complete layout rather than making many low-level edits.

Tool	What it does
`lovision.blueprint.validate`	Checks whether a Blueprint is supported by Lovision.
`lovision.blueprint.apply`	Compiles and applies a Blueprint to the canvas.

Quality, Preview, And Export

Tool	What it does
`lovision.quality.check`	Checks layout, text, media, color, and renderability issues.
`lovision.preview.capture`	Captures preview screenshots of the current design.
`lovision.export`	Exports images or other supported design artifacts.

Fonts, Components, And Design Tokens

Tool	What it does
`lovision.fonts.summary`	Gets a summary of fonts available to the design.
`lovision.fonts.list`	Searches or lists available fonts.
`lovision.fonts.resolve`	Resolves whether a requested font is available and what substitution may be used.
`lovision.fonts.warm`	Prepares fonts for rendering or writing.
`lovision.components.list`	Lists available components.
`lovision.components.get`	Reads component details and allowed variant props.
`lovision.textStyles.applyRange`	Applies style changes to a text range.
`lovision.tokens.summary`	Gets a design token summary.
`lovision.tokens.resolve`	Resolves a token reference.
`lovision.tokens.propose`	Creates a token change proposal.
`lovision.tokens.commitProposal`	Commits a token proposal when authorization allows it.

Media And Workflows

Tool	What it does
`lovision.media.acquire`	Acquires or generates media needed for a design.
`lovision.assets.resolveWorkflowInput`	Resolves workflow input into a design-ready asset.
`lovision.workflow.submit`	Submits a Lovision workflow job.
`lovision.integrations.invoke`	Invokes an authorized external integration.
`lovision.production.status`	Checks production capability, quota, or backend status.

Example Prompts

Read-only inspection:

Use Lovision MCP to initialize a session, list available capabilities, and summarize the selected project and page. If no projectId is available yet, list accessible projects and ask me which one to open. Do not change anything.

Create and check a design:

Use Lovision MCP with projectId "<projectId>" to create a compact pricing card on the current page. Validate the plan with Blueprint first, apply it, run a quality check, capture a preview, and summarize the changes.

Project management:

Use Lovision MCP to list my recent projects and tell me which ones I can edit.

Permission Notes

If a tool is unavailable, it is usually because:

The current authorization scope does not include the required permission.
The current project is read-only.
The session has not opened and bound the specific project needed by editor tools yet.
The Lovision backend required for that capability is temporarily unavailable.

Ask the agent to call lovision.capabilities.list first. It usually returns the reason and the suggested next action.

Lovision MCP Tools

On this page