Tools Reference

This page is generated from fluent-mcp/contracts/fluent-contract.v1.json.

Fluent exposes a stable set of MCP tools across early access and the open-source runtime. The current contract version is 2026-05-17.fluent-core-v1.84. Newer changes should be additive.

Everything listed in the current tool sections below is part of the documented public contract. Experimental rich views are omitted until they ship in the public contract and runtime.

Fluent Tools

These tools manage your Fluent profile, domain state, and available capabilities.

Tool	Purpose
fluent_get_capabilities	Discover contract version, backend mode, available/enabled/ready domains, onboarding state, profile summary, and tool discovery hints
fluent_get_account_status	Read early-access account and access state
fluent_get_home	Read the Fluent overview with account status, domain readiness, and cross-domain summary state
fluent_get_next_actions	Read client-aware next-step guidance and routing suggestions
fluent_get_profile	Read your display name, timezone, and profile metadata
fluent_update_profile	Update profile fields
fluent_list_domains	List all domains and their current state
fluent_enable_domain	Enable a domain (moves from available to enabled)
fluent_disable_domain	Disable a domain
fluent_begin_domain_onboarding	Start the onboarding flow for a domain
fluent_complete_domain_onboarding	Mark onboarding as complete
fluent_list_domain_events	Read the audit event log for domain operations

Health Tools

Tool	Purpose
health_get_preferences	Read training preferences
health_update_preferences	Update training preferences
health_get_context	Full health context a connected assistant can use
health_get_today_context	Today's resolved workout and context
health_get_review_context	Weekly review state for block adjustments
health_get_active_block	Read the current training block
health_get_block	Read a specific block by ID
health_get_block_projection	Project the current week from the active block
health_list_goals	List fitness goals
health_upsert_goal	Create or update a fitness goal
health_upsert_block	Create or update a training block
health_record_block_review	Record a weekly block review
health_list_workout_logs	Browse workout history
health_log_workout	Log a completed workout
health_list_body_metrics	Browse body metric history
health_log_body_metric	Record a body metric entry

Meals Tools

Tool	Purpose
meals_list_tools	Eager fallback tool directory with workflow groups
meals_get_plan	Get the current or a specific week's meal plan
meals_list_plan_history	Browse past meal plans
meals_get_day_plan	Single day's meal detail
meals_get_today_context	Today's meals and context
meals_get_recipe	Read a recipe
meals_render_recipe_card	Render a ChatGPT-ready recipe card widget from a recipe
meals_render_pantry_dashboard	Legacy broader-MCP pantry dashboard retained for compatibility; current product flows should prefer Meals setup, inventory reads, and grocery list v2
meals_render_grocery_list_v2	Render the latest rich grocery-list view
meals_create_recipe	Add a new recipe
meals_list_recipes	Browse the recipe library
meals_get_onboarding_calibration	Read the current Meals setup-calibration state
meals_record_calibration_response	Save a Meals setup-calibration response
meals_get_recipe_book	Read the Meals recipe-book onboarding view with shelves, recipe cards, catalog gaps, and safe recipe-specific actions
meals_apply_recipe_book_action	Save an explicit recipe-book action like want to try, favorite, not for us, or pin to week
meals_get_preferences	Read dietary preferences
meals_update_preferences	Update dietary preferences
meals_upsert_plan	Directly create or update a meal plan
meals_generate_plan	Generate a candidate meal plan
meals_accept_plan_candidate	Accept a generated plan as a fresh weekly plan while preserving prior same-week plan history
meals_get_inventory	Full kitchen inventory
meals_get_inventory_summary	Inventory overview
meals_get_meal_memory	Aggregated meal memory and feedback context
meals_list_feedback	Browse feedback history
meals_generate_grocery_plan	Build or regenerate a shopping list for a plan while preserving previous generation context
meals_get_current_grocery_list	Read the current living grocery list
meals_get_grocery_plan	Read the grocery plan
meals_prepare_order	Reconcile inventory into order-ready list
meals_patch_recipe	Update an existing recipe
meals_log_feedback	Rate and comment on a meal
meals_mark_meal_cooked	Mark a planned meal as cooked
meals_update_inventory	Add or update inventory items
meals_delete_inventory_item	Permanently remove a stale inventory item
meals_update_inventory_batch	Bulk inventory updates
meals_record_plan_review	Record a weekly plan review
meals_list_grocery_plan_actions	Read grocery plan action state
meals_upsert_grocery_plan_action	Write pantry confirmations or purchase records
meals_delete_grocery_plan_action	Legacy broader-MCP undo action for a grocery-plan item; excluded from the ChatGPT product path, where reset-style intent should start a new meal/grocery plan
meals_list_grocery_intents	Read grocery intents
meals_upsert_grocery_intent	Write a grocery intent
meals_delete_grocery_intent	Legacy/admin cleanup for a grocery intent; reset-style product flows should start a new meal/grocery plan instead of deleting plan state
meals_apply_pantry_dashboard_action	Apply a legacy pantry-dashboard action back into canonical meals state when explicitly using the compatibility surface

Style Tools

Tool	Purpose
style_get_profile	Read style profile and calibration state
style_update_profile	Update style preferences and body context
style_get_context	Full style context a connected assistant can use
style_get_onboarding_calibration	Read the current Style setup-calibration state
style_record_calibration_response	Save a Style setup-calibration response
style_add_starter_closet_item	Add an anchor item during first-time Style setup
style_list_descriptor_backlog	Items prioritized for descriptor enrichment
style_list_evidence_gaps	Items missing photos or descriptors
style_analyze_wardrobe	Wardrobe gaps, replacements, buy-next guidance
style_list_items	List closet items with filters
style_get_item	Read a single closet item
style_get_item_profile	Typed fit profile for an item
style_get_item_provenance	Field evidence and source metadata
style_upsert_item	Add or update a closet item
style_archive_item	Archive a closet item without deleting its history
style_upsert_item_profile	Write typed descriptors for an item
style_upsert_item_photos	Attach photos with typed media roles
style_set_item_product_image	Set or replace the product image for an item
style_get_purchase_vision_packet	Retrieve the prepared visual packet for purchase-analysis review
style_submit_purchase_visual_observations	Submit structured visual observations back into purchase-analysis state
style_extract_purchase_page_evidence	Extract purchase-page evidence for a style item or candidate
style_prepare_purchase_analysis	Prepare the client-aware purchase-analysis payload before final analysis or rendering
style_analyze_purchase	Coverage-aware wardrobe-context purchase analysis
style_render_purchase_analysis	Return non-widget structured purchase-analysis output
style_show_setup_calibration_widget	Show the Style setup-calibration widget in supported clients
style_show_purchase_analysis_widget	Show the purchase-analysis widget in clients that support it
style_apply_purchase_analysis_action	Apply a rendered purchase-analysis action back into canonical style state
style_get_visual_bundle	Retrieve images for visual grounding

Tool Discovery

The fluent_get_capabilities response includes a toolDiscovery section with:

• canonicalRegistry -- the authoritative source (tools/list)
• note -- human-readable guidance
• groups -- workflow-oriented tool groupings (e.g., meals_planning, meals_shopping, health_fitness, style)

These hints help assistants choose the right starting tool for a workflow. The MCP tools/list endpoint remains the authoritative full registry.

If fluent_get_capabilities is deferred or keyword search misses it, meals_list_tools serves as an eager fallback directory with full tool names and workflow groups.

Rich View Support By Client

Current render tool	Client class	Availability	Preferred fallback
meals_render_recipe_card	ChatGPT and widget-capable clients	Current ChatGPT path and broader widget-capable clients	meals_get_recipe
meals_render_pantry_dashboard	Legacy widget-capable clients	Broader compatibility clients only; not the current ChatGPT product path	meals_get_inventory_summary plus meals_get_inventory when detail is needed
meals_render_grocery_list_v2	ChatGPT and widget-capable clients	Current ChatGPT path and broader widget-capable clients	meals_get_grocery_plan
style_show_setup_calibration_widget	Widget-capable clients	Broader widget-capable clients	style_get_onboarding_calibration plus style_record_calibration_response and style_add_starter_closet_item
style_show_purchase_analysis_widget	ChatGPT and widget-capable clients	Current ChatGPT path and broader widget-capable clients	style_prepare_purchase_analysis plus style_render_purchase_analysis

Claude should prefer canonical data tools plus Claude-native visual equivalents instead of defaulting to ChatGPT-style render tools. Codex, OpenClaw, and generic MCP clients should use canonical tools and text fallbacks unless the client explicitly supports widgets.

Experimental Rich Views

These items are intentionally not current contract tools:

View	Area	Status	Note
meals_render_week_plan	Meals rich week planning	Experimental	Not in the documented public contract.
health_render_training_week	Health rich training-week view	Experimental	Not in the documented public contract.
health_update_training_session	Health training-week widget companion action	Experimental	Not in the documented public contract.

Only tools listed in the current sections above are supported today. Experimental rich views should not be described as current until they are included in the public contract and runtime.