Livewire Flux MCP server

Livewire Flux MCP

An MCP (Model Context Protocol) server that provides access to Livewire Flux Components and Layouts from Livewire Flux. This server allows AI assistants to fetch and search through Flux component and layout documentation on demand.

⚠️ Disclaimer

This is a personal project and is not affiliated with Livewire Flux.

What it does

This MCP server scrapes and provides structured access to the Livewire Flux documentation, enabling AI assistants to:

• Fetch documentation for specific Flux components from https://fluxui.dev/components/
• Fetch documentation for specific Flux layouts from https://fluxui.dev/layouts/
• Access component and layout reference sections with API details, props, and usage patterns
• Search through component and layout documentation content
• List all available Flux components
• Browse and search all available Heroicons for use with flux:icon component
• Access up-to-date documentation directly from the official Flux website
• High-performance caching with 24-hour expiration for optimal response times

Why not just Laravel Boost?

Boost already indexes Flux through its search-docs tool, and for a lot of questions that is enough. Two things it does not do:

question can come back as a several-thousand-token dump (laravel/boost#290). This server fetches the one component page you asked for, plus its reference section.

• Scoped answers. search-docs is a semantic search over a 17k-document corpus, so a broad Flux

list and does not tell your agent which components need a paid Flux license. This server reads the tier live and flags it, so your agent stops writing markup you cannot ship.

• Pro-tier awareness. Boost's bundled fluxui-development skill carries a hardcoded component

If you are on Boost, npx livewire-flux-mcp install wires both together — see AI Guidelines & Skills. The two are complementary: keep Boost for Laravel, Livewire, Pest and the rest; let this server answer Flux.

Set Up Your Agents

The server runs over stdio and is launched with npx, so there is nothing to install globally. Every agent stores that differently — pick yours below.

Cursor

One-click install:

Add flux-docs to Cursor

Or add it by hand to .cursor/mcp.json (this project) or ~/.cursor/mcp.json (every project):

{
    "mcpServers": {
        "flux-docs": {
            "command": "npx",
            "args": ["-y", "livewire-flux-mcp"]
        }
    }
}

Cursor has no cursor mcp add command — the deeplink and the config file are the two supported routes.

Claude Code

claude mcp add --transport stdio --scope project flux-docs -- npx -y livewire-flux-mcp

Everything after -- is passed to the server verbatim. --scope project writes .mcp.json in the project root so the whole team gets it:

Shortened. The full README is on GitHub.