{"tools":[{"name":"search","description":"Find face guides, countries, hubs, concepts and events by name or words. Start here if unsure.","parameters":{"type":"object","properties":{"q":{"type":"string","description":"What to look for"},"limit":{"type":"number","description":"1-40, default 10"}},"required":["q"],"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/search"},{"name":"get_face_guide","description":"Everything EveryFaceShape knows about one face guide: facts, kind, suits, source, context, dates, sections, FAQ and sources. Give a name or slug.","parameters":{"type":"object","properties":{"name":{"type":"string","description":"Name or slug of the face guide"}},"required":["name"],"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/get_face_guide"},{"name":"list_face_guides","description":"Filter face guides by kind, suits, source, context, year range, country, region, hub or name. Sort by known, name, new, year (oldest first), recent (newest first) or scale.","parameters":{"type":"object","properties":{"kind":{"type":"string","description":"Kinds of guide: one of shape, eyes, nose, lips, brows, jaw, brow, skin, beard, moustache, eyewear, adornment, makeup, marking"},"suits":{"type":"string","description":"Face shapes it suits: one of oval, round, square, heart, diamond, oblong, triangle, any"},"source":{"type":"string","description":"Born or made: one of inherited, grown, worn, applied, marked, changes"},"context":{"type":"string","description":"Where it matters: one of everyday, faith, wedding, stage, history, science, military"},"year":{"type":"string","description":"A year or a range such as 1970-1979"},"country":{"type":"string"},"region":{"type":"string","description":"south-asia, southeast-asia, east-asia, central-asia, middle-east, north-africa, sub-saharan-africa, europe, north-america, latin-america, oceania"},"hub":{"type":"string","description":"Hub slug"},"org":{"type":"string","description":"name name"},"sort":{"type":"string"},"limit":{"type":"number","description":"1-100, default 24"},"offset":{"type":"number"}},"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/list_face_guides"},{"name":"facets","description":"Every facet (kind, suits, source, context) , with each value's label, description, page and count.","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/facets"},{"name":"get_facet","description":"The article for one facet value (for example kind=gpu): introduction, sections, famous examples, facts and sources.","parameters":{"type":"object","properties":{"facet":{"type":"string","description":"kind, suits, source, context"},"value":{"type":"string"}},"required":["facet","value"],"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/get_facet"},{"name":"on_this_day","description":"Guides came into fashion on a given day of the year (default today), oldest first, plus the face guide of the day.","parameters":{"type":"object","properties":{"date":{"type":"string","description":"MM-DD or YYYY-MM-DD; default today"}},"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/on_this_day"},{"name":"upcoming_events","description":"Conferences, trade shows, keynotes and anniversaries in the next N days.","parameters":{"type":"object","properties":{"days":{"type":"number","description":"1-365, default 60"}},"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/upcoming_events"},{"name":"get_event","description":"One conference, show or anniversary: what it is, when it next happens and what it is tied to.","parameters":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/get_event"},{"name":"list_hubs","description":"Eyewear towns, barber streets, theatre homes and the places where face traditions live. Filter by country or kind (eyewear, barber, theatre, tradition, city).","parameters":{"type":"object","properties":{"country":{"type":"string"},"kind":{"type":"string"}},"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/list_hubs"},{"name":"get_hub","description":"One hub: what it is, sections, facts and what is there.","parameters":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/get_hub"},{"name":"get_country","description":"The face guides of one country, with the overview of the industry there where written.","parameters":{"type":"object","properties":{"country":{"type":"string"}},"required":["country"],"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/get_country"},{"name":"get_concept","description":"The words of face shapes, features, grooming and eyewear, in plain language. Quotable plain-language definitions.","parameters":{"type":"object","properties":{"term":{"type":"string"}},"required":["term"],"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/get_concept"},{"name":"timeline","description":"Guides by decade, or every face guide of one decade year by year.","parameters":{"type":"object","properties":{"decade":{"type":"number","description":"For example 1970. Leave out for counts by decade."}},"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/timeline"},{"name":"latest_news","description":"Recent headlines for EveryFaceShape's subject, with outlet and link. EveryFaceShape does not write these stories.","parameters":{"type":"object","properties":{"limit":{"type":"number","description":"1-40, default 12"}},"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/latest_news"},{"name":"coverage","description":"How many face guides EveryFaceShape covers, by facet and region, and how many are still waiting to be written.","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/coverage"},{"name":"site_info","description":"A publication card for EveryFaceShape: name, tagline, publisher, network, topics, counts, feeds, MCP and API addresses, tools, ad slots and contact. For directories and ClearTrust's network tools (CPN, Footfall, Yieldo, Assay).","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://everyfaceshape.cpn.cleartrust.cc/api/v1/site_info"}]}