Bead Colors MCP
You can use Bead Colors MCP to browse craft color palettes, look up and search colors, and find approximate screen-color matches locally.
List available palettes with palette IDs, brand/series, bead size, entry count, and source links.
Get a specific color by palette ID and printed code, including approximate HEX/RGB and finish.
Search color codes, names, HEX values, brands, or series, optionally restricted to one palette and with result limits.
Find the nearest approximate screen colors in one palette, excluding effect/transparent finishes by default and optionally including effects.
Match a HEX value or existing bead code to one approximate color in each selected target palette, with optional effect inclusion.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bead Colors MCP find the closest Perler bead color to #FF6B6B"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpThe 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 palette IDs, materials, counts, data origins, licenses, status, and sources. |
| List MARD retail-box sizes and their included codes; optionally filter by box size. |
| Find a color by palette ID and code. |
| Search codes, names, HEX, brand, or series; results are limited. |
| Find the closest screen references in one palette by CIEDE2000 (ΔE00). |
| 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 smokenpm 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 toolsget_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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
Convert PNG/JPEG into fuse-bead charts with MARD codes, PNG, CSV and an editable web link.
WCAG color contrast checks, nearest accessible color, CSS color conversion and palette pair checks.
Contrast checks with fixes, OKLCH harmonies, palettes, color-blind previews and code export.
Convert colours between hex, RGB, HSL, OKLCH and CMYK, and compute harmonies.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceExtract 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
- AlicenseNot gradedqualityCmaintenanceProvides color conversion between formats, WCAG contrast ratio computation, and nearest CSS named color lookup.80 npmMIT
- AlicenseNot gradedqualityDmaintenanceFuse bead MCP: convert images, generate AI art, matchcolors (CIEDE2000) estimate bead costs.MIT
- AlicenseAqualityDmaintenanceEnables matching digital sRGB colors to the nearest Behr paint colors and searching Behr colors by code or name.2MIT