
MasterGo Magic MCP, MasterGo's official MCP server
Lets Cursor and other AI coding tools read your MasterGo designs and turn them into code, and push HTML back into a design.
This is MasterGo's own server for its design tool. Paste a MasterGo layer link into Cursor, Cline or another AI coding tool and it reads the layout, text and icons so the assistant can rebuild the design as code. It can also save the result to files and send an HTML file back to become a design. It only works with a Team Edition or higher MasterGo account and with files in Team Projects, not drafts.
Good for
- Front-end developers turning MasterGo designs into React, Vue or HTML pages
- Flutter developers who want design layouts and images pulled into their project
- Design-to-code teams on MasterGo Team Edition or higher
- Designers who want icons from a design file exported as SVG
Works in
3 supported · 11 should work
Tap an app to see how to set it up and any known problems.
The README gives three Cursor setups: run it with a token, with environment variables, or use the hosted address. GitHub
The README gives a Cline config that runs it with npx and your token. GitHub
The README gives an OpenCode config that runs it locally with npx. GitHub
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Install MasterGo Magic MCP
Claude Code
- 1
Copy this prompt.
Add the MasterGo Magic MCP server to Claude Code. Run this command: claude mcp add mastergo-magic -e MG_MCP_TOKEN=<MG_MCP_TOKEN> -e API_BASE_URL=https://mastergo.com -- npx -y @mastergo/magic-mcp Ask me for MG_MCP_TOKEN, API_BASE_URL and only put the values in that config, nowhere else. Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js 20 or later, MasterGo Team Edition or higher.
Get a token on mastergo.com: personal settings, Security Settings tab, generate a personal access token. Your account must be Team Edition or higher, and the design file must be in Team Projects, not drafts, or tools return a no permission error. Keep API_BASE_URL (or --url) set to https://mastergo.com; without it the server calls http://localhost:3000. Grok Build and similar clients skip the default tool names; add --no-prefix to the args.
Built from the package data we hold. Not yet tested by us.
Tools
Reads a design in sections so the assistant can rebuild it as code piece by piece
Reads a MasterGo design layer from its link, first as a list of sections with their positions, then one section at a time in full. This is the main way the assistant learns a design's layout, styles and text before writing code.
Try: “Restore design: https://{domain}/file/{fileId}?layer_id={layerId}”
Network ·
mcp__getDesignSectionsReads a whole design layer at once, when the section reader is not available
Fetches the complete layout data for a design layer in one go, along with the coding rules to follow. It is a fallback for small designs, since large ones can overflow the assistant's context.
Try: “Get the full design data for this layer and build it in React”
Network ·
mcp__getDslLists every layer on a design page so big pages can be rebuilt one layer at a time
Lists the layers on a MasterGo page or container. The assistant uses it to break a large page into top-level layers and rebuild them one after another.
Try: “List the layers on this page and rebuild each screen in turn”
Network ·
mcp__getPageLayersExports the icons in a design as SVG code
Finds the vector icons in a design layer, fills in their colors, and returns them as SVG markup, a page at a time when there are many.
Try: “Extract SVG and preview in HTML: https://{domain}/file/{fileId}?layer_id={layerId}”
Network ·
mcp__extractSvgGets site and page settings for building a full website from a design
Returns high-level information about the site and page a design belongs to, plus rules to follow, for when you want a whole website built rather than one component.
Try: “Build the full website from this MasterGo design”
Network ·
mcp__getMetaFetches the docs for components a design uses, so code uses the right components
When a design points to documentation for its components, this reads those pages so the assistant writes code with your component library instead of plain HTML.
Try: “Use our component docs linked in the design when you build this form”
Network ·
mcp__getComponentLinkSets up a step-by-step workflow for building a React or Vue component from a design
Creates a component development workflow and a component spec from a design and saves them in a .mastergo folder in your project, then guides the assistant through building the component.
Try: “Use the component generator to build this button as a Vue component”
Write ·
mcp__getComponentGeneratorSets up a Flutter workflow and downloads a design's images into your project
Gives the assistant rules for turning a design into Flutter widgets, downloads the design's images into your Flutter project, updates their paths, and writes an asset list.
Try: “Build this screen as a Flutter widget using the Flutter generator”
Write ·
mcp__getFlutterGeneratorGets MasterGo's own generated code for a design and saves it with its images
Downloads the design-to-code output MasterGo produced for a design, writes the code to an HTML file and saves its SVG and image files to your project, then returns a short summary.
Try: “Fetch the D2C code for this design and save it in the src/pages folder”
Write ·
mcp__getD2cFills in real icons and text in the generated code and saves the final file
After the assistant writes code with placeholders, this swaps in the exact icons and long text from the design and writes the finished file to disk.
Try: “Restore design, save as HTML file: https://{domain}/goto/{shortLink}”
Write ·
mcp__applyDesignTurns a local HTML file into a MasterGo design
Reads an HTML file from your computer and sends it to MasterGo, which syncs it into a design file. It changes the design, so use it on files you mean to update.
Try: “Send /path/to/landing.html to MasterGo as a design in this file”
Write ·
mcp__C2dUsed by the assistant behind the scenes
Reports which version of the server is running
Returns the version number of the MasterGo server package. The tool name itself carries the version.
Try: “Which MasterGo MCP version is running?”
Read ·
version_<n>
Read from the source code
Pros and cons
Good
- Made and maintained by MasterGo, with frequent releases.
- Free and open source under the ISC license.
- Runs with one npx command, or use the hosted address with no install.
- Splits big pages into sections so large designs fit in the assistant's context.
- Exports a design's icons as SVG.
- Has workflows for React, Vue and Flutter components.
- Can send HTML back into MasterGo as a design.
Watch out
- Needs a paid Team Edition or higher MasterGo account.
- Files in your drafts cannot be read; move them to Team Projects.
- Versions before 0.2.10 had three published security flaws.
- No screenshot or image export yet, which users ask for to match designs more closely.
Permissions
medium risk · 4 things to watch · 3 advisories
Medium risk
The assistant can write files into your project and sync code back into a MasterGo design, and versions before 0.2.10 had three published flaws. Keep it updated and run it only inside the project you want it to change.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Old versions had file and network flaws
Versions before 0.2.10 could be tricked into reading or writing files outside your project or calling internal addresses. Use 0.2.10 or later. github.com
Some tools write files on your computer
Design-to-code, component and Flutter tools save HTML, images and workflow files under your project folder. Run it inside the project you want changed. unpkg.com
It can push code back into a design
The code-to-design tool sends a local HTML file to MasterGo and syncs it into the design file. Use it only on designs you mean to change. unpkg.com
The token acts as your MasterGo account
It can reach every team file your account can. Keep it out of shared or committed config files. github.com
Security advisories
3 known advisories, all fixed in a newer version.
- A crafted file path could make the code-to-design tool read a file outside your projectmedium · Fixed in 0.2.10 · CVE-2026-15749
- A crafted link could make the server request addresses on your internal networkmedium · Fixed in 0.2.10 · CVE-2026-15750
- A crafted project path could make the component tool create folders and write files outside your projectmedium · Fixed in 0.2.10 · CVE-2026-15751
Technical details
| Talks to | MasterGo (mastergo.com API) |
|---|---|
| Sign-in and keys | A MasterGo personal access token passed as a command-line flag, an environment variable (MG_MCP_TOKEN) or, for the hosted server, a request header. |
Alternatives
Use MasterGo Magic MCP if your designs are in MasterGo; it is MasterGo's own server. If your team designs in Figma, use Figma's own server instead.
| Server | Official | Runs | Sign-in | GitHub stars |
|---|---|---|---|---|
| For MasterGo | ||||
| MasterGo Magic MCPThis page | Official | HostedLocal | Token | 286 |
| Other tools for the same job | ||||
| Figma MCP ServerFor Figma | Official | Hosted | Account | 2.1K |
Questions
Why does MasterGo MCP say I have no permission?
Your account or file does not qualify. You need a Team Edition or higher MasterGo account, and the file must be in Team Projects, not in your drafts.
Is MasterGo MCP free?
The server is free and open source. It only works with a paid Team Edition or higher MasterGo account.
Where do I get the MasterGo token?
On mastergo.com, open your personal settings, go to the Security Settings tab, and generate a personal access token.
What is the MasterGo MCP server URL?
The hosted address is https://mastergo.com/mcp/xf/sse, with your token sent in an x-mg-useraccesstoken header. You can also run it on your own computer with npx.
Is it safe?
Use version 0.2.10 or later. Earlier versions had three published flaws that could read or write files outside your project or reach internal addresses. It also writes files into your project by design.
Can it turn code into a MasterGo design?
Yes. It can send a local HTML file to MasterGo and sync it into a design file.
What if a design is too large?
Layers over 20MB return an error. Ask the assistant to list the page's layers and rebuild them one at a time, or select a smaller container in MasterGo and copy its link.
Why does Grok Build not show its tools?
Grok Build skips the tool names this server uses by default. Start the server with the --no-prefix option.
MasterGo MCP vs Figma MCP?
Pick the one for the tool your designs live in. MasterGo Magic MCP reads MasterGo files only; Figma's server reads Figma files only.
How do I add it to Cursor?
Use the steps in the install box above. Replace the placeholder with your MasterGo token, then restart Cursor.
Examples
Rebuild a MasterGo design layer as code
Restore design: https://{domain}/file/{fileId}?layer_id={layerId}
SourceRebuild a design and save it as an HTML file
Restore design, save as HTML file: https://{domain}/goto/{shortLink}
SourceExport a design's icons as SVG and preview them
Extract SVG and preview in HTML: https://{domain}/file/{fileId}?layer_id={layerId}
Source
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
@mastergo/magic-mcp- Registry
- npm
- Endpoint
https://mastergo.com/mcp/xf/sse- Transport
- stdio, Streamable HTTP
- Auth
- token in env
- Version
- 0.2.12
- License
- ISC
- Last commit
- Oct 30, 2026
- Open issues
- 9
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 10Hide
- MasterGo Magic MCP README · github.com
- MasterGo Magic MCP README · github.com
- @mastergo/magic-mcp 0.2.12 build · unpkg.com
- fix(security): mitigate CVE-2026-15749/15750/15751 · github.com
- CVE-2026-15750 · nvd.nist.gov
- CVE-2026-15749 Detail · nvd.nist.gov
- CVE-2026-15751 Detail · nvd.nist.gov
- Releases: mastergo-design/mastergo-magic-mcp · github.com
- Grok Build tool name prefix · github.com
- Magic MCP 缺少设计稿截图 / 切图导出能力 · github.com