MCP Server

flowpack

io.github.flowpackplugin/flowpack
Commerce & Retail Design & Creative Public & reachable MCP 2026-07-28

What this MCP does

Browses Shopify storefront design options, recommends configurations, creates setting-change plans, and diagnoses theme or performance issues.

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'.
Input schema
{'type': 'object', 'required': ['domain'], 'properties': {'page': {'type': 'integer', 'minimum': 1}, 'facet': {'type': 'string'}, 'query': {'type': 'string'}, 'domain': {'enum': ['kits', 'presets', 'palettes', 'seasonal', 'settings', 'decorations', 'effects', 'diagnostics', 'anatomy', 'compatibility'], 'type': 'string'}, 'page_size': {'type': 'integer', 'maximum': 50, 'minimum': 1}}}
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.
Input schema
{'type': 'object', 'properties': {'kit': {'enum': ['button', 'cart', 'badge', 'variant', 'global'], 'type': 'string'}, 'deep': {'type': 'boolean', 'description': 'Run full theme compat sweep (slower)'}, 'symptom': {'type': 'string'}}}
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'.
Input schema
{'type': 'object', 'properties': {'detail': {'enum': ['brief', 'deep'], 'type': 'string'}, 'plan_id': {'type': 'string'}, 'audience': {'enum': ['merchant', 'developer', 'reviewer'], 'type': 'string'}, 'setting_path': {'type': 'string'}}}
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().
Input schema
{'type': 'object', 'required': ['intent'], 'properties': {'intent': {'type': 'string', 'description': 'Natural-language merchant intent'}, 'context': {'type': 'object', 'properties': {'theme': {'type': 'string'}, 'market': {'type': 'string'}, 'season': {'type': 'string'}, 'products': {'type': 'array', 'items': {'type': 'string'}}, 'brand_hint': {'type': 'string'}, 'constraints': {'type': 'array', 'items': {'type': 'string'}}, 'current_settings': {'type': 'object'}}}}}
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.
Input schema
{'type': 'object', 'required': ['scenario'], 'properties': {'context': {'type': 'object'}, 'scenario': {'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'], 'type': 'string'}}}
Added
diagnose
Sept. 17, 2026, 12:41 p.m.
Added
recommend
Sept. 17, 2026, 12:41 p.m.
Added
explain
Sept. 17, 2026, 12:41 p.m.
Added
plan
Sept. 17, 2026, 12:41 p.m.
Added
browse
Sept. 17, 2026, 12:41 p.m.