Thread Color Match

API and MCP server

Free, no key required. Convert one code with /api/match, match any color with /api/nearest, convert a whole list with /api/design, or connect an AI assistant to https://threadcolormatch.com/mcp.

REST endpoints

GET https://threadcolormatch.com/api/match?line=dmc&code=310&target=anchor
GET https://threadcolormatch.com/api/nearest?hex=%23C8102E&target=machine
GET https://threadcolormatch.com/api/design?list=Madeira+1147,1800&target=isacord

line and target accept a line slug (dmc, anchor, madeira-rayon, madeira-polyneon, isacord, robison-anton-rayon, robison-anton-polyester, sulky-rayon, floriani, brother, simthread) or a brand name; target also accepts all, hand or machine. Optional k (1–10) sets how many matches per line. /api/design also accepts POST with a JSON body {"list": "...", "from": "...", "target": "..."}.

MCP server

Endpoint: https://threadcolormatch.com/mcp (Streamable HTTP, JSON responses). Tools: convert_thread_color, convert_design_colors, find_thread_by_hex, list_thread_lines.

{
  "mcpServers": {
    "thread-color-match": { "type": "http", "url": "https://threadcolormatch.com/mcp" }
  }
}

Static data

In-browser agents (WebMCP)

The converter, color matcher and design converter forms carry WebMCP attributes, so browser agents can call them as tools and receive structured results.

Terms

Free to use with attribution under CC BY 4.0. Please cache responses; the data changes rarely.

Data updated October 5, 2026. Colors: DMC from MakeBead craft-color-codes (CC BY 4.0); other brands from Ink/Stitch palettes (GPL-3.0). Matches computed with CIEDE2000 — see the methodology.