Connecting To Generic MCP Clients

Use this guide to connect Fluent to any AI app that supports HTTP MCP.

Managed Quick Start

1. Add an HTTP MCP server in your AI app.

2. Use:

   https://mcp.meetfluent.app/mcp

3. Complete OAuth if the client supports it.

4. Ask: "What can Fluent help me with?"

Managed Fluent is currently free.

Self-Hosted Configuration

A typical configuration is:

{
  "mcpServers": {
    "fluent": {
      "type": "http",
      "url": "http://127.0.0.1:8788/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

What Fluent Provides

Compatible MCP clients can use:

• fluent_get_capabilities and fluent_get_account_status
• shared, Meals, and Style context
• saved item, evidence, and media reads
• confirmed changes to Meals information, recipes, meal plans, groceries, budgets, and closet items
• optional visual Grocery List, Budget Setup, and Closet Manager views when supported

Portable Tool Pattern

User asks for	Fluent tool
Meal planning	fluent_get_context(domain="meals", intent="planning")
Saved recipe detail	fluent_get_item after the initial context identifies the item
Save an approved plan	fluent_save_meal_plan
Change the current grocery list	fluent_apply_grocery_list_change
Reconcile a finished shop	fluent_apply_grocery_shopping_result
Closet overview	fluent_get_context(domain="style", intent="closet")
Purchase decision	fluent_get_context(domain="style", intent="purchase", ...)
Saved-item evidence or media	fluent_list_evidence, fluent_get_media_bundle
Narrow budget arithmetic	fluent_get_purchase_context or the budget fact in context

Only save a change after explicit approval, then check that it worked.

Presentation

Complete text is the default. Only use Grocery List, Budgets Envelope Setup, or Style Closet Manager when the client explicitly supports the promoted resource.

Next Steps

• Connect Fluent
• Client Configuration
• Tools Reference
• Run Fluent Yourself