Tools Reference
Fluent exposes a stable set of MCP tools across both the Hosted and Self-Host tracks. The contract version is 2026-04-05.fluent-core-v1.31. After the freeze point, changes are additive only.
Core 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_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 for the assistant |
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_create_recipe | Add a new recipe |
meals_list_recipes | Browse the recipe library |
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_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 |
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 for the assistant |
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_upsert_item_profile | Write typed descriptors for an item |
style_upsert_item_photos | Attach photos with typed media roles |
style_analyze_purchase | Coverage-aware wardrobe-context purchase analysis |
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.