Changelog

What’s new in StyleRef, newest first. Each entry is tagged by area — Product, MCP, API, CLI, STYLE.md, or ComfyUI.

2026-07

MCP · API · CLI — use your styles from any agent or script. The MCP server at https://styleref.io/api/mcp gives agents 14 tools over Streamable HTTP — anonymous for reading, OAuth 2.1 for anything touching your account. The same capabilities are available as a REST API at https://styleref.io/api/v1, and as npx styleref on the command line. See Connect your client, Overview & authentication, and the CLI reference.

STYLE.md — commit a style to your repo. Compile any style to a STYLE.md file your coding agent can read. There’s a format reference, a linter, and a README badge.

ComfyUI — StyleRef nodes (beta). Your styles load as native ComfyUI nodes, so a style stays in the graph instead of being pasted into a prompt box. Five nodes — Load, Apply, Facets, Reference Images, and Login — plus workflow templates to start from. Public gallery styles need no account, and nothing in the plugin spends credits. See the nodes reference and workflow templates.

Product — connectors. How connectors work, the open-source policy behind them, and how to build your own against the public API. See Connectors.

API · MCP — extract a style from an image you hold locally. POST /api/v1/extractions takes an image upload (up to 8 MB) and returns an id to poll; GET /api/v1/extractions/{id} returns the compiled spec, or saves it straight to your library with ?save_as_draft=true. The source image is kept on the style as an inspiration image. See the endpoints reference.

API · MCP — re-read a past extraction instead of paying for it twice. GET /api/v1/me/extractions lists your extraction history, and GET /api/v1/me/extractions/{id} returns the full block set of one you already own, free to re-read and available compiled with ?format=.

API — any published style as Markdown. Append .md to a /share URL and you get the style as Markdown — an identification header followed by the compiled specification, ready to paste. About 1,000 tokens instead of roughly 28,000 for the web page. See llms.txt & markdown endpoints.

Docs — every page is fetchable as Markdown. Append .md to any path on docs.styleref.io for the same content without the navigation and search payload, with an X-Token-Count header so an agent can budget before reading. The site also publishes its own llms.txt . See llms.txt & markdown endpoints.

API · MCP · CLI · ComfyUI — paste a style’s URL anywhere a reference is accepted. The link in your address bar while editing a style works as a ref, alongside the share slug, the /share URL, and the style’s id. See style references.

API · MCP — richer search results. Search returns up to six hex colors per result, so a picker can paint swatches without a call per style. Search accepts ?offset= and returns hasMore / nextOffset for paging, GET /api/v1/me/saved-styles returns the gallery styles you saved, and GET /api/v1/me/styles accepts ?query= so a search box can filter your own library and the gallery at once.

API · MCP · CLI — your own styles serve your last generation. Fetching one of your own styles returns what you last generated on styleref.io, not your live unsaved edits — the same output the share page shows. A style you have never generated answers 409 styleref_not_generated, asking you to generate it once on the web first. Published gallery styles are unaffected; they’re already frozen snapshots.

Product — choose the cover image for your style. A cover set in Edit info is the one your card shows everywhere. You can pick from the images already on the style — your inspiration uploads and the sample outputs you added when sharing — instead of uploading the same picture again.

Product — credits and plans. A failed extraction refunds its credits automatically, so you’re only charged for successful runs. The free monthly top-up accrues for every full interval, and a single failed payment no longer drops you to the Free plan while the charge retries. Pricing, the app, and these docs all read the same live numbers. See plans & limits.

2026-05

Product — start without an account. Open the style board, fill it in, and extract a style from a reference image before signing up. Your work is saved as you go and carries over when you create an account. See Quickstart.

STYLE.md — an open format for style specifications. A style compiles to a plain-text file with YAML frontmatter and a Markdown body: readable by a person, parseable by a machine, and committable next to your code. See What is STYLE.md and the format reference.

Product — extraction reads several references together. Give extraction more than one reference and it weighs how prominent each one is, then resolves them into a single coherent style instead of averaging them into mud. It covers disciplines beyond image generation — UI and product design, architecture, interior, packaging, editorial, 3D, and data visualization. See Extract a style.

Product — blog posts as Markdown. Append .md to any post URL for the plain text, and every post has a Copy for AI button that copies it with a source header attached, ready to paste into a chat.