Formula Book

For hair colourists, gloves on

Say the formula at the bowl. Hear it back next visit.

Formula Book saves each client's colour formula by voice, reads it back and scales it to today's bowl. Any scale, no extra hardware.

Run the demo See how it works

The demo runs on a labelled simulated Alexa+ client with demo data. Not tested on a real Alexa+ device.

“Lena's last formula”“Make it one and a half times”“Colour Marta: 30 grams 6N and 20 grams 7.1, 20 volume, one to one and a half”“Priya's last formula”“Make it 150 grams in total”“Go for twice the amount”

From a drawer of cards to one sentence.

Before

A card in a drawer, a note on a phone, or memory. Typed later, with colour on the gloves. A colourist leaves and the formulas leave too.

With Formula Book

Said at the bowl, saved to the client on the salon's server, read back next visit and scaled to today's bowl.

How it works

  1. Say it

    Mic or keyboard. The words go to a chooser that picks one of the server's tools.

  2. The server does the maths

    An MCP server, spec 2025-11-25 over Streamable HTTP. Grams, developer, totals and scaling live on the server, not in the chat.

  3. It asks, never guesses

    Two clients called Priya? The server asks which one through MCP elicitation. An unknown client gets a refusal and the next step.

  4. One result, three surfaces

    An MCP Apps card on a screen, the same card on a phone, one spoken sentence on a speaker.

Built for the bowl.

Voice in, voice out

Speak the formula; hear one sentence with every number.

Scales to today's bowl

By a factor or to a total weight.

100 g150 g200 g

Asks, never guesses

Same name? It asks which client.

ShahKapoor

Real MCP traffic

Every JSON-RPC message is visible in the demo.

initializetools/listresources/readtools/call

Free for 50 formulas

The server enforces the limit. Paid plan price: a hypothesis, payments not live.

Try the maths.

Lena's last formula, scaled the way the server does it. Drag to change today's bowl.

x1.5

5N
60 g
6.3
15 g
Developer 20 vol, 1 to 1
75 g
Total in the bowl
150 g

“Lena Okafor: 60 grams 5N, 15 grams 6.3, with 75 grams of 20 volume developer. Total 150 grams.”

3MCP tools
50free formulas per salon
10golden-path steps tested in Chrome
143unit and server tests

Questions

Does this run on Alexa today?

No. The demo uses a simulated Alexa+ client in the repository, labelled on screen. The MCP server is real. Alexa+ add-on tools are partner-only, so it has not been tested on a real device.

Do I need a smart scale?

No. You say the grams from any scale you already use.

What if it mishears a name?

It never guesses. An unknown client gets a refusal and the next step; two matching clients get a question.

What does it cost?

Free for the first 50 formulas per salon. The paid plan price is a hypothesis and payments are not live.

Is it open source?

Yes, MIT licence. Run it locally with two commands.

Your next bowl, already measured.

Run Formula Book