# goldenratio.app

> goldenratio.app is a free MCP server for design and media. Golden-ratio spacing, grid and Tailwind setup math, exposed as six read-only tools. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, Web
- **Website:** https://goldenratio.app
- **Repository:** https://github.com/truefrontier/goldenratio-mcp
- **MCP Registry name:** app.goldenratio/mcp
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.goldenratio.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.goldenratio.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/goldenratio-app
