Skip to main content
Glama
Bead Colors MCP

Bead Colors MCP

Craft Colors MCP

A local MCP server for craft color charts and approximate screen-color matching. It combines the existing @meltbead/bead-colors fuse bead references with eight locally bundled palettes distributed by Meltbead under direct authorization. No account or network request is needed after installation.

Requirements

Node.js 20 or newer.

Related MCP server: mcp-color

Install from npm

npx -y @meltbead/bead-colors-mcp

The server uses stdio: an MCP client launches it and communicates through stdin/stdout. Starting it in a terminal will appear idle until a client connects. Add this configuration to an MCP client:

{
  "mcpServers": {
    "bead-colors": {
      "command": "npx",
      "args": ["-y", "@meltbead/bead-colors-mcp"]
    }
  }
}

Package: @meltbead/bead-colors-mcp on npm.

Tools

Tool

Purpose

list_palettes

List palette IDs, materials, counts, data origins, licenses, status, and sources.

list_mard_kits

List MARD retail-box sizes and their included codes; optionally filter by box size.

get_color

Find a color by palette ID and code.

search_colors

Search codes, names, HEX, brand, or series; results are limited.

nearest_colors

Find the closest screen references in one palette by CIEDE2000 (ΔE00).

match_across_palettes

Find one approximate match in each requested palette.

The service exposes 19 palettes: 11 existing fuse bead palettes plus Miyuki Delica, DMC floss, DMC-coded diamond drills, Red Heart yarn, LEGO, Minecraft blocks, Minecraft map colors, and a generated pixel-art palette. Search and cross-palette matching use representative palettes by default; subset palettes and the generated palette remain accessible by ID. Matching excludes effect finishes unless includeEffects is true. Discontinued Delica colors and unbuildable Minecraft map colors are excluded from automatic matches but remain available by code. Transparent entries without one RGB value cannot be matched.

The eight bundled palettes are available as JSON in data/palettes/ and CSV in data/csv/. MARD retail-box membership is also available as data/csv/mard-kits.csv. CSV rows include Meltbead attribution, source URL, license, and status. Run npm run build:csv after editing JSON, then npm run check:csv to verify the exports.

The matching score is CIEDE2000 (deltaE), calculated from each palette's sRGB screen reference. Smaller scores mean closer screen colors. They are not physical measurements or guarantees of material equivalence. get_color accepts case-insensitive codes and common separators; Delica codes also accept shorthand such as DB10, DB-010, and 10 for DB0010.

Every color result includes a reminder to verify important shades against physical materials and printed product codes. Palette metadata includes the original data source and its status where supplied.

Develop

npm install
npm start
npm test
npm run smoke

npm start runs the local source server. smoke starts it through a real MCP stdio client, lists its tools, and calls them.

License and data sources

The server code is MIT licensed. The files in data/ are published under CC BY 4.0, with Meltbead as the attribution party. Suggested credit: Color data: Meltbead (https://meltbead.com/). The additional palettes and MARD retail-box data are distributed under separate authorization from their rights holder. Underlying references and quality notes are in data/palettes/ and DATA_SOURCES.md. The existing @meltbead/bead-colors dependency retains its third-party notices. Brand names belong to their owners.

Available Tools

5 tools
get_colorA

Look up one fuse bead by palette ID and printed code. Includes approximate HEX/RGB and finish.

Inputs: code (required), paletteId (required).

list_palettesA

List available fuse bead palettes, brand, series, bead size, entry count, and source links.

Inputs: no named parameters.

match_across_palettesB

Find one approximate screen-color match per selected palette, starting from a HEX value or an existing bead code.

Inputs: hex, code, includeEffects, sourcePaletteId, +1 more.

nearest_colorsA

Find the nearest approximate RGB screen colors in one palette. Excludes effect and transparent finishes by default.

Inputs: hex (required), paletteId (required), limit, includeEffects.

search_colorsA

Search color codes, names, HEX values, brands, or series. Without paletteId, searches representative palettes only to avoid subset duplicates.

Inputs: query (required), limit, paletteId.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation4/5

    The tools mostly have clear, distinct purposes: list palettes, exact color lookup, search, nearest match within a palette, and match across palettes. There is some potential overlap because search_colors accepts HEX values while nearest_colors performs approximate RGB matching, but the descriptions help distinguish exact/catalog search from approximate matching.

    Naming Consistency4/5

    All names use consistent snake_case and are easy to read. Most follow a verb_noun pattern, though nearest_colors is adjective_noun rather than verb-led, and match_across_palettes adds a prepositional structure.

    Tool Count5/5

    Five tools is well-scoped for a read-only bead color reference server. Each tool covers a distinct mode of access without obvious bloat or redundancy.

    Completeness4/5

    The surface covers palette discovery, exact color lookup, search, nearest matching within a palette, and cross-palette matching. A dedicated way to list all colors in a specific palette is not explicitly exposed, which is a minor gap but not a major blocker.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Extract palettes from images, generate harmonies, gradients, random palettes; Check WCAG and APCA contrast; Suggest nearest passing OkLCH lightness; Simulate color-blindness; Convert and sort colors across formats (hex / RGB / HSL / OkLCH / …)
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides color conversion between formats, WCAG contrast ratio computation, and nearest CSS named color lookup.
      80 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables matching digital sRGB colors to the nearest Behr paint colors and searching Behr colors by code or name.
      2
      MIT