Lizzy

Get the exact number of matching images per month for a free-text visual term. Use for "how many images of X", "is X appearing more often", or the monthly trend of a look, garment, material or scene such as "burgundy leather jacket". start_month and end_month are YYYY-MM and optional; omit both to cover every indexed month. Counts are raw image counts from FTN's indexed image corpus above a fixed similarity threshold, not a share of all images and not color forecasts. Months with no matches are returned as zero.

get_image_monthly_counts

Prediction values for one of the signed-in user's saved Color Library palettes. The palette id is required; Lizzy applies user ownership and permission checks and returns each palette color's forecast.

get_lizzy_saved_palette_predictions

Get the authoritative top colors for a future Spring or Fall season. The canonical source for "top N colors for Spring/Fall YYYY" questions and for the factual palette and metrics of a future seasonal report or presentation. Results are ranked by merged forecast share at April for Spring or September for Fall, descending, with exactly one result per distinct color; the returned order and signed values are authoritative as delivered. Pantone, Coloro, CSI, and Archroma names for the same color are alternate labels for that single forecast signal, and an alternate label never becomes a different color over time. The internal identifier can be passed to follow-up graph tools. Calls only Lizzy's deterministic FTN data service; no other AI API is involved.

get_lizzy_seasonal_top_colors

List hashtags ranked by momentum or volume with weekly post counts. sort: rising, emerging, top or cooling. Growth compares each hashtag's share of the segment's posts in the last 4 weeks with the 8 before.

get_social_hashtags

List social conversation topics ranked by momentum, size or engagement. sort: rising (fastest-growing share), emerging (new in the last 4 weeks), top (largest share), cooling (shrinking), engagement (median likes vs the segment). kind narrows to aesthetic, product, occasion, lifestyle, promo or other; shop promotions are excluded unless kind is promo. Each topic carries distinctive hashtags, leading regions and its most common Lizzy colors (share and lift vs the segment).

get_social_topics

Get Lizzy's safe business vocabulary, metric meanings, and capability rules. Covers what Lizzy supports, the meaning of category language, and methodology. This returns a versioned deterministic FTN contract derived from Lizzy's domain rules. It contains no SQL instructions, hidden prompt, or model call, and serves as background reference for answers rather than as raw internal configuration to display.

get_lizzy_semantic_guide

Summarize what people are posting about in one segment over the last 12 weeks. Returns the biggest, rising and cooling topics, rising and top hashtags, and (for all regions) post volume per region. Each topic includes a label, description, share of the segment's posts, growth (last 4 weeks vs the 8 before) and a momentum class.

get_social_conversation_overview

List the color categories and subcategories available to a profile, with the category ids that category-specific requests take.

list_lizzy_categories

List valid Lizzy group ids and names, including material and pattern groups where available.

list_lizzy_color_groups

List Lizzy colors, optionally within one group and in a requested color system. Omit color_system_id to use the signed-in user's preference.

list_lizzy_colors

List available Lizzy market segments for color analysis.

list_lizzy_market_segments

Answer a natural-language FTN color question through structured semantics. Present only the requested FTN Client color results: platform name, code, one swatch, dates, and requested metrics. Never add release comparisons, "what is fixed/worse", deployment news, cluster details, alternate swatches, or database-repair suggestions. Internal IDs are for follow-up calls only. For current results, latest_observed_month is the month of every returned metric. mom_pct is percentage change versus the previous month; moy_pct is percentage change versus the same month of the previous year. Use the current result for the answer; do not append a running change log from earlier tool calls or speculate about fields absent from this result. The default entry point for Lizzy color questions. The analysis value selects the question type: current_leaders covers top/current/prominent colors, fast_movers covers rising/momentum colors, color_group_history covers one named family over time, and compare_color_groups covers two to four families over time. months accepts 1-36 and represents the requested period. color_groups is required only for history analyses, and the base-neutrals filter applies only to current analyses. For a specific Pantone name or code, pass pantone with a current analysis and use matched_color. It returns the latest full observed month's exact platform-profile metrics. The server validates every input and calls deterministic FTN services; the prompt is never forwarded to another model.

query_color_intelligence

The canonical conversion whenever a user supplies a hex colour and asks for a Pantone; it replaces estimation, inference, or model knowledge. Returns the single Lizzy canonical match using sRGB-to-D65-CIELAB perceptual distance against the Lizzy Pantone catalog.

resolve_hex_to_lizzy_pantone

Resolve Pantone, Coloro, CSI, Archroma, RGB, hex, or internal color identifiers to exact Lizzy colors. Batch input accepts mixed supported identifiers.

find_lizzy_colors

Search FTN current-trend documents. Returns matching document ids and titles.

search

Measure how much people post about a subject and whether it is growing. Matches the subject against topic labels, descriptions and distinctive hashtags, and against hashtags directly. Returns the matching topics, a combined weekly series (posts and share of the segment) with growth and momentum, and matching hashtags. match is all_words, any_word (looser) or none.

search_social_conversation

Visualize a structured FTN color analysis selected from the user's words. Covers chart, graph, plot, and visualization requests, with the same analysis types: current_leaders, fast_movers, color_group_history, and compare_color_groups. Current analyses render ranked bars; one-group history and multi-group comparisons render time-series lines from exact FTN values. No external AI API is called by this server.

show_color_intelligence_chart

Render observed monthly history for a named FTN color group. Renders graph/chart/plot requests such as "latest 6 month graph for menswear Red group" from a segment, a group name, and a month count. The data comes directly from Lizzy's deterministic color graph service; no external AI API is invoked by the MCP server.

show_color_group_history_chart

Render a weekly line chart of the share of posts about a subject or one topic.

show_social_conversation_chart

Render a line chart of exact monthly image counts for a visual search term. Use for graph/chart/plot requests such as "chart burgundy leather jackets by month for 2025". The data comes straight from FTN's exact image-count service; no external AI API is invoked by the MCP server.

show_image_monthly_counts_chart

Render an interactive Lizzy chart of current color leaders or fast movers. Covers requests to show, draw, visualize, plot, or chart current colors. The chart uses the same authenticated FTN API result as Lizzy's current-trends answer. ranking=volume_leaders ranks prominence; ranking=fast_movers ranks platform MoY momentum against the same month last year.

show_current_color_chart