npm layerback-mcpstdioMITupdated 1mo ago
Give your AI agent the one diagram skill it's missing: turning pictures of diagrams into fully editable files.
What can you do with layerback mcp?
LayerBack 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
Install
Add layerback mcp to your client. Pick the one you use.
claude mcp add layerback-mcp -- npx -y layerback-mcpcodex mcp add layerback-mcp -- npx -y layerback-mcpamp mcp add layerback-mcp -- npx -y layerback-mcp{
"mcpServers": {
"layerback-mcp": {
"command": "npx",
"args": [
"-y",
"layerback-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"layerback-mcp": {
"command": "npx",
"args": [
"-y",
"layerback-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"layerback-mcp","command":"npx","args":["-y","layerback-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"layerback-mcp": {
"command": "npx",
"args": [
"-y",
"layerback-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"layerback-mcp": {
"command": "npx",
"args": [
"-y",
"layerback-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"layerback-mcp": {
"command": "npx",
"args": [
"-y",
"layerback-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"layerback-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"layerback-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"layerback-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"layerback-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y layerback-mcpRun `goose configure`, choose **Add Extension โ Command-line Extension**, and paste this command.
3 tools
layerback mcp exposes 3 tools to a connected agent.
- 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
Score
73 / 100
Good
- Documentation22/25
- Maintenance19/25
- Trust16/20
- Capability4/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 27 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 3 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint โ no local install
Version history
| Versions | Published |
|---|---|
| 0.1.2Latest | Aug 5, 2026 |