What is Livewire Flux MCP?
Livewire Flux MCP is a stdio MCP server that fetches Flux UI component and layout documentation live from fluxui.dev for a coding assistant. It marks Pro components, supports Flux v1 and v2, lists Heroicons, and caches results for 24 hours in memory.
This server gives an assistant a way to look up the Flux component library on demand, instead of relying on memory. It fetches the page for one component or layout, with its reference section, straight from the official Flux site.
The README calls it a personal project and says it is not affiliated with Livewire Flux. Documentation is read live from fluxui.dev for version 2 and from v1.fluxui.dev for the older version 1.
What the four tools do
- Fetch the docs for one component or layout, including props and usage patterns from its reference section.
- List all components, filtered to free, pro or all, with each one annotated as Pro or Free.
- List the available layouts, for version 2 only.
- List Heroicons for the flux:icon component, filtered by variant or a search term.
Pro tier awareness and caching
When a fetched component needs a paid Flux license, the response starts with a notice saying so. The Pro list comes from the pricing page, with a fallback built into the server in case that page cannot be reached.
Results are cached in memory for 24 hours, and the cache resets when the server restarts. Icon lookups gain most from this, because one uncached request can make up to four GitHub API calls.
The optional install command for Laravel Boost
Registering the server only tells the agent that the tools exist. Running npx livewire-flux-mcp install also writes guideline and agent files, replacing the Flux skill bundled with Laravel Boost, so Flux lookups go through this server.
Who it is for
Best for
- Laravel developers building Livewire interfaces with Flux who want the agent to read current docs and avoid Pro components they have not licensed.
- Teams that want scoped answers about one component rather than a long search result.
- Readers comparing it with other servers such as Flowbite MCP or Starwind UI MCP.
Not for
- Projects that do not use Flux. The server only knows Flux components, layouts and Heroicons.
- Projects built on another component library. For other libraries, see the shadcn MCP server or Basecoat UI MCP.
Use it with UiChemy
This server helps an agent write correct Flux markup for a Laravel project. UiChemy works in WordPress, where Figma to WordPress converts designs into editable pages and Composer edits them. Click Get Started on uichemy.com.
Connect Livewire Flux MCP: Live Flux UI Docs With Pro Tier Flags to your AI client
claude mcp add --transport stdio --scope project flux-docs -- npx -y livewire-flux-mcpAdd the server
Run the command above. Everything after the double dash goes to the server unchanged, and the project scope writes a
.mcp.jsonfile in the project root that the whole team shares.Approve it once
A project scoped server needs approval the first time you open the project. Use
--scope local, the default, to keep it to yourself, or--scope userfor every project.Other clients
The README gives
codex mcp add flux-docs -- npx -y livewire-flux-mcpfor Codex andgemini mcp add --scope project flux-docs npx -y livewire-flux-mcpfor Gemini CLI. Cursor and Junie use the JSON file.Copilot in VS Code
Create
.vscode/mcp.jsonwith aserverskey and give the entrytypeset to stdio. Needs VS Code 1.102 or newer with GitHub Copilot Chat enabled.Optional guidance files
Run
npx livewire-flux-mcp install, thenphp artisan boost:update. Add--dry-runto preview. On Windows, wrap the server command ascmd /c npx -y livewire-flux-mcp.
Client configuration
{
"mcpServers": {
"flux-docs": {
"command": "npx",
"args": ["-y", "livewire-flux-mcp"]
}
}
}Endpoints and ports
https://fluxui.devSource of component and layout pageshttps://v1.fluxui.devUsed when version is set to v1What you can do with it
- Live Flux docsComponent and layout pages are fetched from the official Flux site when asked.
- Pro tier flagsA notice marks paid components, and the component list can be filtered by tier.
- Two Flux versionsVersion 2 is the default, and version 1 is reachable through the version argument.
- Heroicons lookupSearch icon names by variant and get usage examples for flux:icon.
- Scoped answersOne component page and its reference section come back, not a long search dump.
- 24 hour memory cacheRepeat requests return quickly until the server restarts.
- Boost compatible installerAn optional command writes guideline and agent files for Laravel Boost projects.
- Six client setupsThe README covers Cursor, Codex, Gemini CLI, Copilot, Junie and one more terminal agent.
Tools it exposes
fetch_flux_docs
Fetches docs for a component or layout. Takes component, layout and version. Prepends a notice for Pro components.
list_flux_components
Lists components with their doc paths. Takes version and tier (free, pro or all), and annotates each as Pro or Free.
list_flux_layouts
Lists layouts and their doc paths. Takes version. Version 1 returns a notice that layouts are not available.
list_flux_component_icons
Lists Heroicons for flux:icon. Takes variant (outline, solid, mini or micro) and a search term.
Frequently asked questions
What is Livewire Flux MCP?
It is an MCP server that gives AI assistants on demand access to Livewire Flux component and layout documentation. It reads pages from fluxui.dev, flags Pro components, lists Heroicons, and is a personal project not affiliated with Livewire Flux.
How do I install Livewire Flux MCP?
Nothing is installed globally, because the server runs over stdio and is launched with npx. Add an entry named flux-docs with the command npx and the arguments -y and livewire-flux-mcp, using your client's add command or its JSON config file.
Which AI tools work with Livewire Flux MCP?
The README documents setup for Cursor, Claude Code, Codex, Gemini CLI, GitHub Copilot in VS Code and Junie. Other editors can register it by hand with the command npx and the arguments -y and livewire-flux-mcp.
How does it know which Flux components are Pro?
It reads the list from the Flux pricing page and falls back to a list built into the server if that page is unreachable. A fetched Pro component gets a notice, and the listing tool can filter by free, pro or all.
What does the install command change in my project?
It writes a skill file, guideline files and, when an agent settings directory exists, a subagent file. The skill replaces Boost's bundled one with the same name, existing guidelines are kept, and you run php artisan boost:update afterwards.
Does it support Flux version 1?
Yes. Set version to v1 on the fetch and list tools to read from v1.fluxui.dev. Version 1 has no layouts and no Pro tier, so the layouts tool returns a notice and the tier argument is ignored.
How long are results cached?
Results are cached in memory for 24 hours, and the cache clears when the server restarts. Entries are keyed by component, layout, version, tier and icon variant, which also protects against GitHub API rate limits.
What are alternatives to Livewire Flux MCP?
For other servers, see Flowbite MCP, Basecoat UI MCP or the shadcn MCP server. Livewire Flux MCP is the one aimed at Flux and Laravel Livewire projects, so pick by the component library your project already uses.