browse

Universal catalog reader. Routes by domain ('kits', 'presets', 'palettes', 'seasonal', 'settings', 'decorations', 'effects', 'diagnostics', 'anatomy', 'compatibility') with optional facet filter (e.g., 'button.hover') and free-text query. Returns paged items with id/name/description and metadata-only marker. Use this for ANY merchant question about 'what options are available' or 'show me X'.

Parameters5

domain	string	required
query	string	optional
facet	string	optional
page	integer	optional
page_size	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "enum": [
        "kits",
        "presets",
        "palettes",
        "seasonal",
        "settings",
        "decorations",
        "effects",
        "diagnostics",
        "anatomy",
        "compatibility"
      ]
    },
    "query": {
      "type": "string"
    },
    "facet": {
      "type": "string"
    },
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "domain"
  ]
}

plan

MASTER KEY tool. Analyzes natural-language merchant intent ('make my buttons feel premium', 'wellness brand vibe', 'BFCM aggressive') and returns a structured plan of settings to change across Flowpack's Button + Cart + Badge + Variant + Frosty Pill kits. Handles single tweaks (one hover style) and full overhauls (50+ settings) with the same call. Returns opaque plan_id, change count, preview URL, and reasoning. ALWAYS call preview() before execute().

Parameters2

intent	string	required	Natural-language merchant intent
context	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "intent": {
      "type": "string",
      "description": "Natural-language merchant intent"
    },
    "context": {
      "type": "object",
      "properties": {
        "current_settings": {
          "type": "object"
        },
        "brand_hint": {
          "type": "string"
        },
        "theme": {
          "type": "string"
        },
        "products": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "season": {
          "type": "string"
        },
        "constraints": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "market": {
          "type": "string"
        }
      }
    }
  },
  "required": [
    "intent"
  ]
}

explain

Natural-language explanation of a plan_id (what it does) or setting_path (what one setting controls). Audience: merchant (default), developer, or reviewer. Detail: brief (1-2 sentences) or deep (full context + related settings + a11y notes). Use when merchant asks 'what does this do' or 'why this preset'.

Parameters4

plan_id	string	optional
setting_path	string	optional
audience	string	optional
detail	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string"
    },
    "setting_path": {
      "type": "string"
    },
    "audience": {
      "type": "string",
      "enum": [
        "merchant",
        "developer",
        "reviewer"
      ]
    },
    "detail": {
      "type": "string",
      "enum": [
        "brief",
        "deep"
      ]
    }
  }
}

recommend

Goal-oriented recommendation engine. Scenarios: 'personalized_4_plans' (returns 4 diverse plans — safe / aspirational / seasonal / conversion-tested), 'preset_for_brand', 'color_palette_for_theme', 'touch_target_for_devices', 'motion_density_for_audience', 'seasonal_for_calendar', 'diagnostics_first_check'. Use for proactive suggestions when merchant intent is unclear.

Parameters2

scenario	string	required
context	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "scenario": {
      "type": "string",
      "enum": [
        "preset_for_brand",
        "color_palette_for_theme",
        "touch_target_for_devices",
        "motion_density_for_audience",
        "seasonal_for_calendar",
        "diagnostics_first_check",
        "personalized_4_plans"
      ]
    },
    "context": {
      "type": "object"
    }
  },
  "required": [
    "scenario"
  ]
}

diagnose

Runtime + theme + settings harmony check. Free-text symptom (e.g., 'cart drawer feels slow', 'badges not appearing') OR kit-scoped check. Returns categorized issues (theme_compat / settings_conflict / runtime_error / a11y / performance) with severity and optional fix_plan_id callable via execute(). health_score 0-100.

Parameters3

symptom	string	optional
kit	string	optional
deep	boolean	optional	Run full theme compat sweep (slower)

Raw schema

{
  "type": "object",
  "properties": {
    "symptom": {
      "type": "string"
    },
    "kit": {
      "type": "string",
      "enum": [
        "button",
        "cart",
        "badge",
        "variant",
        "global"
      ]
    },
    "deep": {
      "type": "boolean",
      "description": "Run full theme compat sweep (slower)"
    }
  }
}

io.github.flowpackplugin/flowpack

MCP Server: io.github.flowpackplugin/flowpack

🛠️ Key Features

🚀 Use Cases

browse

plan

explain

recommend

diagnose

Install

Remote endpoint