{"id":"io.github.DigbyO/colour-memory","slug":"io-github-digbyo-colour-memory","title":"Colour Memory","description":"Colour meaning, history and evidence for AI: 45,000+ source-graded colour records and 91 tools.","version":"2.3.5","publisher":{"kind":"github","id":"DigbyO","label":"@DigbyO on GitHub","url":"https://github.com/DigbyO"},"website":"https://www.colourmemory.com","repository":"https://github.com/DigbyO/colour-memory-api","remotes":[{"type":"streamable-http","url":"https://api.colourmemory.com/mcp","headers":[{"description":"Optional. Many tools work without a key. A free key (colourmemory.com/start) gives 750 archive calls a month and 25 Intelligence credits.","isSecret":true,"name":"X-Api-Key"}]}],"packages":[],"published":"2026-10-06","updated":"2026-10-06","status":"online","auth":"","latency_ms":1020,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"query_conceptual","title":"Search Colours by Concept or Culture","description":"Answers a cultural, historical or material colour question. Returns named archive colours with provenance and cultural context. Works for abstract queries like 'grief' (returns Ophelia Violet, Titan's Grief), 'toxic Victorian pigments' (returns Nightshade Poison Berry Purple, Victorian Arsenic Mirror Silver), or 'the sea at dusk' (returns Evening Sea, Thames Blue Dusk). A vague or personal-soundin","read_only":true},{"name":"extract_image_colours","title":"Extract Colours from Image","description":"Extract dominant colours from a photograph using Colour Memory's proprietary k-means++ algorithm. Requires either a public image_url, or an image_id. A raw uploaded file with no public URL (e.g. a local file path or a ChatGPT file attachment without a usable download_url) is accepted as an image_id from ingest_image. Returns hex values with proportional weights. Optionally matches colours against ","read_only":true},{"name":"query_hex","title":"Find Named Colours by Hex Code","description":"Find the closest named archive colours to a hex value using CIEDE2000 perceptual distance.","read_only":true},{"name":"palette_specify","title":"Specify Colour Palette for a Room","description":"Generate a complete interior specification from 2-8 hex values. Returns surface assignments, 60-30-10 proportions, lighting behaviour, and archive colour names. The result already carries the rendered palette and its PNG, PDF, ASE, JSON and CSS downloads, ready to show the customer. The archive anchors a colour was derived from are evidence, not the recommended colours. A final palette chosen from","read_only":true},{"name":"colour_metrics","title":"Get Colour Metrics and Properties","description":"Returns numeric metrics derived from a single display colour: an estimated light reflectance value (LRV) and band, relative luminance, CIELAB lightness, chroma and hue angle, and Bradford corresponding colours under two standard illuminants. It also lists what a hex cannot support, such as thermal performance or a measured LRV. This is one component of colour_passport. Returns isolated numeric val","read_only":true},{"name":"colour_harmonies","title":"Get Colour Harmonies","description":"Return complementary, triadic, analogous, and split-complementary harmonies matched to named archive colours. Also available: 'hay_contrast' -- D.R. Hay's (1838) documented contrast pairing between six named hues (yellow/purple, orange/blue, red/green), with Field's proportional power for the pair. Unlike the fixed-angle types, this snaps the input to Hay's nearest named hue rather than rotating i","read_only":true},{"name":"accessibility_check","title":"Check WCAG Accessibility","description":"Evaluates contrast for a single foreground/background pair. For palettes or multiple colours, use accessibility_matrix instead, it replaces multiple accessibility_check calls in one response.","read_only":true},{"name":"accessibility_matrix","title":"Full Palette Accessibility Matrix","description":"Accept a palette array and return every foreground/background combination with contrast ratio, AA normal, AA large, AAA normal, AAA large pass/fail grades, and a summary. One call replaces repeated accessibility_check calls for a palette.","read_only":true},{"name":"accessibility_rules","title":"Accessibility Usage Rules","description":"Convert a palette WCAG matrix into actionable design-system rules. Returns safe pairs, AA-only pairs, large-text-only pairs, decorative-only pairs, best text colour per background, and component usage rules. Deterministic, no LLM cost.","read_only":true},{"name":"colour_slugs","title":"Colour Name Developer Tokens","description":"Return every developer token format for a hex value: CSS variable, kebab-case, camelCase, PascalCase, Tailwind class, TypeScript const, SCSS variable. Archive-grounded name source with dE2000 distance.","read_only":true},{"name":"palette_light_dark","title":"Palette Light and Dark Mode Maps","description":"Generate light-mode and dark-mode role maps from a palette. Analyses LRV, assigns background/surface/text/accent roles for each mode, checks body text contrast safety, and flags missing neutrals. The result already carries the rendered palette and its PNG, PDF, ASE, JSON and CSS downloads, ready to show the customer. The archive anchors a colour was derived from are evidence, not the recommended c","read_only":true},{"name":"accessibility_font","title":"Font Colour Advisor","description":"Given a background hex and a palette of candidate foreground colours, return them ranked by contrast ratio with WCAG grades and specific recommendations for body text, large text, and UI components.","read_only":true},{"name":"archive_search","title":"Archive Keyword Search","description":"Full-text keyword search across all archive colour names and notes. Find colours by name fragment, material, cultural reference, pigment type, or historical period. Complements conceptual embedding search with exact keyword matching. Examples: 'cerulean' (28 matches, e.g. Bourton Cerulean), 'Prussian' (187 matches spanning pigment history), 'medieval' (over 1,000 matches across period archives). A","read_only":true},{"name":"colour_combination","title":"Colour Combination Check","description":"Assess 2-5 colours as a combination for a given context (UI, data viz, fashion, interior, print, branding). Returns harmony type, clash warnings, contrast summary, and specific deployment rules for the context.","read_only":true},{"name":"palette_strict","title":"Strict Archive-Filtered Palette from Concept","description":"Like palette_concept but with archive filtering and relevance controls. Use allowed_archives to restrict results to specific cultural traditions e.g. ['Japan'] for Japanese only. Use min_relevance to filter weak concept matches. Fixes cross-archive drift when cultural specificity matters. The result already carries the rendered palette and its PNG, PDF, ASE, JSON and CSS downloads, ready to show t","read_only":true},{"name":"archive_report_document","title":"Designed Word Report","description":"Create a designed, full-colour Word (.docx) report from Colour Memory records. Builds a document, report, write-up, handout or Word file from archive findings. Records are passed by the record_id or slug exactly as archive_search (or another tool) returned them, grouped into sections with a heading and optional narrative. Colour Memory resolves every record itself and draws its name, date, place, ","read_only":true},{"name":"palette_pdf","title":"Generate Palette PDF","description":"Generates a premium branded PDF specification sheet from a palette of archive entries: full-bleed colour panels, archive names, provenance notes, RAL nearest match, LRV, chroma, WCAG contrast data and Colour Memory branding. Suited to client deliverables, specification sheets and print assets. TRUST BOUNDARY: every colour is verified server-side against the real archive by (name, hex, archive_sour","read_only":true},{"name":"palette_audit","title":"Palette Quality Audit","description":"Full palette quality audit. Scores on accessibility, cultural risk, tonal balance, colour diversity, and archive naming strength. Returns overall score 0-100, grade, and prioritised fix list. Enterprise quality gate -- use before shipping any palette. Deterministic, no LLM cost. The result already carries the rendered palette and its PNG, PDF, ASE, JSON and CSS downloads, ready to show the custome","read_only":true},{"name":"brand_system","title":"Complete Brand Colour System","description":"Complete brand colour system in one call. Returns colour roles with archive names, light and dark mode role maps, typography guidance, usage rules per colour, design tokens (CSS, Tailwind, Figma), and citation cards. Deterministic. No LLM cost. The result already carries the rendered palette and its PNG, PDF, ASE, JSON and CSS downloads, ready to show the customer. The archive anchors a colour was","read_only":true},{"name":"brand_asset_pack","title":"Brand Asset Pack Export","description":"Complete brand asset pack. Returns CSS variables, Tailwind config, Figma tokens JSON, citation cards, and a Markdown brand guide. Everything a brand team needs to ship. Deterministic. No LLM cost.","read_only":true},{"name":"accessibility_simulate","title":"Simulate Colour Blindness","description":"Return simulated hex values for full-severity protanopia, deuteranopia and tritanopia only, using the Machado, Oliveira & Fernandes (2009) model (severity 1.0, linear sRGB), with a flag when a simulated colour had to be clipped to sRGB. Anomalous trichromacy and partial severities are not simulated. A model prediction on a standard display, not how an individual perceives colour.","read_only":true},{"name":"colour_match_paint","title":"Match to Commercial Paint System","description":"Find the nearest named colour in commercial paint systems including Farrow and Ball and Little Greene.","read_only":true},{"name":"colour_card","title":"Get Colour Details by Name","description":"Look up a named colour and return its hex, archive, provenance, and cultural notes.","read_only":true},{"name":"meta_capabilities","title":"API Capabilities Inventory","description":"Return a live inventory of all active endpoints and MCP tools. Use this first to discover what the API can do before making calls. Returns tool count, endpoint list, MCP-exposed tools, and usage notes. Deterministic -- no LLM cost.","read_only":true},{"name":"system_status","title":"Colour Memory Diagnostic / Version Status","description":"Zero-argument diagnostic call: returns exactly what build is live right now (build_sha, schema_version, schema_hash, archive_revision, tool_count, generated_at, server_environment). The schema_hash identifies the deployed tool list, so two connections can be compared: a mismatch usually means one connection holds a stale cached manifest, not a real deployment gap.","read_only":true},{"name":"colour_story","title":"Get the Cultural Story of a Colour","description":"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.","read_only":true},{"name":"palette_concept","title":"Generate Heritage Palette from Cultural Concept","description":"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. The result alread","read_only":true},{"name":"colour_mix","title":"Mix Two Colours (Pigment Simulation)","description":"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.","read_only":true},{"name":"colour_timeline","title":"Trace a Colour Concept Through History","description":"Given a concept or colour name, traces its documented appearances across cultures and centuries in chronological order. Returns a dated sequence of archive entries showing when and where the colour appeared, with primary sources. Use for historical research, provenance chains, and understanding why a colour carries the cultural weight it does. Example: 'indigo' traces from ancient Indian trade rou","read_only":true},{"name":"image_palette","title":"Extract and Name Colours from an Image","description":"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; sRGB pixels are read as D65 CIELAB for matching. Returns up to 5 dominant colours, each with archive name, cultural story, nearest RAL standard, and WCAG accessibility data. Works for product photography, int","read_only":true},{"name":"colour_compare","title":"Compare Two Colours: Perceptual and Cultural","description":"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 anoth","read_only":true},{"name":"colour_cultural_risk","title":"Assess Cultural Risk of a Colour or Palette","description":"Cultural risk assessment for a hex value or palette (symbolic weight, regional taboos, religious associations, market flags). This is one component of colour_passport for single colours. Use colour_passport for a general profile; call this directly for palette-level risk checks or when cultural risk is the only thing being asked about.","read_only":true},{"name":"design_session","title":"Full Design Session: Concept to Complete Palette","description":"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","read_only":true},{"name":"image_personal","title":"Personal Colour Analysis: Find Your Colours","description":"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 the subject, each with full historical provenance and cultural context, plus colours to avoid. Uses Claude Vision for sk","read_only":true},{"name":"style_match","title":"Style Match: Does This Go With That?","description":"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. Pairs are judged on hue relationship and lightness contrast; each item is named from its nearest archive record, with that record's eviden","read_only":true},{"name":"interior_specify","title":"Interior Colour Specification: Full Room Brief","description":"Generate a complete interior colour specification from a concept or brief. Takes a room concept, type and style and returns 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 acces","read_only":true},{"name":"house_specify","title":"Multi-Room House Colour Scheme: Provenance-Grouped Where Documented","description":"Generate a complete multi-room house colour scheme from a single archive. Where the retrieved evidence supports it, rooms are grouped by documented provenance (same object, same pattern colourway, same source citation, same designer, same period+institution); where it does not, they are grouped by perceptual similarity and the response says so -- grouping_basis reports which, and provenance_credit","read_only":true},{"name":"palette_generate","title":"Lock-and-Fill Palette from Archive","description":"Send a palette of up to 12 slots, locking some with hex values and leaving others empty. Empty slots are filled with the nearest CIEDE2000 archive match, interpolated from the locked anchors. Optional archive filter restricts fills to one archive. Returns full citation (name, archive, primary source, colour notes) for every filled slot. Example: lock a client's existing wall colour and fill a 5-co","read_only":true},{"name":"palette_gradient","title":"Archive Gradient: Lab-Interpolated Colour Journey","description":"Generate a perceptually smooth gradient between 2-5 archive anchor colours. Each interpolated stop snaps to the nearest real archive colour by CIEDE2000. Anchor stops are kept true to their source. Choose linear (physically accurate Lab interpolation) or chroma_preserved (LCh interpolation, short-arc hue, avoids desaturated midpoints). Returns stop array, CSS linear-gradient string, or SVG swatch ","read_only":true},{"name":"palette_translate","title":"Translate Any Palette into a Named Archive","description":"Map any list of hex values into a target archive using CIEDE2000 nearest-neighbour matching. Each input hex is matched to the closest named colour in the chosen archive, with a delta-e relevance band (exact / close / approximate / loose) and full provenance. Use to translate a client's paint colours into Shakespeare language, map a brand palette into historical Japanese pigments, or find the neare","read_only":true},{"name":"archive_cliche","title":"Break a Colour Cliche","description":"Find the most surprising archive colour for a concept and generate a memorable one-liner subverting the obvious expectation. Supply a concept (e.g. 'love', 'grief', 'luxury', 'power') and optionally the expected colour (e.g. 'red' for love). The archive finds the contradiction and Claude writes the one-liner, short story, and tweet. Example: love + red returns Shakespeare's dark green with 'Love i","read_only":true},{"name":"colour_verdict","title":"Should I Use This Colour?","description":"Evaluate a hex colour for a specific use case, market, and medium. Returns a decisive verdict: use_with_confidence, use_with_caution, or avoid. Includes strengths, risks, avoid-if scenarios, and better alternatives where needed. Backed by CIEDE2000 archive matching and Claude cultural intelligence. Examples: 'luxury hotel brand in Japan', 'ecommerce CTA button UK', 'heritage interior lime plaster ","read_only":true},{"name":"palette_verdict","title":"Is This Palette Working?","description":"Evaluate a palette of 2-8 hex values for a use case, market, and medium. Returns a verdict (strong / strong_with_adjustment / weak / avoid), a score 0-100, the role of each colour, the single biggest weakness, and a concrete suggestion for what to add to fix it. Each colour is matched to the nearest archive entry for cultural grounding. Examples: 'premium cushion collection UK ecommerce', 'hotel l","read_only":true},{"name":"agent_brief","title":"Generate Colour Direction for Another AI","description":"Generate a complete colour direction package for another AI agent or image generation model. Fetches a historically grounded archive palette from the concept, then produces: an agent brief (colour direction in prose), colour tokens with hex values and roles, a model-specific image generation prompt, a negative prompt, and lighting notes. Supports midjourney, flux, dalle, stable_diffusion. Example:","read_only":true},{"name":"colour_strategy","title":"Complete Colour Strategy","description":"Single-call commercial colour strategy report. Combines archive grounding, verdict, brand fit, market risk, category cliche check, material behaviour, copy hooks, and usage rules. Input: hex + brand_context (category, positioning, audience, channels) + constraints (avoid, must_work_on) + markets + medium. Output: verdict, strategy summary, archive anchor, commercial signal, category cliche risk le","read_only":true},{"name":"archive_report_brief","title":"Archive Report Brief","description":"One-call complete archive research package for a document, PDF, or editorial brief. Input: title, audience, themes, archives to draw from, things to avoid, number of colours. Output: ranked colour cards with full provenance, story order, source confidence flags, pull quote, CTA line, CSS tokens, image prompt for Midjourney/Flux/DALLE, editorial argument, weakest and strongest entries identified. R","read_only":true},{"name":"palette_heritage","title":"Heritage Palette Evolution","description":"Given a legacy palette, generate an archive-grounded premium support system. For each existing colour: identifies its historical archive anchor, names it, and scores its provenance confidence. Detects palette gaps and fills them from the archive. Returns full palette with roles, confidence scores, CSS tokens, and production notes. Every addition has a named historical origin. The result already ca","read_only":true},{"name":"archive_coverage_gap","title":"Coverage Gap Report","description":"Given a list of themes, report which are well-evidenced in the archive and which are under-evidenced or missing. Returns a coverage matrix: for each theme, entries found, coverage grade (strong/moderate/weak/missing), best match with claim strength, and what source type would be needed to improve coverage. Use this BEFORE building an archive_report_brief or brief_forensic to know where the evidenc","read_only":true},{"name":"archive_cultural_anachronism","title":"Anachronism Guard","description":"Check a list of colour entries for anachronism risk. Detects whether the primary source date falls outside the requested period, whether the archive is a known modern source (RacingSilks, FootballStrips), and returns a period_relevance score and safe phrasing. Essential for historical documents: prevents a 2011 Jockey Club racing silk registration being presented as Georgian evidence. Returns anac","read_only":true},{"name":"session_brief","title":"Forensic Brief","description":"Single-call forensic colour brief generator. Runs coverage gap analysis, pulls best archive colours, checks for anachronisms, scores claim roles (anchor/support/analogue/provocation/reject), auto-rejects stubs, generates editorial argument, act structure, pull quote, closing line, and image prompt via Claude. This replaces chaining coverage_gap + archive_report_brief + anachronism_guard + resonanc","read_only":true},{"name":"index_resonance","title":"Resonance Index","description":"Colour Memory's proprietary semantic metric. Score how tightly the material origin of a colour aligns with its social consequence. 1.00 = material and consequence are indistinguishable (blood as prognosis, ash as finality). 0.80 = institution mediates the colour (paint as deterrence, flag as authority). 0.50 = symbolic or associative only. Input: list of colour entries with name, hex, archive, sou","read_only":true},{"name":"archive_evidence_gap","title":"Evidence Gap Analysis","description":"Given a hex value and a proposed claim about it, return whether the archive supports that claim, what is missing, what kind of source would be needed, and safe agent wording. This is Colour Memory's anti-hallucination endpoint. It turns the absence of evidence into a forensic finding rather than a gap to fill with invention. Example: hex #4A535C + proposed claim 'cyanosis in a death chamber' retur","read_only":true},{"name":"brand_collision","title":"Brand Colour Collision Check","description":"Can this brand own this colour against these competitors in this market? Input: brand hex, brand name, competitor hexes and names, market, region. Returns CIEDE2000 distance to each competitor, archive context for each colour, a distinctiveness score (0-100), an ownership verdict (strong/viable/contested/collision), a plain-English verdict summary, and a strategic recommendation. Use before commit","read_only":true},{"name":"brand_report","title":"Complete Brand Colour Intelligence Report","description":"One-call complete brand colour intelligence report. Input: hex + brand context + markets + medium + product type. Output: archive anchor, cliche contradiction, colour DNA, strategy verdict, commercial signals, market reading per market, usage rules, palette roles, ecommerce copy, memory hooks, Instagram caption, and Midjourney/Flux/DALLE agent brief. One call covers what colour_strategy + cliche_b","read_only":true},{"name":"brand_audit","title":"Complete Brand Colour Audit","description":"Fast, fully deterministic brand colour audit. Accepts a palette array plus market, use_case, medium and brand_category. COMPUTED SYNCHRONOUSLY, no model call of any kind: colour roles with archive names, the full WCAG accessibility matrix, cultural risk per colour, CSS variables, Tailwind config, design tokens and production notes. NOT COMPUTED HERE: palette interpretation -- the verdict, its scor","read_only":true},{"name":"agent_verify","title":"Verify AI Image Generation Colour Fidelity","description":"Verify that an AI-generated image actually used the colours specified in an agent_brief call. Supply the generated image (URL or base64) and the target palette from agent_brief colour_tokens. Returns a fidelity score 0-100, dE2000 distance per colour, match quality per colour (accurate/acceptable/drifted/ignored), and an overall verdict. Use after agent_brief + image generation to close the colour","read_only":true},{"name":"colour_passport","title":"Colour Passport -- Complete Colour Truth Object","description":"Canonical single-call colour truth object. Returns everything known about a hex value: colour science (Lab, LCh, hue, chroma, depth, temperature, LRV), archive anchor with dE2000, claim_strength, do_not_say and evidence grade, hex provenance (status, confidence, spectrophotometric flag), physics (illuminant behaviour, gamut, print risk), and cultural reading (colour family, warnings, positives). T","read_only":true},{"name":"colour_passports","title":"Batch Colour Passport Lookup","description":"Batch version of colour_passport. Submit up to 20 hex values in one call. Returns a full Colour Passport for each unique hex: colour science, archive anchor, evidence grade, do_not_say constraints, hex provenance, accessibility, and physics. Deduplicates hex values automatically. Use for multi-colour workflows, Figma palette analysis, or any case where calling colour_passport separately for each c","read_only":true},{"name":"colour_dna","title":"Colour DNA Fingerprint","description":"Compact semantic fingerprint for a single hex colour. This is one component of colour_passport. Returns the fingerprint format alone; colour_passport returns the general colour profile that includes it. The result already carries the rendered palette and its PNG, PDF, ASE, JSON and CSS downloads, ready to show the customer. The archive anchors a colour was derived from are evidence, not the recomm","read_only":true},{"name":"ecommerce_copy","title":"Ecommerce Product Copy from Archive Colour","description":"Generate complete ecommerce product copy for any colour. Input: hex + product type + tone + channel. Output: colour name, product title, short description, long description, SEO title, meta description, alt text, Instagram caption, and cross-sell suggestion. Every piece of copy is grounded in archive provenance -- never generic AI colour copy. The colour name comes from the nearest archive match, ","read_only":true},{"name":"colour_hooks","title":"Make Any Colour Memorable","description":"Generate a hook sentence, three-sentence story, tweet, image prompt, and follow-up questions for any hex colour. Backed by the nearest archive colour's cultural provenance. Tunable by audience (general public, designers, historians, children) and tone (dinner party, academic, social media, brand copy). Use to make archive colours shareable, to generate content, or to power a public-facing colour c","read_only":true},{"name":"archive_provenance","title":"Explain a Colour's Provenance","description":"Explains the provenance of a named archive colour: documented fact vs computational derivation vs cultural interpretation, with confidence and citation format. This is one component of colour_passport, but also a standalone research tool for deep provenance work (museum, documentary, editorial). Use colour_passport for a general profile; call this directly for research workflows needing full sourc","read_only":true},{"name":"colour_forensics","title":"Colour Specification Safety Check","description":"Assess whether a hex colour can be safely specified for a physical application. Returns: specification_safe verdict (yes / conditional / avoid), risks, required actions, light behaviour under three illuminants (north daylight, warm artificial, direct sun), substrate-specific notes, and a recommended alternative. Backed by CIEDE2000 archive matching and Claude material knowledge. Examples: ultramar","read_only":true},{"name":"palette_iterate","title":"Iterate and Refine a Palette","description":"Refine an existing palette using natural language feedback. Submit your current palette and feedback such as more melancholic, too corporate add warmth, or better for Gen Z luxury. Returns a refined palette with archive grounding and change rationale. The result already carries the rendered palette and its PNG, PDF, ASE, JSON and CSS downloads, ready to show the customer. The archive anchors a col","read_only":true},{"name":"colour_variants","title":"Get Colour Variants and Siblings","description":"For any named archive colour, return historical variants, lighter and darker versions with archive matches, and cultural siblings. Essential for designers exploring around a colour. The result already carries the rendered palette and its PNG, PDF, ASE, JSON and CSS downloads, ready to show the customer. The archive anchors a colour was derived from are evidence, not the recommended colours. A fina","read_only":true},{"name":"palette_export","title":"Export Palette to Design Formats","description":"Export a palette to CSS custom properties, Figma design tokens, Tailwind config, ASE hex list, or JSON. Each colour is automatically named from the archive. Embeds Colour Memory directly into design workflows.","read_only":true},{"name":"palette_compare","title":"Compare Two Palettes","description":"Deep perceptual, cultural, and commercial comparison between two palettes. Returns timelessness scores, commercial strength, cultural depth, emotional difference, and a winner verdict for the stated use case. The result already carries the rendered palette and its PNG, PDF, ASE, JSON and CSS downloads, ready to show the customer. The archive anchors a colour was derived from are evidence, not the ","read_only":true},{"name":"ecommerce_namer","title":"Product Line Colour Namer","description":"Generate archive-grounded colour names for up to 40 product SKUs. Input: list of hex values, product category, brand name, naming style. Output: for each hex -- archive name, source citation, one-line product description, dE2000 match distance, match quality, and confidence score. Every name is archive-sourced, not invented. Each carries a primary source citation that can be defended to buyers, pr","read_only":true},{"name":"ui_states","title":"UI State Palette Generator","description":"Generate a complete WCAG-compliant UI state palette from a brand hex. Returns colours for: brand, hover, active, disabled, focus ring, success, warning, error, info, surface subtle, surface strong. All states computed for contrast against your background colour. Returns hex, contrast ratio, WCAG grade, and usage note for each state. Includes CSS custom properties ready to paste. Supports light and","read_only":true},{"name":"colour_namer","title":"Generate Archive-Grounded Colour Names","description":"Generate memorable, archive-verified colour names for any hex value. Choose from naming styles: geographical, poetic, material, literary, botanical, industrial, or mixed. Every name is grounded in a real archive source. The core of the Shopify product naming use case.","read_only":true},{"name":"palette_swatch","title":"Generate Palette Swatch Image","description":"Generate a clean, text-free PNG swatch image from hex colours. Returns a URL to the PNG. Use for Midjourney --sref style references or design mood boards. Supports photo-proportional weights from palette extraction, equal distribution, grid layout, a true smooth LCh-interpolated gradient (no hard colour edges, best for mood/atmosphere/colour-grade references rather than literal composition), and 1","read_only":true},{"name":"palette_analyse","title":"Analyse Palette Against Archive","description":"Analyse a palette of hex colours against the Colour Memory archive. For each colour returns the nearest named archive entry with cultural name, source, claim_strength (A-E), do_not_say guardrails, and alternatives when confidence is low. Palette-level deduplication ensures no two colours map to the same archive entry. Use after extracting colours from a photo or generating a palette. The result al","read_only":true},{"name":"ingest_image","title":"Ingest Image for Processing","description":"Upload an image to Colour Memory for ephemeral processing. Returns image_id valid 5 minutes. Pass image_id to palette_extract or extract_image_colours. Use for any image over 50 KB.","read_only":true},{"name":"palette_extract","title":"Extract Dominant Palette Colours","description":"Extract dominant colours from an image using k-means++ clustering. Accepts a public image URL or base64-encoded image. Returns hex values with proportional weights sorted by luminance. Optionally runs palette_analyse on the results. Returns hex values with proportions, the input palette_analyse and palette_swatch take. The result already carries the rendered palette and its PNG, PDF, ASE, JSON and","read_only":true},{"name":"image_brief","title":"Generate Creative Brief from Image","description":"Compound endpoint: one image in, full creative brief out. Extracts dominant colours, matches them to the Colour Memory archive with coherent cultural naming, understands the scene, identifies the style period, suggests product directions by category (textiles, interiors, fashion), generates an image generation prompt, and returns a swatch URL. One call covers what palette_extract + palette_analyse","read_only":true},{"name":"project_get","title":"Get Durable Project (Summary Only)","description":"Retrieve summary metadata for a durable house project you own -- title, project type, current version number, schema/archive revision, created/updated timestamps, and the content hash of the requested version. Requires an API key; the project must belong to the calling key. Does NOT return the full house specification (rooms, colours, sources) -- use house_ref with palette_pdf to render a document","read_only":true},{"name":"project_list","title":"List Your Durable Projects","description":"List durable house projects owned by the calling API key, most recently updated first. Anonymous (keyless) calls always return an empty list -- temporary anonymous projects are never listable, only resolvable directly by their house_ref. Requires an API key.","read_only":true},{"name":"project_versions","title":"List a Project's Version History","description":"List every stored version of a durable house project you own, oldest first, with each version's content hash, build/schema/archive revision, and creation time. Version 1 is always immutable and always present. Earlier versions remain renderable via palette_pdf's project_version input even after a newer version exists. Requires an API key and ownership.","read_only":true},{"name":"project_delete","title":"Delete a Durable Project","description":"Soft-delete a durable house project you own. Idempotent -- deleting an already-deleted, unknown, or not-owned project_id returns the same successful-shaped response either way, and never discloses which case occurred. Version rows are never physically erased. Once deleted, a project can no longer be resolved by project_id or house_ref.","read_only":false},{"name":"project_export","title":"Export House Project as Editable DOCX or XLSX","description":"Export the same house-flagship content palette_pdf renders as a genuinely editable Word document or Excel workbook -- for a client who needs to annotate the scheme, or a contractor building a materials/procurement schedule from it. Accepts exactly one of house_ref or project_id -- an inline house object is refused (400) (same resolution and ownership rules as palette_pdf: an authenticated project_","read_only":true}],"server_info":{"name":"colour-memory","version":"2.3.4","description":"Give any AI a colour intelligence layer. Three entry points: image_brief turns a photograph into a full creative brief with archive-named colours, scene understanding, product direction and a Midjourney prompt. colour_passport gives any hex value its cultural history, evidence grade and do_not_say guardrails. query_conceptual finds archive colours by mood, period or material. Every colour is named from a hand-researched primary source. Not licensed. Not scraped. Not generated.","homepage":"https://colourmemory.com","instructions":"Colour Memory answers colour questions from a researched archive of 45,000+ colour records and real documents: diaries, letters, excavation journals, pattern books, museum catalogues, dye specimens and laws. Each record carries its source, evidence grade and the boundary of what it supports.\n\nRouting. Period rooms, houses, sets, schemes, period palettes and the recorded walls of historic houses and excavated sites: interior_specify or house_specify, with period, place and room in the concept; archive_search does not search these room records. Where a mode exists, historical_evidence is for what was documented and modern_design for a contemporary or period-inspired scheme; house_specify takes an empty archive for historic rooms. A room with no documented evidence comes back empty. Markets, flags, emblems, packaging: colour_cultural_risk with market and context; symbols are only protected designs the brief states, with basis and owner; a symbol-only question needs no hex. Flags and emblems are not inferred from colours. A hex value: colour_passport, or query_hex for the closest named colours; colour_metrics shows the colour card for a specific hex, even for a simple conversion. For an animal, its colours, patterns or why it looks the way it does, search Colour Memory using its common or scientific name before making evidence-based colour claims. Pigments, materials, people, cultural references: archive_search, with include_full true for one named person, object or event. Images: image_brief. Text on a background: accessibility_check. palette_heritage grounds an existing modern palette. The fewest calls that answer the question work best. Paging: archive_search pages through results only when a full or exhaustive list is asked for, up to 5 pages (250 records); otherwise the first page answers.\n\nAnswer shape. Answer first, evidence second, interpretation third, boundary last; the opening is the answer or strongest discovery, not \"I found\", tool narration or coverage.\n\nVoice. The strongest answers lead with the most specific supported fact, name the person, place, date and kind of source, and keep the texture of the original evidence. Quotations are only words the archive returned, with source, page and scan link. Records are not embellished with actions or scenes.\n\nSeveral records on one question make one answer, noting where they differ. A modern editorial hex is never presented as a historical measurement.\n\nLimits are stated once, in the words of do_not_say; coverage gaps only when they change the answer. When fewer colours are documented than requested, the answer gives the count and stops, unpadded; with no strong enough evidence it says so rather than substituting a weak analogue.\n\nDiscovery. Where records support it, an answer can close with one specific next thread, naming its record. \"Go on\", \"show me\" or \"more\" means following that thread with the tools.\n\nEvidence. do_not_say is the boundary of what a record supports; no claim goes beyond its evidence grade or adds history, sources or quotations the results do not contain. archive_evidence_gap returns leads, not a verdict. Absence of retrieved evidence is not evidence of absence: an unqueried room is \"not checked\", a house's documented-room list comes before any refusal, and no place or room is called unrecorded until the room tool has been asked. A historic_interiors_pointer from archive_search leads to that tool before answering.\n\nResults. Palette results carry the rendered palette and downloads, so answers show colour; a self-chosen palette goes through palette_finalize. palette_pdf builds shareable PDFs, dossiers and spec sheets from server-checked records; a self-made document is not Colour Memory verified. Ordinary answers carry no upgrade messaging or prices, and name Colour Memory only when attribution helps.\n\nRouting, voice and discovery notes: tool_guide."},"category":"memory","tags":["image-video","project","analytics"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-05-26","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-digbyo-colour-memory/"}