app.goldenratioPublished by goldenratio.appOfficial publisherv0.1.1Updated Nov 7, 2026
Golden-ratio design math: spacer calculator, spacing scale, grid widths, CSS vars, Tailwind setup.
Remote MCP server exposing goldenratio.app's golden-ratio design math: spacer calculator, spacing scale, grid widths, CSS variables and Tailwind plugin setup.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/app.goldenratio%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"goldenratio-app": {
"type": "http",
"url": "https://mcp.goldenratio.app/mcp"
}
}
}An MCP server for goldenratio.app. Agents can use the site's golden-ratio design tools: the Golden Calculator, the golden spacing scale, the golden grid, the CSS variables and the Tailwind plugin setup.
The math is the site's own code, unedited:
src/site/calc.js is a byte-for-byte copy of the site's src/utils/calc.js (the Golden Calculator).src/site/tailwindcss-golden-ratio.cjs is a byte-for-byte copy of index.js from tailwindcss-golden-ratio 0.3.5, the plugin the site's tailwind.config.js loads for every spacing value, grid width and CSS variable. The server runs that file as-is and calls its theme functions the way Tailwind does.src/site/grid-examples.json and src/site/spacing-cheatsheet.json are pulled out of the site's Grid.vue and Spacing.vue by the scripts in scripts/.Every output was checked against the live site (see Verification).
The server is read-only. It needs no account and no secrets, stores nothing, and never calls goldenratio.app.
Remote endpoint: https://mcp.goldenratio.app/mcp (Streamable HTTP, stateless, no auth, 120 requests a minute per IP). The original address, https://goldenratio-mcp.fly.dev/mcp, still works and serves the same server. Use of the hosted endpoint is covered by Hosted service.
Add this to ~/.cursor/mcp.json (or a project's .cursor/mcp.json):
For local stdio, use { "command": "node", "args": ["/absolute/path/to/goldenratio-mcp/dist/stdio.js"] }.
Grok Bot uses the same thing. Add a custom MCP connector with the URL https://mcp.goldenratio.app/mcp and no auth.
Add a remote (Streamable HTTP) server with the URL above. If the client only runs stdio servers, bridge it with npx -y mcp-remote https://mcp.goldenratio.app/mcp, or run node dist/stdio.js from a local build.
All tools are annotated readOnlyHint: true.
golden_ratio_steps does the same math.--golden-ratio ships as 1.61803398875px. The plugin passes the ratio as a bare number and Tailwind 1 adds px to bare numbers. --gr is the unitless ratio. golden_css_variables reproduces this so its output matches the site byte for byte.14.828px, the exact value is 14.8328px). golden_spacing returns both: values are the exact numbers the site's CSS uses, and site_cheatsheet is the table as printed.golden_calculator are exact math rounded to 0.1px. The site measures rendered heights, which Chrome rounds to 1/64px, so the two can differ by 0.1px. The matches and the equal/not-equal result are identical.tailwindcss ^1.4).The endpoint at https://mcp.goldenratio.app/mcp (also reachable at https://goldenratio-mcp.fly.dev/mcp) is provided free and as-is, with no guarantee of uptime or accuracy. It may change, be rate-limited, or shut down at any time without notice.
Acceptable use. Don't abuse or overload the service, don't try to get around the rate limit, and don't use it for anything illegal. We may block traffic that does.
Data. The server doesn't need an account, stores nothing you send, and doesn't write request or IP logs. To enforce the rate limit it keeps each client IP address in memory for about a minute, then drops it. The service is hosted on Fly.io, which routes the traffic and handles it under its own privacy policy. We don't sell any data.
MIT, Copyright (c) 2026 Brandname Maker LLC d/b/a True Frontier. Third-party notices are in THIRD_PARTY.md.
The goldenratio.app and True Frontier names and logos aren't covered by this license.
Deploy: fly deploy (app goldenratio-mcp, see fly.toml).
Checked with headless Chrome against the live site on Oct 26, 2026. All 152 checks were exact matches:
:root block from golden_css_variables (min) is identical to the one in the site's live stylesheet.w-grp-* widths match the live CSS. All 33 --golden-ratio-* values match, and each .h-N utility points at the matching variable.site_cheatsheet cell for cell.site_examples (row and column classes).Source: README.md at commit 519d7c3
Golden Calculator
The goldenratio.app Golden Calculator. Stack spacers numbered 1-11 (each is the previous x 1.618) on a left and a right side; returns whether both sides are equal and, if not, every combination of spacers that would make the shorter side match ("Try" on the site). The site starts with left = [6, 5, 6], right = [].
leftrightGolden spacing scale
The golden spacing scale (spacers 1-11 plus half-N and double-N) with exact values, px and CSS variable names, as used by goldenratio.app and the tailwindcss-golden-ratio plugin. With default options it also returns the rounded cheatsheet table from goldenratio.app/#/spacing.
prefixspacer_basespacer_unitroot_font_pxGolden grid
The golden grid from goldenratio.app/#/grid: w-grp-1..11, w-grp-half-*, w-grp-double-* percentage widths, the starter .container/.row CSS, every example row from the site with its total width, and an optional check of your own row (does it add up to exactly 100%?).
rowcontainer_pxinclude_examplesGolden CSS variables
The :root block of golden-ratio CSS variables (--golden-ratio-1..11, half-*, double-*, --gr) exactly as goldenratio.app ships it. Use without Tailwind.
formatspacer_basespacer_unittailwindcss-golden-ratio setup
How to add the tailwindcss-golden-ratio plugin (the one goldenratio.app uses): install command, tailwind.config.js, options, and the exact theme values it generates (spacing, grp widths, scale, fontSize extras, borderWidth/lineHeight) for the given options.
prefixspacer_basespacer_unituse_css_varsGolden ratio steps
Step any number up or down the golden ratio (x or / 1.61803398875), e.g. to pick a type scale or the next size. What the goldenratio.app Alfred workflow does.
unitvaluerequiredsteps_upsteps_down100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
# remote (nothing to install)claude mcp add --transport http goldenratio-app https://mcp.goldenratio.app/mcp
# or local stdiogit clone https://github.com/truefrontier/goldenratio-mcp && cd goldenratio-mcp && npm install && npm run buildclaude mcp add goldenratio-app -- node "$PWD/dist/stdio.js"{ "mcpServers": { "goldenratio-app": { "url": "https://mcp.goldenratio.app/mcp" } }}npm installnpm run build # tsc, then copies src/site into dist/site unchangednpm test # calls every tool through a real MCP client over stdionode scripts/smoke.mjs https://mcp.goldenratio.app/mcp # same, against the remotenpm run start:http # local Streamable HTTP on :8080/mcpnpm run extract # regenerate the JSON data from a ../goldenratio-app checkout