Skip to content
MCP server

goldenratio.app

Golden-ratio spacing, grid and Tailwind setup math, exposed as six read-only tools

Install
Pricing
Free
Platforms
API, CLI, Web
Runs
Remotely
Version
0.1.1
Listing updated
3 days ago

About goldenratio.app

goldenratio.app is a free MCP server for design and media. It runs as a hosted remote server, so there is nothing to install locally.

The server wraps the code behind goldenratio.app rather than reimplementing it: the calculator and the tailwindcss-golden-ratio 0.3.5 plugin file are byte-for-byte copies, and outputs were checked against the live site. It never calls the website and stores nothing.

Tools return spacers 1 to 11 with half and double variants, their pixel values, CSS variable names and Tailwind keys for any base, unit and prefix. The grid tool returns the w-grp width classes, starter container CSS and all 38 example rows, and can check a row you supply. A step tool moves any number up or down by 1.618.

The hosted endpoint at mcp.goldenratio.app is stateless with no auth and a limit of 120 requests a minute per IP. A local stdio build runs with Node.

Install

Run in a terminal

claude mcp add --transport http mcp https://mcp.goldenratio.app/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.goldenratio.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.goldenratio.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.goldenratio.app/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.goldenratio.app/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.goldenratio.app/mcp"
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

golden_calculator
Compares stacked spacers on a left and right side.
golden_spacing
Spacing scale with px, CSS variables and Tailwind keys.
golden_grid
Grid widths, container CSS and example rows.
golden_css_variables
The :root block of --golden-ratio-* variables.
tailwind_plugin_setup
Install command, config and theme values for the Tailwind plugin.
golden_ratio_steps
Steps a number up or down by 1.618.

What it does

Golden calculator
Compares stacked spacers on two sides and finds matching combinations.
Spacing scale
Spacers with half and double variants, px and CSS names.
Grid widths
w-grp classes, container CSS and 38 example rows.
CSS variables
The site's --golden-ratio-* root block.
Tailwind plugin setup
Install command, config and generated theme values.

Good for

  • Generate a spacing scale for a design system
  • Wire the golden-ratio plugin into Tailwind
  • Check a grid row's total
  • Scale a size up or down by the ratio

Pricing

Free

Prices change. Check goldenratio.app before you buy.

goldenratio.app FAQ

Does it need an account?

No account or secrets; the hosted endpoint has no auth.

What is the rate limit?

120 requests a minute per IP on the hosted endpoint.

Is it read-only?

Yes, every tool is marked readOnlyHint.

Can I run it locally?

Yes, build the repo and run node dist/stdio.js.

Is goldenratio.app free?

Yes. goldenratio.app is free to use.

How do I add goldenratio.app to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.goldenratio.app/mcp

What are the best alternatives to goldenratio.app?

The closest alternatives to goldenratio.app are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to goldenratio.app

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory