# Colour Memory MCP server

Cultural color intelligence. Every colour anchored to a person, a year, and a consequence.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-digbyo-colour-memory
- Repository: https://github.com/DigbyO/colour-memory-api

## Install
- Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://colour-memory-api-production.up.railway.app/mcp

## Tools
- query_conceptual (Search Colours by Concept or Culture) - Ask a cultural, historical, or material colour question. Returns named archive colours with provenance and cultural context. Works for abstract queries like 'grief', 'Ottoman luxury', 'toxic Victorian pigments', or 'the sea at dusk'. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- query_hex (Find Named Colours by Hex Code) - Find the closest named archive colours to a hex value using CIEDE2000 perceptual distance. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- specify_palette (Specify Colour Palette for a Room) - Generate a complete interior specification from 2-8 hex values. Returns surface assignments, 60-30-10 proportions, lighting behaviour, and archive colour names. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- get_colour_metrics (Get Colour Metrics and Properties) - Return perceptual colour metrics: LRV, chroma, hue angle, warmth classification, and illuminant shifts under D65 (6500K), F11 (4000K), and Illuminant A (3000K). Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- get_harmonies (Get Colour Harmonies) - Return complementary, triadic, analogous, and split-complementary harmonies matched to named archive colours. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- accessibility_check (Check WCAG Accessibility) - Return WCAG 2.1 contrast ratios and AA/AAA pass/fail grades for a foreground hex against a background. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- simulate_colour_blindness (Simulate Colour Blindness) - Return simulated hex values for protanopia, deuteranopia, and tritanopia using the Brettel-Vienot-Mollon model. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- match_paint_system (Match to Commercial Paint System) - Find the nearest named colour in commercial paint systems including Farrow and Ball and Little Greene. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- get_colour_card (Get Colour Details by Name) - Look up a named colour and return its hex, archive, provenance, and cultural notes. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- archive_status (Archive and API Status) - Return live archive status: total colour count, per-archive breakdown, embedding model, search engine state, and API version. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- colour_story (Get the Cultural Story of a Colour) - Given a hex value, returns a rich narrative about that colour's cultural journey — where it has appeared in history, what it has meant to different civilisations, and what archive names it carries. Essential for image generation prompts, brand storytelling, and creative briefs. Example: '#DC143C' returns the story of crimson from Byzantine imperial courts through Tudor England to modern sport. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- palette_from_concept (Generate Heritage Palette from Cultural Concept) - Generate a historically grounded colour palette from a cultural concept or theme. Returns 4-6 coordinated archive colours with hex values, proportions, and provenance. Examples: 'Victorian mourning', 'Ottoman court', 'Japanese wabi-sabi', 'Scandinavian winter', 'West African kente', 'Renaissance Florence'. Every colour returned is sourced from the archive with documented history. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- mix_colours (Mix Two Colours (Pigment Simulation)) - Simulate perceptually modelled subtractive mixing of two colours in CIE Lab space (not RGB screen blending). Returns the resulting mixed hex value and its nearest archive match with cultural context. Uses CIE Lab subtractive model for perceptual accuracy. Example: mixing Prussian Blue and Yellow Ochre gives a muted green — the tool identifies which archive colour that green most closely matches. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- colour_timeline (Trace a Colour Through History) - Given a hex value, traces that colour's appearances across cultures and centuries in chronological order. Shows how a colour travelled through history — from its earliest documented use to its modern associations. Essential for understanding why a colour carries the weight it does. Example: deep blue traces from Egyptian lapis lazuli through Byzantine imperial authority to Prussian military uniforms to modern corporate trust signals. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- analyse_image_palette (Extract and Name Colours from an Image) - Upload an image (base64 encoded) and extract its dominant colour palette, with each colour matched to its nearest named archive entry with full cultural provenance. Uses K-means++ extraction plus Bradford chromatic adaptation for accuracy. Returns up to 5 dominant colours, each with archive name, cultural story, nearest RAL standard, and WCAG accessibility data. Works for product photography, interior photos, artwork, brand assets, and mood boards. The image is never stored — processed in memory only. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- compare_colours (Compare Two Colours — Perceptual and Cultural) - Deep perceptual and semantic comparison between any two hex values. Returns quantified differences in LRV, chroma, hue angle, warmth, and CIEDE2000 distance, plus cultural context on both — which is more authoritative, more saturated, more stable under different illuminants, and what each has historically signified. Use when choosing between two colours or explaining why one works better than another. Not a harmony tool — this is a decision and reasoning tool. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- cultural_risk_assessment (Assess Cultural Risk of a Colour or Palette) - Score a hex value or palette for cultural sensitivity, symbolic weight, regional taboos, religious associations, and potential misinterpretation across global markets. Returns warnings, positive associations, and context-dependent readings per colour family, with specific market flags. Use before deploying a colour in a global brand, product, or campaign context. Based on documented cultural colour associations, not generalisation. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- design_session (Full Design Session — Concept to Complete Palette) - One-call compound tool. Submit a concept, medium, audience, and constraints — receive a complete design package: historically grounded palette, cultural narrative, commercial paint matches, WCAG accessibility check, illuminant behaviour, and a ready-made image generation prompt. Replaces chaining query_conceptual + palette_from_concept + colour_story + match_paint_system + accessibility_check + get_colour_metrics. Use when an AI agent or user needs a complete, deployable colour direction in a single call. Not for iterative refinement — use individual tools for that. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- personal_colour_analysis (Personal Colour Analysis — Find Your Colours) - Upload a portrait photo and receive a full personal colour analysis. Determines your seasonal type (Spring, Summer, Autumn, or Winter), colour depth (light, medium, or deep), and undertone (warm, cool, or neutral). Returns a curated palette of archive colours that genuinely suit you — each with full historical provenance and cultural context — plus colours to avoid. Uses Claude Vision for skin, hair, and eye analysis, then matches to the archive by CIEDE2000 perceptual distance. The photo is never stored. Example: a Deep Winter might wear Ottoman Carbon Ink while a True Spring suits Kogi Mango. Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- style_match (Style Match — Does This Go With That?) - The colour question every stylist gets asked: does this bag go with this outfit? Submit your outfit items as hex values with labels (dress, bag, shoes, coat, belt, scarf, etc.) and receive a verdict on what works, what clashes, what is missing, and what to add. Every recommendation is backed by archive colour names and historical context — not generic colour theory, but documented cultural combinations. Also suggests one missing archive colour that would complete the look. Examples: 'I have a navy dress (#1C3A6E) and a tan bag (#C8A87A) — what shoes?' or 'Does this burgundy coat work with olive trousers?' Endpoint: https://colour-memory-api-production.up.railway.app/mcp
- interior_specification (Interior Colour Specification — Full Room Brief) - Generate a complete interior colour specification from a concept or brief. Input a room concept, type, and style — receive a professionally structured colour scheme with 60/30/10 surface assignments, archive colour names with full cultural provenance, Farrow and Ball and Little Greene paint matches, three-illuminant light behaviour (D65 daylight, F11 atrium, Illuminant A incandescent), WCAG accessibility for digital use, and a written cultural rationale explaining why each colour belongs in this room. Examples: 'bold maximalist living room', 'calm Scandi bedroom', 'Victorian study', 'coastal kitchen', 'gallery hallway'. Use /interior-specification/pdf for a downloadable branded PDF version. This is the tool that replaces a colour consultation. Endpoint: https://colour-memory-api-production.up.railway.app/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.DigbyO
- Version: 2.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 26, 2026
- Source: https://registry.modelcontextprotocol.io