Fragiola MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
fragiola
The Fragiola CLI. Its fragiola mcp command is an MCP server
that gives AI agents (Claude Code, Cursor, VS Code, Codex, OpenCode, …) everything
fragiola.com documents: which components exist, their docs, the libraries'
APIs and how to install each.
Fragiola has two kinds of components, and the server always says which one an item is:
kind | what it is | how it is used |
Fragiola UI | components as source code, distributed through the shadcn registry (Base UI + Tailwind v4) |
|
Libraries | headless npm packages: a core |
|
Setup
Run this in your project to configure your AI client:
npx fragiola@latest mcp init --client <client>Without --client, it asks which client to configure, or fails with the list when no one can
answer. It merges into an existing config file and keeps your other servers. Running it again
changes nothing. It never overwrites a file that is not valid JSON.
client |
| what it does |
Claude Code |
| writes |
Cursor |
| writes |
VS Code |
| writes |
OpenCode |
| writes |
Codex |
| prints the block for |
fragiola is not added to your dependencies: every client runs npx fragiola@latest mcp, so
it always uses the latest server.
Manual configuration
Claude Code (.mcp.json) and Cursor (.cursor/mcp.json):
{
"mcpServers": {
"fragiola": { "command": "npx", "args": ["fragiola@latest", "mcp"] }
}
}VS Code (.vscode/mcp.json):
{
"servers": {
"fragiola": { "command": "npx", "args": ["fragiola@latest", "mcp"] }
}
}OpenCode (opencode.json):
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"fragiola": {
"type": "local",
"command": ["npx", "fragiola@latest", "mcp"],
"enabled": true
}
}
}Codex (~/.codex/config.toml):
[mcp_servers.fragiola]
command = "npx"
args = ["fragiola@latest", "mcp"]Example prompts
"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 Dockable's Tab primitive API."
"Build a dashboard with @fragiola/grid-layout and Fragiola UI cards."
Troubleshooting
The server does not respond. Run
npx fragiola@latest mcpin a terminal: it should wait silently for input (press Ctrl+C to stop). Check that Node.js 24 or later is on the client'sPATH, then restart the client."does not serve the Fragiola agent index". The server cannot read
/agents/index.json. CheckFRAGIOLA_URL(unset it to use fragiola.com) and the network."is not valid JSON".
mcp initreads plain JSON only. A config file with comments (JSONC, common in.vscode/mcp.jsonandopencode.json) is left untouched: add the entry by hand from Manual configuration.No tools listed. Make sure the client enabled the
fragiolaserver, and restart it aftermcp init.Outdated answers. Responses are cached for one session: restart the server (or the client).
Related MCP server: io.tseha/tseha
MCP server
npx fragiola@latest mcpIt speaks MCP over stdio. Nothing but the protocol is written to stdout. Logs go to stderr.
Tools
tool | answers |
| what Fragiola is, the two kinds, every project. Start here |
| the projects, their kind, packages and how to install each |
| Fragiola UI components and the libraries' API entries, filtered by kind, project or group, paginated |
| fuzzy search over components and every docs page |
| details of named components or libraries; |
| a project's page list, or one page as Markdown |
| a library's API reference pages |
| the exact commands: the |
The server also sends instructions at initialize, so the agent knows the two kinds before it
calls anything.
Where the content comes from
Every answer comes from fragiola.com's agent index (/agents/index.json, the Markdown pages
under /agents/, and the registry under /r/). It is fetched when a tool needs it and cached for
the session, so new components and pages show up without upgrading the CLI. The format is
docs/agent-index.md.
variable | default | use |
|
| read another site, for example a local build of fragiola.com ( |
Embedding
import { createServer } from "fragiola/mcp";
const server = createServer({ baseUrl: "https://fragiola.com" });createServer returns an McpServer from @modelcontextprotocol/server (v2): connect it to any
transport.
Development
pnpm install
pnpm test # build, then the unit, in-process and stdio tests (no network)
pnpm mcp:inspect # the MCP Inspector on the built serverSee AGENTS.md for the repository's rules.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Find UI components and themes, retrieve code, and generate with hosted 21st AI when enabled.
React + Tailwind UI components and recipes your AI coding tool can search and install.
React + Tailwind UI components and recipes your AI coding tool can search and install.
Serves your design system and coding standards to coding agents, so they stop guessing.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search, understand, and generate code for design system components by syncing and indexing a component library.ISC
- AlicenseNot gradedqualityCmaintenanceEnables coding agents to retrieve accurate design system information, component APIs, design tokens, and coding standards, so they build with real specs rather than guessing.2MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to retrieve React, Svelte, Vue, and React Native component source code, demos, blocks, and metadata for building UIs in AI-powered development workflows.107,183 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables coding agents to search, inspect, and retrieve real UI components from existing component libraries, with ranked results, score explanations, licence and provenance details, and safe installation plans. It also surfaces similar components and higher-level UI patterns so agents can reuse existing interface code instead of generating it from scratch.60 npmMIT