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. After the freeze point, changes are additive only.
Everything listed in the current tool sections below is part of the documented public contract. Preview or planned surfaces may exist in local probes or design work, but they are not current tools unless they appear in this contract.
Fluent Tools
These tools manage your Fluent profile, domain lifecycle, and capability discovery.
| 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 Home overview with account status, domain readiness, and cross-domain summary state |
fluent_get_next_actions | Read host-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 lifecycle 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 | Render a pantry-first dashboard surface for kitchen state and next actions |
meals_render_grocery_list_v2 | Render the latest rich grocery-list surface |
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_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 and lock a generated plan |
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 a shopping list for a plan |
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 | Remove a grocery plan action |
meals_list_grocery_intents | Read grocery intents |
meals_upsert_grocery_intent | Write a grocery intent |
meals_delete_grocery_intent | Remove a grocery intent |
meals_apply_pantry_dashboard_action | Apply a pantry-dashboard action back into canonical meals state |
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 | Gap lanes, 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 host-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 hosts |
style_show_purchase_analysis_widget | Show the purchase-analysis widget in hosts 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 guidancegroups-- 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.
Current Render Host Classification
| Current render tool | Host class | Availability | Preferred fallback |
|---|---|---|---|
meals_render_recipe_card | ChatGPT and MCP Apps-style widget hosts | Current ChatGPT path and broader MCP widget hosts | meals_get_recipe |
meals_render_pantry_dashboard | MCP Apps-style widget hosts | Broader MCP widget hosts | meals_get_inventory_summary plus meals_get_inventory when detail is needed |
meals_render_grocery_list_v2 | ChatGPT and MCP Apps-style widget hosts | Current ChatGPT path and broader MCP widget hosts | meals_get_grocery_plan |
style_show_setup_calibration_widget | MCP Apps-style widget hosts | Broader MCP widget hosts | style_get_onboarding_calibration plus style_record_calibration_response and style_add_starter_closet_item |
style_show_purchase_analysis_widget | ChatGPT and MCP Apps-style widget hosts | Current ChatGPT path and broader MCP widget hosts | 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 host explicitly proves MCP Apps-style widget support.
Preview Or Planned Rich Surfaces
These items are intentionally not current contract tools:
| Surface | Lane | Status | Note |
|---|---|---|---|
meals_render_week_plan | Meals rich week planning | Preview only | Exists in local probe/design work, but is not in the documented public contract. |
health_render_training_week | Health rich training-week surface | Preview only | Exists in local probe/design work, but is not in the documented public contract. |
health_update_training_session | Health training-week widget companion action | Preview only | Appears as a probe-only action for the training-week mock surface, but is not in the documented public contract. |
Do not publish these preview surfaces as current until they are added to fluent-mcp/contracts/fluent-contract.v1.json, mirrored into the open-source runtime, and registered by the runtime.