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.
- 2241
- 1761
- 1346
- 0741
- 6071
- 5440
- 4220
- 3810
- 3543
- 2506
- 3971
- 0020
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
/api/lines.jsonAll thread lines with counts and sources
/data/{line}.jsonEvery color of a line with its closest matches, e.g.
/data/dmc.json/data/convert/{a}-to-{b}.csvA full conversion table
/openapi.jsonOpenAPI 3.1 description
/llms.txtSite map for language models
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.