LayerBack MCP server
✓ VerifiedConverts diagram images into fully editable Visio, PowerPoint, draw.io, and SVG files.
Also known as TopLocalAI/layerback-mcp
- Stars
- 1
- Tools
- 3
- Downloads, 30 days
- —
- Latest version
- 0.1.2
- Last commit
- Aug 5, 2026
- License
- MIT
What is LayerBack MCP?
LayerBack converts diagram images into fully editable Visio, PowerPoint, draw.io, and SVG files. It exposes 3 tools, such as convert_diagram_image, get_conversion_status, download_converted_diagram.
Summary generated from the project's README
About LayerBack MCP server
Turning screenshots, whiteboard photos, or diagrams trapped in PDFs into editable files is what this server enables for AI agents. It connects MCP-compatible clients like Claude Desktop, Claude Code, or Cursor to the LayerBack service to rebuild shapes, connectors, and labels as native objects. Instead of just generating Mermaid code, your agent can produce actual Visio (VSDX), PowerPoint (PPTX), draw.io, and SVG files from a single conversion.
Developers use this server by providing a LayerBack API key in their MCP configuration. The server runs via npx and requires Node 18 or higher. It provides three specific tools: convert_diagram_image for processing local PNG, JPG, or WebP files, get_conversion_status to poll active jobs, and download_converted_diagram to save the final output to a local path. Each conversion costs 10 credits and returns all supported formats simultaneously.
What you can do with it
- 1Convert whiteboard sketches to professional filesAsk your agent to transform a photo of a physical whiteboard into a structured Visio document.
- 2Rebuild architecture screenshots for editingProvide a screenshot of a system architecture to get back a fully editable draw.io file.
- 3Batch process legacy diagram imagesInstruct the agent to convert an entire folder of PNG images into VSDX format.
Written from the project's README. Every use case is checked against a quote from it.
How to install LayerBack MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall LayerBack MCP in Claude Code
$ claude mcp add --env 'LAYERBACK_API_KEY=<YOUR_LAYERBACK_API_KEY>' layerback-mcp -- npx -y layerback-mcpInstall LayerBack MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"layerback-mcp": {
"command": "npx",
"args": [
"-y",
"layerback-mcp"
],
"env": {
"LAYERBACK_API_KEY": "<YOUR_LAYERBACK_API_KEY>"
}
}
}
}Install LayerBack MCP in VS Code
.vscode/mcp.json
{
"servers": {
"layerback-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"layerback-mcp"
],
"env": {
"LAYERBACK_API_KEY": "<YOUR_LAYERBACK_API_KEY>"
}
}
}
}Install LayerBack MCP in VS Code CLI
$ code --add-mcp '{"name":"layerback-mcp","type":"stdio","command":"npx","args":["-y","layerback-mcp"],"env":{"LAYERBACK_API_KEY":"<YOUR_LAYERBACK_API_KEY>"}}'Install LayerBack MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"layerback-mcp": {
"command": "npx",
"args": [
"-y",
"layerback-mcp"
],
"env": {
"LAYERBACK_API_KEY": "<YOUR_LAYERBACK_API_KEY>"
}
}
}
}Install LayerBack MCP in Codex
$ codex mcp add layerback-mcp --env 'LAYERBACK_API_KEY=<YOUR_LAYERBACK_API_KEY>' -- npx -y layerback-mcpInstall LayerBack MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.layerback-mcp] command = "npx" args = ["-y", "layerback-mcp"] [mcp_servers.layerback-mcp.env] LAYERBACK_API_KEY = "<YOUR_LAYERBACK_API_KEY>"
Install LayerBack MCP in Gemini CLI
$ gemini mcp add -s user -e 'LAYERBACK_API_KEY=<YOUR_LAYERBACK_API_KEY>' layerback-mcp npx -- -y layerback-mcpInstall LayerBack MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"layerback-mcp": {
"command": "npx",
"args": [
"-y",
"layerback-mcp"
],
"env": {
"LAYERBACK_API_KEY": "<YOUR_LAYERBACK_API_KEY>"
}
}
}
}LayerBack MCP tools 3
Detected from the READMEconvert_diagram_imageget_conversion_statusdownload_converted_diagram
| convert_diagram_image | — | |
| get_conversion_status | — | |
| download_converted_diagram | — |
Configuration
LAYERBACK_API_KEYRequiredSecretLayerBack API key from https://layerback.com/settings/apikeys
| Name | Description | |
|---|---|---|
| LAYERBACK_API_KEY | LayerBack API key from https://layerback.com/settings/apikeys | RequiredSecret |
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachabletoplocalai/layerback-mcp is public and reachablegithub.com/toplocalai/layerback-mcp ↗Pass
- Package names this repository as its sourcelayerback-mcp names toplocalai/layerback-mcp as sourcenpmjs.com/package/layerback-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-05github.com/toplocalai/layerback-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from layerback-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model3 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubLayerBack MCP Server
Give your AI agent the one diagram skill it's missing: turning pictures of diagrams into fully editable files.
Agents can write Mermaid — but when the input is a screenshot, a whiteboard photo, or a diagram trapped in a PDF page, they're stuck. This MCP server connects any MCP-compatible agent (Claude Desktop, Claude Code, Cursor, …) to LayerBack, which rebuilds every shape, connector, and label as a native object and returns Visio (VSDX), PowerPoint (PPTX), draw.io, and SVG — all editable, from one conversion.
Tools
| Tool | What it does |
|---|---|
convert_diagram_image |
Convert a local image file (PNG/JPG/WebP); waits for the result by default (~30–60 s) |
get_conversion_status |
Poll a running job |
download_converted_diagram |
Save any output format to a local path |
Setup
- Create an API key at https://layerback.com/settings/apikeys (new accounts include free credits — one conversion costs 10 and includes every output format).
- Add the server to your MCP client config:
{
"mcpServers": {
"layerback": {
"command": "npx",
"args": ["-y", "layerback-mcp"],
"env": { "LAYERBACK_API_KEY": "your-key-here" }
}
}
}
Example prompts
- "Convert ~/Desktop/whiteboard.jpg into a Visio file and save it to my Downloads folder."
- "Here's a screenshot of our architecture diagram — rebuild it as an editable draw.io file."
- "Batch-convert every PNG in ./legacy-diagrams to VSDX."
Notes
- Requires Node 18+.
- REST API docs: https://layerback.com/docs/api · OpenAPI: https://layerback.com/openapi.yaml
- Files upload to LayerBack for conversion and are deleted within 72 hours.
MIT © LayerBack
LayerBack MCP questions
How do I add LayerBack MCP to Claude Code?
Run claude mcp add --env 'LAYERBACK_API_KEY=<YOUR_LAYERBACK_API_KEY>' layerback-mcp -- npx -y layerback-mcp in your terminal. Add --scope user to make it available in every project.
How do I add LayerBack MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does LayerBack MCP provide?
It exposes 3 tools, including convert_diagram_image, get_conversion_status, download_converted_diagram.
What file formats can I convert diagrams into?
The server converts images into Visio (VSDX), PowerPoint (PPTX), draw.io, and SVG formats.
How long does a conversion typically take?
A conversion job usually takes between 30 and 60 seconds.
How long are my uploaded files stored?
Files uploaded for conversion are deleted within 72 hours.