PatternHoop for developers and AI agents

PatternHoop has free, read-only tools for programs and AI agents: look up DMC thread colours, match any colour to DMC threads, work out the size of a pattern and the fabric for it, and search the cross-stitch blog. There is no key and no sign-up. Making a pattern from a photo stays in the editor: the photo never leaves the person's browser.

Tools

• get_dmc_color: a DMC thread by its number ("310", "Blanc", "B5200"): name, hex, RGB and colour family.
• find_nearest_dmc_colors: the DMC threads closest to any colour (#rrggbb or rgb()), ranked by CIEDE2000, the matching the editor uses.
• list_dmc_colors: all 488 DMC colours, by colour family or by a search in the number and name.
• pattern_size: finished size in cm and inches for width × height stitches on Aida 11, 14, 16 or 18, the fabric to cut and stitches per skein.
• search_articles: articles of the blog in English or Russian.

REST API

JSON over HTTPS at https://patternhoop.com/api/v1, described by OpenAPI and listed in the API catalog (RFC 9727). Examples:

• GET /api/v1/colors/310
• GET /api/v1/colors/nearest?color=%23c0392b&limit=3
• GET /api/v1/colors?family=blues
• GET /api/v1/pattern-size?width=140&height=100&aida=14
• GET /api/v1/articles?query=aida&locale=en

Errors come as problem details (RFC 9457). CORS is open. Please keep to a few requests a second: the edge blocks bursts for a few seconds.

MCP server

Streamable HTTP at https://patternhoop.com/api/mcp, stateless, with the same five tools, all read-only. Its server card describes it. Add it to an MCP client as a remote server with that URL; no authorization is needed.

A2A agent

An Agent2Agent agent at https://patternhoop.com/api/a2a (JSON-RPC), described by its agent card. It answers message/send with the same skills. Send a data part {"skill": "find_nearest_dmc_colors", "input": {"color": "#c0392b"}}, or plain text such as "DMC 310", "#c0392b" or "140x100 aida 14".

In the browser

On the editor page, browsers with WebMCP get tools to change the pattern settings and read the thread list, so an agent working in the page can help with the pattern.

Discovery

llms.txt, llms-full.txt, the agent skill, the ARD catalog, auth.md and DNS-AID records under _agents.patternhoop.com. Every page also answers Accept: text/markdown with Markdown.

Terms

The data is free to use. DMC is a trademark of DMC; the colours are approximations of the real threads. The terms of use apply. Questions: privacy@patternhoop.com.