---
title: "Thread Color Conversion API and MCP Server"
description: "Free JSON API and Model Context Protocol (MCP) server for converting embroidery thread colors between brands, with ΔE 2000. No key needed."
url: https://threadcolormatch.com/developers/
updated: 2026-10-05
---

# 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

- `/api/lines.json`All thread lines with counts and sources

- `/data/{line}.json`Every color of a line with its closest matches, e.g. `/data/dmc.json`

- `/data/convert/{a}-to-{b}.csv`A full conversion table

- `/openapi.json`OpenAPI 3.1 description

- `/llms.txt`Site 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.

---
Source page: https://threadcolormatch.com/developers/
Color data: DMC from MakeBead craft-color-codes (CC BY 4.0); other lines from Ink/Stitch palettes (GPL-3.0). Matches: CIEDE2000, computed by Thread Color Match. License: CC BY 4.0.
