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 withnpx 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 claudeRestart Claude Code and approve the fragiola server: /mcp shows its status.
Or configure it by hand in .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.
| Tool | Answers |
|---|---|
| get_fragiola_overview | What Fragiola is, its two kinds of components and every project. Where an agent starts. |
| list_projects | Every project, its kind, its packages and how to install it. |
| list_components | Fragiola UI's components and the libraries' API entries, filtered by kind, project or group. |
| search_fragiola | A fuzzy search over the components and every docs page. |
| get_component | A component or library by name: its install command, dependencies, files, docs and, for Fragiola UI, its source. |
| get_docs | A project's pages, or one page as Markdown. |
| get_api | A library's API reference: primitives, model, commands. |
| get_install_command | The 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.
- /llms.txt: the entry point, with every docs page linked as Markdown.
- /agents/index.json: every project, its kind, packages, pages, examples and components.
- /agents/overview.md: the ecosystem, written for agents.
Troubleshooting
If the server does not answer
- Run
npx fragiola@latest mcpin 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.