{"tools":[{"name":"search","description":"Search Rang for colours (by name, native name, other spelling, material, theme or hex value), named swatches, countries, cities, emotions, colour days, concepts and glossary terms. Start here when unsure which tool fits.","parameters":{"type":"object","properties":{"query":{"type":"string","description":"For example \"ultramarine\", \"indigo\", \"toxic\", \"#1F4FBF\", \"Jaipur\", \"mourning\", \"Holi\", \"hue\""},"limit":{"type":"number","description":"1-30, default 10"}},"required":["query"],"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/search"},{"name":"get_colour","description":"The full page for one colour, pigment or dye: its hex, RGB, HSL and CMYK values, family, what it is, where its name and material come from, how it is made, where it is used, what it means and to whom, related shades, FAQ and sources. Give a slug from another tool, or a name.","parameters":{"type":"object","properties":{"slug":{"type":"string","description":"Slug such as \"tyrian-purple\""},"name":{"type":"string","description":"A name, used if slug is not given"}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/get_colour"},{"name":"list_colours","description":"List colours, filtered by any mix of family, kind, use, meaning, emotion, faith, source material, country, city and colour day. Sorted best known first unless sort says otherwise. Use offset to page.","parameters":{"type":"object","properties":{"family":{"type":"string","enum":["red","orange","yellow","green","cyan","blue","purple","pink","brown","white","grey","black","gold"]},"kind":{"type":"string","enum":["basic","shade","pigment","dye","natural","traditional","national","heraldic","standard","web"],"description":"basic = Basic colours; shade = Named shades; pigment = Pigments; dye = Dyes; natural = Colours named from nature; traditional = Traditional colours; national = National and team colours; heraldic = Heraldic colours; standard = Standard and safety colours; web = Screen and web colours"},"use":{"type":"string","enum":["art","textile","architecture","ceramics","body","food","print","screen","safety","flags","livery"],"description":"art = Painting and art; textile = Textiles and dress; architecture = Buildings and cities; ceramics = Ceramics and glass; body = Body and cosmetics; food = Food and drink; print = Printing and ink; screen = Screens and design; safety = Signs and safety; flags = Flags and heraldry; livery = Uniforms, teams and vehicles"},"meaning":{"type":"string","enum":["mourning","wedding","luck","royalty","sacred","purity","danger","love","nature","politics","celebration","protection"],"description":"mourning = Mourning and death; wedding = Weddings and marriage; luck = Luck and prosperity; royalty = Royalty and power; sacred = Sacred and holy; purity = Purity and peace; danger = Danger and warning; love = Love and desire; nature = Nature and renewal; politics = Politics and protest; celebration = Festival and celebration; protection = Protection and healing"},"emotion":{"type":"string","enum":["joy","love","anger","sadness","grief","fear","calm","envy","hope","trust","energy","courage","pride","shame","disgust","surprise","loneliness","nostalgia","awe","optimism"]},"faith":{"type":"string","enum":["hindu","muslim","christian","jewish","buddhist","sikh","jain","other"]},"made_from":{"type":"string","enum":["mineral","plant","animal","synthetic","light","varies"]},"material":{"type":"string","description":"A raw material in plain English, e.g. \"lapis lazuli\", \"madder root\""},"country":{"type":"string","description":"ISO code or English name, e.g. \"IN\" or \"Mexico\""},"city":{"type":"string","description":"City slug such as \"tyre-lb\""},"day":{"type":"string","description":"Colour day slug or name from list_colour_days, e.g. \"holi\""},"sort":{"type":"string","enum":["known","name","new","seen"]},"limit":{"type":"number","description":"1-100, default 25"},"offset":{"type":"number"}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/list_colours"},{"name":"name_colour","description":"Given any hex value, the closest named colours (from Rang's pages, Wikipedia's list of colours and the traditional colours of Japan) with their distance in CIE Lab space, plus the value in RGB, HSL and CMYK, its family, harmonies and contrast with black and white text.","parameters":{"type":"object","properties":{"hex":{"type":"string","description":"For example \"#1F4FBF\""},"limit":{"type":"number","description":"1-20, default 8"}},"required":["hex"],"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/name_colour"},{"name":"random_colour","description":"One published colour chosen at random, in full. Good for discovery.","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/random_colour"},{"name":"colour_of_the_day","description":"The colour featured on the Rang home page today.","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/colour_of_the_day"},{"name":"colours_today","description":"Colour days (festivals, national days, remembrances and causes) that are on now or start within the next few days, each with its palette and what the colours mean, plus the colours tied to today's day of the week and the colour of the day. Dates are worked out from each calendar's rule.","parameters":{"type":"object","properties":{"date":{"type":"string","description":"A day as YYYY-MM-DD; default today (UTC)"},"days_ahead":{"type":"number","description":"0-60, default 7"}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/colours_today"},{"name":"get_colour_day","description":"One colour day in full: what is worn, hung, thrown or lit, in which colours and why, who keeps it and where, and when it next falls. Also covers weekly customs such as the Thai colours of the day. Give a slug from list_colour_days, or a name.","parameters":{"type":"object","properties":{"slug":{"type":"string","description":"Slug such as \"holi\""},"name":{"type":"string","description":"A name, used if slug is not given"}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/get_colour_day"},{"name":"list_colour_days","description":"Every colour day in the year ahead, soonest first, with the date each next falls on and its palette, plus weekly customs. Optionally for one faith or one country.","parameters":{"type":"object","properties":{"faith":{"type":"string","enum":["hindu","muslim","christian","jewish","buddhist","sikh","jain","other"]},"country":{"type":"string","description":"ISO code or English name"}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/list_colour_days"},{"name":"colour_meanings","description":"What colours mean, country by country: mourning, wedding, lucky, royal, sacred and political colours, each as a short sourced note. Filter by country, colour family, meaning or emotion; give at least one. Use this for questions such as \"what does white mean in Japan\" or \"which countries mourn in white\".","parameters":{"type":"object","properties":{"country":{"type":"string","description":"ISO code or English name"},"family":{"type":"string","enum":["red","orange","yellow","green","cyan","blue","purple","pink","brown","white","grey","black","gold"]},"meaning":{"type":"string","enum":["mourning","wedding","luck","royalty","sacred","purity","danger","love","nature","politics","celebration","protection"],"description":"mourning = Mourning and death; wedding = Weddings and marriage; luck = Luck and prosperity; royalty = Royalty and power; sacred = Sacred and holy; purity = Purity and peace; danger = Danger and warning; love = Love and desire; nature = Nature and renewal; politics = Politics and protest; celebration = Festival and celebration; protection = Protection and healing"},"emotion":{"type":"string","enum":["joy","love","anger","sadness","grief","fear","calm","envy","hope","trust","energy","courage","pride","shame","disgust","surprise","loneliness","nostalgia","awe","optimism"]},"limit":{"type":"number","description":"1-200, default 60"}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/colour_meanings"},{"name":"compare_countries","description":"What each colour family means in one country beside another, family by family.","parameters":{"type":"object","properties":{"a":{"type":"string","description":"First country: ISO code or English name"},"b":{"type":"string","description":"Second country"}},"required":["a","b"],"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/compare_countries"},{"name":"get_country_colours","description":"One country in colour: its national colours and flag colours with what each stands for, what every colour means there, the colours tied to it, its colour cities and its colour days.","parameters":{"type":"object","properties":{"country":{"type":"string","description":"ISO code or English name, e.g. \"JP\" or \"Ethiopia\""}},"required":["country"],"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/get_country_colours"},{"name":"list_countries","description":"Every country with how many meanings are recorded for it, how many colours are tied to it and whether its national palette is written.","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/list_countries"},{"name":"list_colour_cities","description":"Cities and regions known for a colour (the Blue City, the Pink City and so on), with the colour, its value and one line on why. Optionally for one country or one colour family.","parameters":{"type":"object","properties":{"country":{"type":"string","description":"ISO code or English name"},"family":{"type":"string","enum":["red","orange","yellow","green","cyan","blue","purple","pink","brown","white","grey","black","gold"]}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/list_colour_cities"},{"name":"get_colour_city","description":"One colour city in full: what is coloured, why, since when, and its palette. Give a slug from list_colour_cities, or a name.","parameters":{"type":"object","properties":{"slug":{"type":"string","description":"Slug such as \"jodhpur-in\""},"name":{"type":"string"}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/get_colour_city"},{"name":"list_emotions","description":"The twenty feelings Rang covers, each with the colour families and swatches most tied to it.","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/list_emotions"},{"name":"get_emotion","description":"One emotion in full: which colours carry it, what studies find and how strong the evidence is, idioms across languages, how it differs from culture to culture, and where it is used. Give a slug from list_emotions, or a name such as \"grief\".","parameters":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/get_emotion"},{"name":"list_concepts","description":"The colour concepts Rang explains: theory, vision, psychology, language, pigments and dyes, systems and standards, colour in society and using colour.","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/list_concepts"},{"name":"get_concept","description":"One concept in full, in plain language, with sources. Give a slug from list_concepts, or a title.","parameters":{"type":"object","properties":{"slug":{"type":"string","description":"Slug such as \"complementary-colours\""},"name":{"type":"string"}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/get_concept"},{"name":"define_term","description":"A plain-language definition of a word used about colour (hue, chroma, mordant, gamut, metamerism, tincture, rangoli...).","parameters":{"type":"object","properties":{"term":{"type":"string"}},"required":["term"],"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/define_term"},{"name":"list_swatches","description":"Named colour values from the swatch book: Wikipedia's list of named colours, the traditional colours of Japan, CSS colour names and more. Filter by set or family.","parameters":{"type":"object","properties":{"set":{"type":"string","description":"Set key from a previous call, e.g. \"named\", \"japan\", \"css\""},"family":{"type":"string","enum":["red","orange","yellow","green","cyan","blue","purple","pink","brown","white","grey","black","gold"]},"limit":{"type":"number","description":"1-500, default 100"}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/list_swatches"},{"name":"latest_news","description":"Recent headlines about colour, pigments, dyes, design and colour science, with outlet and link. Rang does not write these stories.","parameters":{"type":"object","properties":{"limit":{"type":"number","description":"1-40, default 12"}},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/latest_news"},{"name":"stats","description":"How many colours Rang covers, by family, kind, use and meaning, and how many are still waiting to be written. Use this to judge completeness.","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/stats"},{"name":"site_info","description":"A publication card for Rang: name, tagline, publisher, network, topics, catalogue counts, feeds, MCP and API addresses, ad slots and contact. For directories and for ClearTrust's network tools (CPN, Footfall, Yieldo, Assay).","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://rang.cleartrust.cc/api/v1/site_info"}]}