Skip to content

Resources Reference

Fluent exposes MCP resources as fluent:// URIs. These are stable across both Hosted and Self-Host tracks.

Core Resources

ResourcePurpose
fluent://core/capabilitiesContract version, backend mode, domains, onboarding state, profile, and tool discovery hints
fluent://core/profileDisplay name, timezone, and profile metadata
fluent://core/domainsAll domains with lifecycle state

Health Resources

ResourcePurpose
fluent://health/preferencesTraining preferences (experience, equipment, schedule)
fluent://health/contextFull health context for the assistant
fluent://health/todayToday's resolved workout from the active block
fluent://health/active-blockThe current training block
fluent://health/block-projectionCurrent week projected from the active block
fluent://health/review-contextWeekly review state for block adjustments
fluent://health/blocks/{block_id}A specific training block by ID
fluent://health/goalsFitness goals

Meals Resources

ResourcePurpose
fluent://meals/current-planThis week's active meal plan
fluent://meals/inventoryKitchen inventory with quantities and freshness
fluent://meals/preferencesDietary preferences and cooking style
fluent://meals/plans/{week_start}A specific week's meal plan (ISO date key)
fluent://meals/recipes/{recipe_id}A single recipe by ID
fluent://meals/grocery-plan/{week_start}Generated grocery plan for a week
fluent://meals/confirmed-order-sync/{retailer}/{retailer_order_id}Canonical summary for a confirmed retailer order

Style Resources

ResourcePurpose
fluent://style/profileStyle profile, preferences, and calibration state
fluent://style/contextFull style context for the assistant
fluent://style/itemsAll closet items
fluent://style/items/{item_id}A single closet item by ID
fluent://style/item-profiles/{item_id}Typed fit profile for an item
fluent://style/item-provenance/{item_id}Field evidence and source metadata for an item

Resource URI Patterns

Resources with {param} segments are parameterized:

  • fluent://health/blocks/{block_id} -- replace {block_id} with an actual block ID
  • fluent://meals/plans/{week_start} -- replace {week_start} with an ISO date like 2026-04-07
  • fluent://meals/recipes/{recipe_id} -- replace {recipe_id} with an actual recipe ID
  • fluent://style/items/{item_id} -- replace {item_id} with an actual item ID

Stability

All listed resources are frozen as of contract version 2026-04-05.fluent-core-v1.31. New resources may be added (additive), but existing resource URIs, their names, and their payload shapes will not change in a breaking way.

Apache 2.0 Licensed (Self-Host) | Fluent Cloud coming soon