# io.github.aimsise/color-engine-mcp (npm · color-engine-mcp)

Six pure, in-memory CSS color tools: parse, convert, WCAG/APCA contrast, gamut map, ramps, solver

- Trust score: 62/100 (medium)
- Change this week: +20
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `color-engine-mcp`: 62/100 (this document), [markdown](https://verifymcp.io/servers/aimsise-color-engine-mcp/color-engine-mcp.md), [page](https://verifymcp.io/servers/aimsise-color-engine-mcp/color-engine-mcp)

## Channel facts

- Registry: `npm`
- Package: `color-engine-mcp`
- Version: `1.0.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 83/100
  - No malware found by supply-chain analysis.
  - CVE check failed: a known medium-severity CVE affects @hono/node-server 1.19.17, reached via @modelcontextprotocol/sdk > @hono/node-server. A fixed version is available.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 53 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 65/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1601 tokens (~266/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add aimsise-color-engine-mcp -- npx -y color-engine-mcp
```

### Codex

```bash
codex mcp add aimsise-color-engine-mcp -- npx -y color-engine-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "aimsise-color-engine-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "color-engine-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add aimsise-color-engine-mcp --command npx --arg -y --arg color-engine-mcp
```

### Hermes

```yaml
mcp_servers:
  aimsise-color-engine-mcp:
    command: "npx"
    args: ["-y", "color-engine-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "aimsise-color-engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "color-engine-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 62, +57)

- [security regression] GHSA-frvp-7c67-39w9 affects this package: medium
- [security regression] Provenance: unverified → fail
- [security regression] Known CVEs: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional] Licence: MIT

### 2026-08-01 (score 5, −13)

- [functional regression] Tool coverage: 100 → unverified

### 2026-07-31 (score 18, −24)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 42, +18)

- [functional improvement] Tool coverage: unverified → 100

### 2026-07-28 (score 24, −18)

- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 42)

First indexed and scored.

## MCP tools (6)

### `parse_color` (~70 tokens)

Parse a CSS color string and return hex, rgb, oklch, and gamut info.

Input parameters:

- `input` (string, required): CSS color string, e.g. "tomato", "#ff6347", "oklch(0.6 0.18 27)" (max 256 chars)

Output parameters:

- `hex` (string): Lowercase #rrggbb sRGB-clamped hex of the parsed color
- `inGamut` (boolean): false when the input fell outside the sRGB gamut
- `oklch` (object): Raw (lossless) OKLCH components of the parsed color
- `rgb` (object): sRGB-clamped 0-255 integer channels; see inGamut

### `convert_color` (~75 tokens)

Convert a CSS color string into a canonical hex, rgb, hsl, or oklch format string.

Input parameters:

- `input` (string, required): CSS color string to convert, e.g. "#ff0000", "tomato" (max 256 chars)
- `to` (string, required): Target color format to convert the input into

Output parameters:

- `result` (string): The input color formatted in the requested target format (oklch is raw/lossless; hex/rgb/hsl are sRGB-clamped for out-of-gamut inputs)

### `contrast` (~186 tokens)

Compute the WCAG 2.1 contrast ratio between two fully opaque CSS color strings and return WCAG tier flags (AA/AAA normal/large text). Set apca:true to also get the signed APCA-W3 Lc for text `a` over background `b`.

Input parameters:

- `a` (string, required): First CSS color string, e.g. "#000000", "black", "oklch(0 0 0)" (max 256 chars)
- `apca` (boolean): When true, additionally compute the APCA-W3 (SAPC-4g) lightness contrast Lc for text `a` over background `b` (returned as `apcaLc`)
- `b` (string, required): Second CSS color string, e.g. "#ffffff", "white", "oklch(1 0 0)" (max 256 chars)

Output parameters:

- `aaLarge` (boolean): Meets WCAG 2.1 AA for large text (raw ratio >= 3)
- `aaNormal` (boolean): Meets WCAG 2.1 AA for normal text (raw ratio >= 4.5)
- `aaaLarge` (boolean): Meets WCAG 2.1 AAA for large text (raw ratio >= 4.5)
- `aaaNormal` (boolean): Meets WCAG 2.1 AAA for normal text (raw ratio >= 7)
- `apcaLc` (number): Signed APCA-W3 (SAPC-4g) Lc for text `a` over background `b`, rounded to 2 decimals (positive = dark-on-light, negative = light-on-dark); present only when input `apca` is true
- `ratio` (number): 2-decimal display value; tier flags derive from the unrounded raw ratio

### `gamut_map` (~99 tokens)

Map any CSS color string into the sRGB gamut via perceptual OKLCH chroma reduction. Returns the nearest in-gamut hex, raw OKLCH components, and a `clamped` flag indicating whether the input was out-of-gamut.

Input parameters:

- `input` (string, required): Any CSS color string, e.g. "#ff0000", "oklch(0.6 0.4 30)" (max 256 chars)

Output parameters:

- `clamped` (boolean): true when input was out-of-sRGB-gamut and was mapped
- `hex` (string): Lowercase #rrggbb of the gamut-mapped (in-sRGB) color
- `oklch` (object): Raw (pre-rounding) OKLCH components of the mapped result

### `generate_ramp` (~347 tokens)

Generate a tint-to-shade color ramp from a base CSS color. Returns an ordered list of swatches (light → dark) each with its in-gamut hex, display-rounded OKLCH components (l/c 5dp, h 2dp), WCAG contrast ratios (2dp) + tiers vs white and black, and an in-gamut flag. Optionally emits the ramp as design tokens via tokenFormat ("tailwind" JSON or a "css-variables" :root block).

Input parameters:

- `base` (string, required): Any CSS color string, e.g. "#3b82f6", "oklch(0.6 0.35 30)" (max 256 chars)
- `deltaL` (number): Total lightness span (> 0) centered on the base L — endpoints at base L ± deltaL/2 (overrides the fixed range).
- `lightnessMax` (number): Upper lightness endpoint (OKLCH L, 0..1). Default 0.97.
- `lightnessMin` (number): Lower lightness endpoint (OKLCH L, 0..1). Default 0.05.
- `steps` (integer): Number of swatches (integer 2..512). Default 5.
- `tokenFormat` (string): Optional design-token format for the ramp ("tailwind" JSON object or a "css-variables" :root block); when present the output includes a `tokens` string.
- `tokenName` (string): Base name for emitted tokens (letters/digits/hyphens, must start with a letter, 1-64 chars). Default "color".

Output parameters:

- `swatches` (array)
- `tokens` (string): Design-token string for the ramp (pretty-printed Tailwind JSON or a :root CSS-variables block); present only when tokenFormat was supplied

### `solve_for_contrast` (~554 tokens)

Find a foreground color that meets one or more WCAG 2.1 contrast targets against a background. Binary-searches OKLCH lightness (holding hue/chroma fixed) and returns the nearest-compliant hex plus the achieved ratio. Pass `target` for one target or `targets` for several; `prefer` selects lighter/darker/either; `hue`/`chroma` pin the foreground chromaticity. If BOTH `target` and `targets` are provided, `targets` takes precedence. The response shape differs by mode: a single `target` returns `{ met, color, ratio }` (with an optional `nearMiss` flag); `targets` returns `{ results: [{ met, color, ratio, nearMiss? }, ...] }`. The output schema is an all-optional superset of both shapes (SDK 1.29 single-shape limitation). An unparseable background returns the PARSE_FAILED error; a translucent background (alpha < 1, e.g. rgba()/hsla()/#rgba/#rrggbbaa) returns ALPHA_UNSUPPORTED — composite it over its backdrop first.

Input parameters:

- `background` (string, required): Background CSS color string, e.g. "#FFFFFF", "oklch(0.6 0.1 240)" (max 256 chars).
- `chroma` (number): Fixed OKLCH chroma (>= 0) held constant during the lightness search (reduced along the fixed hue when the sRGB gamut requires it). Defaults to the background's own chroma when omitted; pass chroma ex…
- `hue` (number): Fixed OKLCH hue (degrees, cyclic) held constant during the lightness search. Giving hue WITHOUT chroma does not add saturation: chroma then defaults to the background's own chroma, which is 0 for ach…
- `prefer` (string): Search direction relative to the background lightness. Default "either".
- `target` (number): Single WCAG 2.1 contrast target (e.g. 4.5, 7). Use this OR `targets` (targets wins if both given).
- `targets` (array): Multiple WCAG 2.1 contrast targets (1-50 entries; an empty array is rejected). Takes precedence over `target`. Returns one result per target.

Output parameters:

- `color`: SINGLE-target: nearest-compliant foreground hex, or null when unreachable
- `met` (boolean): SINGLE-target: whether the target contrast was achievable
- `nearMiss` (boolean): SINGLE-target: present/true when met was granted via the near-ceiling tolerance
- `ratio`: SINGLE-target: achieved WCAG 2.1 ratio (display-rounded), or peak attainable when not met
- `results` (array): MULTI-target: one result per requested target (present only for the `targets` path)

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/aimsise-color-engine-mcp/color-engine-mcp#diagnostics

## Score history

- 2026-08-03: 62
- 2026-08-02: 62
- 2026-08-01: 5
- 2026-07-31: 18
- 2026-07-30: 42
- 2026-07-28: 24
- 2026-07-27: 42

## Links

- npm package: https://www.npmjs.com/package/color-engine-mcp
- Socket report: https://socket.dev/npm/package/color-engine-mcp
- Repository: https://github.com/aimsise/color-engine-mcp
- Changelog RSS feed: https://verifymcp.io/servers/aimsise-color-engine-mcp/color-engine-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/aimsise-color-engine-mcp/color-engine-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/aimsise-color-engine-mcp/color-engine-mcp