What Is WebMCP? Browser MCP Tools for Design Systems
By Conan McNichollWebMCP is the emerging browser-side counterpart to traditional MCP servers. If you are building AI-enabled product experiences or internal tools in the browser, WebMCP gives you a way to register browser MCP tools for design systems directly on the page.
Fragments uses W3C WebMCP and navigator.modelContext to expose component discovery, inspection, blocks, tokens, and implementation helpers in-process, without a separate server.
What Is WebMCP?
WebMCP is a W3C draft that lets web pages register tools through navigator.modelContext. An AI agent running in or alongside the browser can discover and call those tools against the currently loaded application context.
For design systems, that matters because the browser often already has the exact data and UI state you want the AI to use.
Why Browser MCP Tools Matter for Design Systems
Browser MCP tools reduce the gap between:
- the design system data the app has loaded
- the tools AI can call
- the UI the user is actively working with
In Fragments, this means AI can query compiled component metadata and tokens in the same runtime that renders your app. No extra round-trip to a separate tool server for the supported tool set.
WebMCP vs MCP Server (When to Use Which)
Use MCP Tools when:
- AI runs in an editor (Cursor, Claude Code, VS Code)
- you want server-side tools like browser rendering or a11y audits
Use WebMCP when:
- AI runs in the browser or a browser-connected runtime
- you want low-latency access to tools backed by in-page design system data
Both approaches can coexist. They solve different parts of the AI workflow.
How Fragments Uses W3C WebMCP
Fragments registers a curated set of tools via navigator.modelContext using your compiled fragments.json data. The tool set is focused on workflows that can run against local data in the browser, such as:
- component discovery
- prop/usage inspection
- composition blocks
- token search
- implementation helpers
For the server-side/editor workflow, use the MCP server docs. For the source data that powers both flows, build it with the CLI Reference and inspect it in the components docs.
FAQ
Is WebMCP production-ready for my app?
WebMCP is still an emerging standard, so support depends on the AI/browser environment you target. Fragments includes fallback behavior so your app can still run when WebMCP is unavailable.
Do I still need fragments.json with WebMCP?
Yes. WebMCP registers tools, but those tools still need your compiled design system data.
Can WebMCP replace the Fragments MCP server?
Not completely. WebMCP is best for browser-native workflows. The server-based MCP integration is still the better fit for editor-centric AI workflows and tools that require a local process.
CTA
Use the WebMCP docs to wire browser tool registration, and pair it with MCP Tools if your team also uses editor-based AI assistants.