MCP server · v0.2.1

Liquidforge, for your AI.

Give Claude — or Cursor, Codex, any MCP client — the whole library. It can recommend a look for your site, read your brand colours from your website, render a preview it can actually see, find a 3D model, and write the finished component or a Webflow, Framer or HTML embed. Free, open source, and it runs on your own computer.

Claude Desktop

Easiest

Download the extension and double-click it — or drag it into Claude Desktop. It carries everything it needs, including Node.

Download liquidforge.mcpb

Or Settings → Extensions → Advanced → Install Extension. About 10 MB.

Claude Code, Cursor, Codex

Runs the published npm package with npx. Node 18.18 or newer.

claude mcp add liquidforge -- npx -y liquidforge-mcp

Cursor and Codex

.cursor/mcp.json

{
  "mcpServers": {
    "liquidforge": { "command": "npx", "args": ["-y", "liquidforge-mcp"] }
  }
}

~/.codex/config.toml

[mcp_servers.liquidforge]
command = "npx"
args = ["-y", "liquidforge-mcp"]

Claude on the web or phone

No install: add the hosted connector by URL in Settings → Connectors → Add custom connector. Rendering and proposals need your computer, so those two tools are local-only.

https://liquidforge-pi.vercel.app/api/mcp

Try asking

“Add a liquid hero to my landing page — it's for a subwoofer brand, dark and a bit alien. Show me two options before you write it.”
recommend_preset, render, generate_component
“Make the hero match stripe.com's colours and give me the Webflow embed.”
palette_from_url, generate_component
“Find a helmet model that would look good as ferrofluid, and write the React component for it.”
search_models, get_model_import, generate_component
“Something between Mercury 3 and Magma 4 — breed a few and render the best one.”
breed_presets, render
“Put a floating chrome knot on my blog that melts into our logo as you scroll past the pricing section.”
generate_placement, propose_placement

Tools

liquidforge_get_started	Learn the library and which tool to use next.	everywhere
liquidforge_get_docs	Documentation by topic, including the two failures that give no error.	everywhere
liquidforge_list_collections	Twelve material families and 108 colourways, with palettes.	everywhere
liquidforge_inspect_preset	One colourway's exact numbers, before overriding one.	everywhere
liquidforge_recommend_preset	Pick a colourway for a site you describe.	everywhere
liquidforge_palette_from_url	Read a website's brand colours from its CSS and build a colourway from them.	everywhere
liquidforge_generate_component	Write the React component, or a Webflow, Framer or plain HTML embed.	everywhere
liquidforge_search_models	Search five open 3D catalogues — about 46,900 models.	everywhere
liquidforge_get_model_import	Resolve a catalogue model to a URL the component can load.	everywhere
liquidforge_generate_placement	Float an object over an existing site, along a scroll path with checkpoints.	everywhere
liquidforge_breed_presets	Cross two colourways into a litter of new ones.	everywhere
liquidforge_render	Render a look to an image with a browser on your computer, so the AI can see it.	local only
liquidforge_propose_placement	Leave a placement in your project for the in-place editor to approve.	local only

Every tool is read-only except render (writes an image if you ask it to save one) and propose placement (writes one proposal file into your project). Nothing is deleted or sent anywhere you don't ask for.

Setup notes

No account, no API key, no configuration required.
Rendering finds Chrome, Edge, Brave or Chromium by itself. If yours lives somewhere unusual, set it in the extension's settings, or set LIQUIDFORGE_BROWSER.
The components it writes need npm install liquidforge three; the Webflow and Framer embeds need nothing.
Try looks by hand in the Studio.

Privacy

The server runs on your computer with no telemetry. It only contacts the model catalogues you search, the websites you ask it to read, and model URLs in a look you render. The hosted connector keeps no record of your tool calls. Full details in the privacy policy.

Support

Something not working, or a tool you wish it had? Send a message.