API & MCP

Everything a person can do on Color Blindness Palette Simulator, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://luminacvdsimulator.usefulweb.app/api/v1/calculate – run Color Blindness Palette Simulator
GET https://luminacvdsimulator.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Color Blindness Palette Simulator

Paste 2–24 colors and simulate protanomaly, deuteranomaly and tritanomaly from mild to full dichromacy with the Machado, Oliveira and Fernandes (2009) model. Pairs whose simulated CIEDE2000 difference falls below your threshold are listed, so you can fix chart, map and UI palettes before anyone squints.

Inputs of Color Blindness Palette Simulator
Field	Type	Default	Description
`colors`	textarea	"#D62728 #2CA02C #1F77B4 #FF7F0E #9467BD"	Palette colors (HEX or CSS colors, one per line or separated by spaces)
`type`	select (all, protan, deutan, tritan)	"all"	Color-vision type
`severity`	integer	100	Severity (%; 100 = dichromacy)
`threshold`	number	10	Confusion threshold (ΔE2000)

Example request

Five classic chart colors

curl -X POST https://luminacvdsimulator.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"colors":"#D62728 #2CA02C #1F77B4 #FF7F0E #9467BD","type":"all","severity":100,"threshold":10}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://luminacvdsimulator.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: lumina_cvd_simulator
Local stdio connector: node src/mcp-stdio.ts --tool=lumina-cvd-simulator

{
  "mcpServers": {
    "lumina-cvd-simulator": { "type": "http", "url": "https://luminacvdsimulator.usefulweb.app/mcp" }
  }
}