Buoy MCP server

by ahoybuoy·io.github.ahoybuoy/buoy·v0.8.1

No reviews yet

Design tokens and drift checks for coding agents: use the token, not the hardcoded value.

A91/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A91/100

full report

Adoption

Growing

19 stars1.3k downloads/wk

Reviews

Write one

Nobody has reviewed Buoy yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Buoy tools (4, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

check_design_driftwrite action
Run Buoy's drift analysis and return hardcoded values, unknown tokens and inconsistent components, each with the token to use instead when one exists. Pass the files you just edited to check only those; omit files for the whole repository. Run this after editing styles and fix every issue that has a suggestion.
design_system_context
A Markdown summary of this repository's design system: token categories with example names, the component library, and the anti-patterns Buoy flags. Read it once at the start of a task that touches UI.
find_token_for_value
Given a literal CSS value you are about to write (for example '#1a73e8', '16px', '0.5rem'), return the design tokens in this repository that have exactly that value. Use the token instead of the literal. An empty result means there is no token for it; prefer the nearest token from list_design_tokens over inventing a new value.
list_design_tokens
The design tokens defined in this repository (CSS custom properties, Tailwind theme, tokens.json, SCSS variables). Call this before writing any CSS, inline style or Tailwind class so you use an existing token instead of a literal value. Filter by category (color, spacing, typography, shadow, border, sizing, motion, zIndex) or a name substring.

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings

Code scan216 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 0 days ago15/15
Maintainer identityregistry namespace matches repository owner7/10

Overall 91/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

What the publisher says

From the Buoy repository's README, as published. We do not edit it. Read it on GitHub

Buoy

Catch design drift before it ships.

AI coding tools are fast—but they don't know your design system. They'll write #3b82f6 when you have --color-primary. They'll use padding: 17px when your spacing scale is multiples of 4.

Buoy watches for these issues and helps you fix them.

src/components/Button.tsx:24
  hardcoded-value: #3b82f6 → var(--color-primary) (92% match)

Code-first System Observability

Your shipped code is the design-system source of truth. Declare the packages you own, then use Buoy to map adoption, unmanaged UI surface area, and the blast radius of a component or token change. Figma and other design tools can remain optional inputs; they are not required for the system map.

# .buoy.yaml
project:
  name: acme

system:
  components:
    - packages/ui/src/**
  tokens:
    - packages/tokens/src/**
  owners:
    - name: Checkout
      paths:
        - apps/checkout/**

buoy system map                 # Canonical system vs unmanaged surface area
buoy system impact Button       # Consumers and migration risk for a change
buoy system impact color-primary --kind token

This is the foundation for cloud adoption trends, deprecation planning, and AI-assisted iteration reporting: every result is derived from code and can be attributed to a repository path and owner.

Quick Start

# See your design system immediately (zero config)
npx ahoybuoy show all

# Add project configuration and local integrations when ready
npx ahoybuoy dock

No config needed. Buoy auto-detects your framework and starts working immediately.

What It Catches

Commands

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Install directly

Runs npx -y @buoy-design/cli on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add buoy -- npx -y @buoy-design/cli

Add to Cursor

Buoy: common questions

Is Buoy MCP server safe?: Yes, by our scan: it is graded A (91/100). Read the Buoy safety report
How do I install Buoy?: It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
Does Buoy need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Buoy maintained?: The last commit was in the last day (2026-09-24). The latest release is v0.8.1.
What can I use instead of Buoy?: Servers from other publishers that do the same job: Designesy MCP server, Framingui MCP server and Raven MCP server. Compare all Buoy alternatives.

Alternatives to Buoy

Same job from other publishers: the closest match first, then the best rated.

All Buoy alternatives →

Designesy
Score any URL against a real design contract — 42 checks, A-F grade, token + motion validation.
not reviewed
Growing
A
Framingui
FramingUI design-system tools for coding agents: validate screens, check wiring, browse the catalog.
not reviewed
Growing
A
Raven
Design intelligence for coding agents: audits, design systems, and a taste profile agents consult.
not reviewed
Growing
B
Uizze
UI design that stands out. Full-screen UI references and design materials for coding agents.
not reviewed
Growing
A
Tseha
Serves your design system and coding standards to coding agents, so they stop guessing.
not reviewed
Growing
A

Buoy vs Designesy Buoy vs Framingui Buoy vs Raven