Fragiola

MCP server

Fragiola for AI agents

An MCP server that gives your coding agent every Fragiola component, docs page and API, and knows which ones are source code to copy and which are npm packages to install.

What the agent learns

Two kinds of components, never mixed up

Fragiola ships components in two ways. The server says which one every item is, and how to use it.

  • Fragiola UI: source code

    Components on Base UI and Tailwind v4, copied into your project with npx shadcn@latest add @fragiola/<name>. The code is yours, styled with six palette roles.
  • Libraries: npm packages

    Headless libraries (Dockable, Data Grid, Grid Layout, DnD, Tree, Splitter): install the adapter for your framework, which brings the core, and import everything from it. Behaviour and accessibility, no CSS.

Quick start

Set it up in your client

Run one command in your project. It writes the client's config, keeps your other servers, and changes nothing on a second run.

npx fragiola@latest mcp init --client claude

Restart Claude Code and approve the fragiola server: /mcp shows its status.

Or configure it by hand in .mcp.json:

.mcp.json
{
  "mcpServers": {
    "fragiola": {
      "command": "npx",
      "args": [
        "fragiola@latest",
        "mcp"
      ]
    }
  }
}

Every client runs npx fragiola@latest mcp, so the server is always the latest one, and nothing is added to your dependencies. It needs Node.js 24 or later.

Tools

What the agent can ask

Every answer is Markdown written for an agent, and names the next tool or command to run.

ToolAnswers
get_fragiola_overviewWhat Fragiola is, its two kinds of components and every project. Where an agent starts.
list_projectsEvery project, its kind, its packages and how to install it.
list_componentsFragiola UI's components and the libraries' API entries, filtered by kind, project or group.
search_fragiolaA fuzzy search over the components and every docs page.
get_componentA component or library by name: its install command, dependencies, files, docs and, for Fragiola UI, its source.
get_docsA project's pages, or one page as Markdown.
get_apiA library's API reference: primitives, model, commands.
get_install_commandThe exact commands: the registry and shadcn add for Fragiola UI, and for a library the npm install of its adapter, one per framework (or only the one asked for).

Try it

Ask your agent

Once the server is running, ask in plain words. The agent picks the tools.

  • “Which Fragiola components exist for forms?”
  • “Add a Fragiola select to this form, styled with the palette roles.”
  • “Which Fragiola library gives me dockable panels, and how do I install it?”
  • “Show me the API of Dockable's Tab primitive.”

Any agent

Without MCP

The server reads files the site publishes for agents. Any agent or tool can read them too.

Troubleshooting

If the server does not answer

  • Run npx fragiola@latest mcp in a terminal. It should wait silently for input. Check that Node.js 24 or later is on the client's PATH, then restart the client.
  • No tools listed: enable the fragiola server in the client, and restart it after mcp init.
  • A config file with comments (JSONC) is never overwritten: add the entry by hand.
  • The source and the issues are on GitHub.