AI assistants

MCP server setup

ready→made MCP is a remote MCP server that converts a Figma frame into a native Elementor, Gutenberg, Oxygen 6, Oxygen Classic, Etch, Divi or HTML layout with a deterministic layout engine. Use it from Claude Code, Claude Desktop, Codex, Cursor, Windsurf or VS Code. Included in Pro and Lifetime. What it is and how it compares: MCP overview.

1. Get your two tokens

  1. ready→made MCP key. Open api.levels.dev/account/mcp, log in with your plugin account (the email and password you use inside Figma), click Create key, give it a name (for example "Codex on my laptop") and copy it. It is shown once. You can have up to 5 keys and revoke any of them there.
  2. Figma personal access token. In Figma: profile menu → Settings → Security → Personal access tokens → Generate new token. Scope: File content: Read-only. Copy it (starts with figd_).

No plan yet? MCP access is part of ready→made Pro (€19/month) and Lifetime (€250).

2. Connect your client

Replace rm_live_… and figd_… with your values. The server URL is always https://api.levels.dev/mcp.

Claude Code

claude mcp add --transport http readymade https://api.levels.dev/mcp \
  --header "Authorization: Bearer rm_live_…" \
  --header "x-figma-token: figd_…"

Check with claude mcp list; the server should show as connected.

Codex

Add the server to ~/.codex/config.toml. Codex reads the two tokens from environment variables, so they stay out of the file:

[mcp_servers.readymade]
url = "https://api.levels.dev/mcp"
bearer_token_env_var = "READYMADE_KEY"
env_http_headers = { "x-figma-token" = "FIGMA_TOKEN" }
default_tools_approval_mode = "approve"

Then set them in the shell you start Codex from: export READYMADE_KEY=rm_live_… and export FIGMA_TOKEN=figd_…. In Codex, /mcp lists the server and its three tools. The last line lets Codex call the tools without asking each time; without it, codex exec refuses the call.

Cursor

Settings → MCP → Add new global MCP server, or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "readymade": {
      "url": "https://api.levels.dev/mcp",
      "headers": {
        "Authorization": "Bearer rm_live_…",
        "x-figma-token": "figd_…"
      }
    }
  }
}

Windsurf

Cascade → MCP servers → Manage, or edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "readymade": {
      "serverUrl": "https://api.levels.dev/mcp",
      "headers": {
        "Authorization": "Bearer rm_live_…",
        "x-figma-token": "figd_…"
      }
    }
  }
}

VS Code (Copilot agent mode)

Create .vscode/mcp.json in your workspace (or add the server in user settings):

{
  "servers": {
    "readymade": {
      "type": "http",
      "url": "https://api.levels.dev/mcp",
      "headers": {
        "Authorization": "Bearer rm_live_…",
        "x-figma-token": "figd_…"
      }
    }
  }
}

Claude Desktop

Claude Desktop connects header-authenticated remote servers through the mcp-remote bridge (needs Node.js). Settings → Developer → Edit Config:

{
  "mcpServers": {
    "readymade": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://api.levels.dev/mcp",
        "--header", "Authorization:Bearer rm_live_…",
        "--header", "x-figma-token:figd_…"
      ]
    }
  }
}

Restart Claude Desktop afterwards; the tools appear under the hammer icon.

3. Ask

In Figma, select the frame you want, right-click → Copy link to selection. Then, in your assistant:

  • "Convert this Figma frame to Elementor and give me the JSON to paste: https://www.figma.com/design/…?node-id=12-345"
  • "Inspect this Figma file, list the sections on the Landing page, then convert the hero to Gutenberg."
  • "Convert node 12:345 to Oxygen 6, then to HTML, and tell me what differs."

The assistant returns the payload plus a one-line note on how to get it into your builder:

  • Elementor: right-click the editor canvas → Paste from other site (Elementor 3.16+ and 4.x). Ask for elementorFormat: "template" to get a file for Templates → Import instead.
  • Gutenberg: block editor → Code editor → paste → back to Visual editor. Core blocks only.
  • Oxygen 6: select the parent element, paste. Oxygen Classic: right-click → Paste, or the companion plugin for whole pages.
  • Etch: paste into an Etch HTML block or import as a component. HTML: save as .html, CSS and images are inlined.
  • Divi: save the result as a .json file and import it under Divi Library → Import & Export (or the Portability icon in the Divi Builder); images are embedded in the file. Ask for diviFormat: "shortcodes" to get raw Divi 4 shortcodes instead. Divi output is built from the HTML output with the HTML to Divi converter, and the result lists what Divi cannot store. Divi output has not yet been verified in a live Divi install.

Tools

Tool What it does Counts as
list_targets The six output formats, each with a note on how to paste or import it. free
inspect_figma Outline of a file or frame: layers, sizes, text/image/vector counts, whether it fits in one conversion, and section-sized children to convert next. free
convert_figma One frame → one target. Options: elementorFormat (paste | template), assets (hosted | inline | none), includeSize, mode (mdl | default); refresh to bypass your cache. 1 conversion

Limits

  • One frame per call. Convert sections (hero, features, footer), not whole pages: 4,000 layers and 6 MB of output per call, 90 seconds. inspect_figma tells you when a frame is too large and which children to convert instead.
  • 30 tool calls per minute per key, 300 conversions per day per account, 5 active keys per account.
  • SVG icons and logos are always inlined. Photos and other raster images are hosted on api.levels.dev until the first download (at most 1 hour) and referenced by URL; Elementor copies them into your media library when you paste or import (tested on 3.25.4 and 4.2.1). Prefer self-contained output? Ask for options.assets: "inline" (data URLs) or "none". Up to 8 MB per image, 200 MB hosted per account and day.
  • Figma-API friendly. Figma limits file reads hard on View/Collab seats (about 20 per month) and to 10 per minute on Starter Dev seats. If you switch on the Figma data cache in your account (off by default), ready→made fetches a frame once and keeps it encrypted for your account only (7 days, per file version, checked against Figma's cheap version endpoint). Measured on a typical session of one inspect and five conversions across three frames and two builders: 14 Figma API calls without the cache, 5 on the first session, 0 when you repeat or switch targets with the cache on. Every result tells you whether it came from the cache and which file version; pass refresh: true to force a fresh fetch.
  • Figma's own API rate limits apply to your token. If Figma answers 429, wait a minute and retry.

Privacy

Your Figma token travels with each request, is passed on to api.figma.com for that call, and is never stored or written to logs. The Figma data are converted in memory and discarded when the call ends. The converted output is not stored. Images in the output are hosted until your builder downloads them, at most 1 hour, then deleted. We store a hash of your MCP key and, per tool call, the time, the tool and whether it succeeded. That is all, unless you switch something on in your account: the Figma data cache (encrypted, 7 days, saves Figma API calls) or extended diagnostics (target, duration, size, client name, 90 days). Both are off by default.

Zero tracking: the local package @readymade/mcp runs the conversion on your own machine. With an offline license from your account it sends us nothing while you work; set READYMADE_RENEW=manual and it never contacts us at all. Deletion on request: office@wpconverters.com. Details: Data & telemetry and our privacy policy.

Troubleshooting

  • "Invalid or revoked API key": create a new key at api.levels.dev/account/mcp and update your client config.
  • "This account has no active plan": your subscription ended. Reactivate on pricing; your keys keep working once it is active.
  • "Figma is rate-limiting this token (429)": the message tells you how long to wait. Conversions of frames you already fetched keep working from your cache in the meantime, if the cache is on.
  • Headline wraps differently than in Figma: the font is not installed on your site. Every result lists the fonts it uses: Google fonts load automatically, a brand font (the WSG example uses Labil Grotesk) must be registered in WordPress. Until then the layout falls back to a generic family of the same shape.
  • "Figma rejected the token (403)": regenerate the Figma token with the File content scope and make sure your Figma account can open the file.
  • "needs a frame, not a whole file": copy the link with Copy link to selection so it carries node-id, or ask the assistant to inspect the file first.
  • Still stuck? support@levels.dev and include the tool's error message.
Codex converts a Figma frame with the ready→made MCP server.
Philipp Gappmaier

ready→made is built by Philipp Gappmaier and the team at Levels, a web studio in Linz, Austria. We have built WordPress sites for clients for over ten years, and we use this engine on our own projects.

Questions about the MCP server go to support@levels.dev.

Philipp Gappmaier · founder, levels.dev
menu