PlugWiki
MasterGo Magic MCP logo

MasterGo Magic MCP, MasterGo's official MCP server

OfficialRemoteLocal
Gethttps://mastergo.com/mcp/xf/ssemastergo-design/mastergo-magic-mcp

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.

Install MasterGo Magic MCP

Claude Code

  1. 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. 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__getDesignSections

  • Reads 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__getDsl

  • Lists 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__getPageLayers

  • Exports 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__extractSvg

  • Gets 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__getMeta

  • Fetches 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__getComponentLink

  • Sets 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__getComponentGenerator

  • Sets 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__getFlutterGenerator

  • Gets 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__getD2c

  • Fills 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__applyDesign

  • Turns 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__C2d

  • Used 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

Technical details
Talks toMasterGo (mastergo.com API)
Sign-in and keysA 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.

ServerOfficialRunsSign-inGitHub stars
For MasterGo
MasterGo Magic MCPThis pageOfficialHostedLocalToken286
Other tools for the same job
Figma MCP ServerFor FigmaOfficialHostedAccount2.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}

    Source
  • Rebuild a design and save it as an HTML file

    Restore design, save as HTML file: https://{domain}/goto/{shortLink}

    Source
  • Export 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

WebsiteGitHubnpmChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 10
  1. MasterGo Magic MCP README · github.com
  2. MasterGo Magic MCP README · github.com
  3. @mastergo/magic-mcp 0.2.12 build · unpkg.com
  4. fix(security): mitigate CVE-2026-15749/15750/15751 · github.com
  5. CVE-2026-15750 · nvd.nist.gov
  6. CVE-2026-15749 Detail · nvd.nist.gov
  7. CVE-2026-15751 Detail · nvd.nist.gov
  8. Releases: mastergo-design/mastergo-magic-mcp · github.com
  9. Grok Build tool name prefix · github.com
  10. Magic MCP 缺少设计稿截图 / 切图导出能力 · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.