Open Components is an MCP server published by com.uxfront, hosted at mcp.opencomponents.dev. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 6 tools, including get-contract, get-page, get-reference-implementation, list-components, list-rules.
Guidelines for UI components with a perfect UX, DX and AX, whether humans or AI agents write them.
2 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Returns the contract of a component or a foundation, as YAML: its API (props, slots and events), its DOM contract (element, role, states, keyboard and parts), its tokens, and every rule in its checklist, each with a stable ID (like button/keep-focus), a level (must or should), a scope (component, usage or both) and how to check it. It holds every requirement in a fraction of the page's length, and it's the same file as https://opencomponents.dev/raw/docs/<path>.yaml. WHEN TO USE: first, before you build, review or explain a component or its tokens. WHEN NOT TO USE: for some of the rules only (by scope, layer, level or check), use list-rules. For the reasoning or the examples behind a rule, use get-page with its sections.
| Parameter | Type | Description |
|---|---|---|
| component * | string | The component or foundation, like button or design-tokens. |
{
"name": "get-contract",
"title": "Get Contract",
"description": "Returns the contract of a component or a foundation, as YAML: its API (props, slots and events), its DOM contract (element, role, states, keyboard and parts), its tokens, and every rule in its checklist, each with a stable ID (like button/keep-focus), a level (must or should), a scope (component, usage or both) and how to check it. It holds every requirement in a fraction of the page's length, and it's the same file as https://opencomponents.dev/raw/docs/<path>.yaml.\n\nWHEN TO USE: first, before you build, review or explain a component or its tokens.\nWHEN NOT TO USE: for some of the rules only (by scope, layer, level or check), use list-rules. For the reasoning or the examples behind a rule, use get-page with its sections.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"component"
],
"properties": {
"component": {
"enum": [
"design-tokens",
"button",
"card",
"checkbox-group",
"checkbox",
"combobox",
"dialog",
"field",
"input",
"popover",
"radio-group",
"select",
"spinner",
"switch",
"tag-group",
"tag",
"textarea",
"tooltip"
],
"type": "string",
"description": "The component or foundation, like button or design-tokens."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Reads a docs page as markdown, whole or just the sections you name. Component pages explain why each rule exists, with examples in React, Vue, Svelte, Angular, Solid, Astro and Vanilla: pass a framework to keep only its examples. WHEN TO USE: for the reasoning, an example or the details behind a rule (like the sections ["Loading"] of the button's page), or for a page without a contract, like the introduction or the roadmap. WHEN NOT TO USE: for the requirements alone, use get-contract or list-rules, which are much shorter. To find which page or section covers a topic, use search-docs. A page longer than about 8,000 tokens, like the button's, returns its outline instead: every heading with its anchor and length, so you can ask for the sections you need. So do sections that are too long to return together.
| Parameter | Type | Description |
|---|---|---|
| path * | string | The page: its name (introduction, roadmap, mcp-server, agent-plugin, design-tokens, button, card, checkbox-group, checkbox, combobox, dialog, field, components, input, popover, radio-group, select, spinner, switch, tag-group, tag, textarea, tooltip, button-checklist, card-checklist, checkbox-checkli… |
| sections | array | The sections to read, by heading or anchor, like ["Loading"] or ["#ux-rules"]. Each comes with its sub-sections. Name a parent to tell apart headings that repeat, as in "Every state > Loading". |
| framework | string | Your framework, to keep only its examples. |
{
"name": "get-page",
"title": "Get Page",
"description": "Reads a docs page as markdown, whole or just the sections you name. Component pages explain why each rule exists, with examples in React, Vue, Svelte, Angular, Solid, Astro and Vanilla: pass a framework to keep only its examples.\n\nWHEN TO USE: for the reasoning, an example or the details behind a rule (like the sections [\"Loading\"] of the button's page), or for a page without a contract, like the introduction or the roadmap.\nWHEN NOT TO USE: for the requirements alone, use get-contract or list-rules, which are much shorter. To find which page or section covers a topic, use search-docs.\n\nA page longer than about 8,000 tokens, like the button's, returns its outline instead: every heading with its anchor and length, so you can ask for the sections you need. So do sections that are too long to return together.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"maxLength": 300,
"description": "The page: its name (introduction, roadmap, mcp-server, agent-plugin, design-tokens, button, card, checkbox-group, checkbox, combobox, dialog, field, components, input, popover, radio-group, select, spinner, switch, tag-group, tag, textarea, tooltip, button-checklist, card-checklist, checkbox-checklist, checkbox-group-checklist, combobox-checklist, dialog-checklist, field-checklist, input-checklist, popover-checklist, radio-group-checklist, select-checklist, spinner-checklist, switch-checklist, tag-checklist, tag-group-checklist, textarea-checklist, tooltip-checklist), or its path, like /docs/components/button. A URL's #anchor, like the ones search-docs returns, reads that section."
},
"sections": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 20,
"description": "The sections to read, by heading or anchor, like [\"Loading\"] or [\"#ux-rules\"]. Each comes with its sub-sections. Name a parent to tell apart headings that repeat, as in \"Every state > Loading\"."
},
"framework": {
"enum": [
"react",
"vue",
"svelte",
"angular",
"solid",
"astro",
"vanilla"
],
"type": "string",
"description": "Your framework, to keep only its examples."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Returns a shipped component's reference implementation: a Vue 3 component that meets every rule in its checklist, the tests that prove it, the helpers it shares with other components and its theme tokens. The live examples on the site run on this code. WHEN TO USE: to build a component that meets the standard, in Vue or by porting it and its tests to another framework, or to see how a rule is met in code. WHEN NOT TO USE: for the requirements, use get-contract. For how the component is used in another framework, use get-page with that framework.
| Parameter | Type | Description |
|---|---|---|
| files | array | Only these files, like ["Button.vue"] or ["Button.test.ts"]. Leave it out for every file. |
| component * | string | A component with a reference implementation, like button. |
{
"name": "get-reference-implementation",
"title": "Get Reference Implementation",
"description": "Returns a shipped component's reference implementation: a Vue 3 component that meets every rule in its checklist, the tests that prove it, the helpers it shares with other components and its theme tokens. The live examples on the site run on this code.\n\nWHEN TO USE: to build a component that meets the standard, in Vue or by porting it and its tests to another framework, or to see how a rule is met in code.\nWHEN NOT TO USE: for the requirements, use get-contract. For how the component is used in another framework, use get-page with that framework.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"component"
],
"properties": {
"files": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 20,
"description": "Only these files, like [\"Button.vue\"] or [\"Button.test.ts\"]. Leave it out for every file."
},
"component": {
"enum": [
"button",
"card",
"checkbox",
"checkbox-group",
"combobox",
"dialog",
"field",
"input",
"popover",
"radio-group",
"select",
"spinner",
"switch",
"tag",
"tag-group",
"textarea",
"tooltip"
],
"type": "string",
"description": "A component with a reference implementation, like button."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Lists what the Open Components standard covers: the components that have shipped (like Button), the foundations every component follows (like Design Tokens), and the components planned on the Roadmap. WHEN TO USE: to check whether a component has a standard yet, to get the name the other tools take for it, or to see what's planned. WHEN NOT TO USE: if you already know the component, call get-contract directly. To find a topic in the docs, use search-docs. Shipped entries come with their page, their contract and how many rules they have. Planned ones have no page, contract or rules yet: hold them to the three layers and Design Tokens, following the Button's structure, as the build-component prompt does.
| Parameter | Type | Description |
|---|---|---|
| status | string | Which components to list. |
{
"name": "list-components",
"title": "List Components",
"description": "Lists what the Open Components standard covers: the components that have shipped (like Button), the foundations every component follows (like Design Tokens), and the components planned on the Roadmap.\n\nWHEN TO USE: to check whether a component has a standard yet, to get the name the other tools take for it, or to see what's planned.\nWHEN NOT TO USE: if you already know the component, call get-contract directly. To find a topic in the docs, use search-docs.\n\nShipped entries come with their page, their contract and how many rules they have. Planned ones have no page, contract or rules yet: hold them to the three layers and Design Tokens, following the Button's structure, as the build-component prompt does.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"status": {
"enum": [
"shipped",
"planned",
"all"
],
"type": "string",
"default": "all",
"description": "Which components to list."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"total",
"components"
],
"properties": {
"total": {
"type": "number"
},
"components": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"title",
"kind",
"status",
"summary"
],
"properties": {
"key": {
"type": "string",
"description": "The name the other tools take, like button."
},
"url": {
"type": "string"
},
"kind": {
"enum": [
"component",
"foundation"
],
"type": "string"
},
"group": {
"type": "string",
"description": "Its group on the Roadmap."
},
"rules": {
"type": "object",
"required": [
"total",
"must",
"should"
],
"properties": {
"must": {
"type": "number"
},
"total": {
"type": "number"
},
"should": {
"type": "number"
}
},
"additionalProperties": false
},
"title": {
"type": "string"
},
"status": {
"enum": [
"shipped",
"planned"
],
"type": "string"
},
"summary": {
"type": "string"
},
"reference": {
"type": "array",
"items": {
"type": "string"
},
"description": "The files of its reference implementation."
},
"contractUrl": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Lists checklist rules as records, filtered by component, ID, scope, layer, level or check. Each rule has a stable ID to cite in reviews and commits, its level (must or should), its scope, its requirement, how to check it (like a unit test, a review or axe's button-name rule) and a link to it. WHEN TO USE: to review code rule by rule, to get only the rules that apply to a task, to look rules up by ID, or to find the ones a tool can check. Pass scope ["component", "both"] to build or review a component, and ["usage", "both"] to review a screen that uses it. WHEN NOT TO USE: for a component's API, DOM contract and tokens, use get-contract, which has every rule too. It returns up to 50 rules at a time, and total counts every rule that matches. When there are more, pass nextOffset as offset, with the same filters, to get the next page. A component meets the standard when it meets every must rule. Each should rule is expected unless there's a good reason not to follow it.
| Parameter | Type | Description |
|---|---|---|
| ids | array | The IDs of the rules to look up, like ["button/keep-focus"]. |
| check | array | How the rule is checked. |
| layer | array | ui (how it looks), ux (user experience), dx (developer experience) or ax (agentic experience). |
| level | array | |
| limit | integer | How many rules to return, at most. |
| scope | array | Who meets the rule: component (the component itself), usage (the code that uses it) or both. Rules without a scope, like the Design Tokens', match any scope. |
| offset |
Searches the whole standard, every section of every page and every checklist rule, and returns the best matches: where each one is, a short excerpt, and for rules, their ID, level and scope. WHEN TO USE: to find where a topic is covered when you don't know the page or the section, like "focus after delete", "spinner", "aria-pressed" or "dark mode". Then read a section with get-page, or rules with list-rules. WHEN NOT TO USE: to list a component's rules, use list-rules. To see which components there are, use list-components. Search for a few specific words rather than a whole question.
| Parameter | Type | Description |
|---|---|---|
| type | string | Only search sections, or only rules. |
| limit | integer | How many results to return, at most. |
| query * | string | A few words, like "focus after delete" or "aria-pressed". |
| component | string | Only search this page and its rules, like button or design-tokens. |
{
"name": "search-docs",
"title": "Search Docs",
"description": "Searches the whole standard, every section of every page and every checklist rule, and returns the best matches: where each one is, a short excerpt, and for rules, their ID, level and scope.\n\nWHEN TO USE: to find where a topic is covered when you don't know the page or the section, like \"focus after delete\", \"spinner\", \"aria-pressed\" or \"dark mode\". Then read a section with get-page, or rules with list-rules.\nWHEN NOT TO USE: to list a component's rules, use list-rules. To see which components there are, use list-components.\n\nSearch for a few specific words rather than a whole question.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"type": {
"enum": [
"section",
"rule"
],
"type": "string",
"description": "Only search sections, or only rules."
},
"limit": {
"type": "integer",
"default": 8,
"maximum": 20,
"minimum": 1,
"description": "How many results to return, at most."
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "A few words, like \"focus after delete\" or \"aria-pressed\"."
},
"component": {
"enum": [
"introduction",
"roadmap",
"mcp-server",
"agent-plugin",
"design-tokens",
"button",
"card",
"checkbox-group",
"checkbox",
"combobox",
"dialog",
"field",
"components",
"input",
"popover",
"radio-group",
"select",
"spinner",
"switch",
"tag-group",
"tag",
"textarea",
"tooltip",
"button-checklist",
"card-checklist",
"checkbox-checklist",
"checkbox-group-checklist",
"combobox-checklist",
"dialog-checklist",
"field-checklist",
"input-checklist",
"popover-checklist",
"radio-group-checklist",
"select-checklist",
"spinner-checklist",
"switch-checklist",
"tag-checklist",
"tag-group-checklist",
"textarea-checklist",
"tooltip-checklist"
],
"type": "string",
"description": "Only search this page and its rules, like button or design-tokens."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"total",
"results"
],
"properties": {
"query": {
"type": "string"
},
"total": {
"type": "number",
"description": "How many sections and rules match, of which the best come first."
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"title",
"trail",
"path",
"url",
"excerpt"
],
"properties": {
"url": {
"type": "string"
},
"path": {
"type": "string",
"description": "The page, for get-page."
},
"rule": {
"type": "object",
"required": [
"id",
"level"
],
"properties": {
"id": {
"type": "string"
},
"level": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"additionalProperties": false
},
"type": {
"enum": [
"section",
"rule"
],
"type": "string"
},
"title": {
"type": "string",
"description": "The section's heading, or the rule's ID."
},
"trail": {
"type": "string",
"description": "Where it is, page first."
},
"anchor": {
"type": "string",
"description": "The section, for get-page's sections. A rule's is its checklist table: the sections that explain it are results of their own."
},
"excerpt": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Open Components (https://opencomponents.dev) is a standard for UI components. Each component's page covers its UI (how it looks), then holds it to three layers: UX (user experience), DX (developer experience) and AX (agentic experience). Every shipped component, and every foundation like Design Tokens, has a contract: its API, its DOM contract, its states, its tokens and every rule in its checklist. Each rule has a stable ID, like button/keep-focus, a level (must or should) and, for components, a scope: component (met by the component itself), usage (met by the code that uses it) or both. How to use this server: 1. list-components shows what the standard covers, shipped or planned, and the names the other tools take. search-docs finds where a topic is covered. 2. Read the contract first, with get-contract: it holds every requirement in a fraction of the page's length. Read the page with get-page only for the reasoning or the examples behind a rule, a few sections at a time and in your framework, since component pages are too long to read whole. 3. To build a component, read its contract, then get-reference-implementation for a tested Vue 3 implementation and the tests to port. Check your work against the rules with a component or both scope. 4. To review code, use list-rules with the component and a scope: ["component", "both"] for the component itself, ["usage", "both"] for a screen that uses it. Report every rule as pass or fail, with its ID and the evidence from the code. 5. A component meets the standard when it meets every must rule. Each should rule is expected unless there's a good reason not to follow it. 6. Cite rule IDs exactly as this server writes them, and never make one up. 7. Planned components have no page or contract yet. Hold them to the three layers and Design Tokens, following the Button's structure, as the build-component prompt does. The guidelines are licensed under CC BY 4.0, so credit Open Components when you reuse them.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
| integer |
| Where the page starts: 0, or the nextOffset of the page before. |
| automated | boolean | true for the rules tools check all of (unit tests, axe, a type check, a linter or a visual regression test), false for the ones a person checks, at least in part. |
| component | string | The component or foundation, like button or design-tokens. |
{
"name": "list-rules",
"title": "List Rules",
"description": "Lists checklist rules as records, filtered by component, ID, scope, layer, level or check. Each rule has a stable ID to cite in reviews and commits, its level (must or should), its scope, its requirement, how to check it (like a unit test, a review or axe's button-name rule) and a link to it.\n\nWHEN TO USE: to review code rule by rule, to get only the rules that apply to a task, to look rules up by ID, or to find the ones a tool can check. Pass scope [\"component\", \"both\"] to build or review a component, and [\"usage\", \"both\"] to review a screen that uses it.\nWHEN NOT TO USE: for a component's API, DOM contract and tokens, use get-contract, which has every rule too.\n\nIt returns up to 50 rules at a time, and total counts every rule that matches. When there are more, pass nextOffset as offset, with the same filters, to get the next page.\n\nA component meets the standard when it meets every must rule. Each should rule is expected unless there's a good reason not to follow it.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 100,
"description": "The IDs of the rules to look up, like [\"button/keep-focus\"]."
},
"check": {
"type": "array",
"items": {
"enum": [
"axe",
"unit-test",
"type-check",
"lint",
"visual-regression",
"keyboard",
"aria-snapshot",
"screen-reader",
"emulation",
"zoom",
"contrast-checker",
"review"
],
"type": "string"
},
"description": "How the rule is checked."
},
"layer": {
"type": "array",
"items": {
"enum": [
"ui",
"ux",
"dx",
"ax"
],
"type": "string"
},
"description": "ui (how it looks), ux (user experience), dx (developer experience) or ax (agentic experience)."
},
"level": {
"type": "array",
"items": {
"enum": [
"must",
"should"
],
"type": "string"
}
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 50,
"minimum": 1,
"description": "How many rules to return, at most."
},
"scope": {
"type": "array",
"items": {
"enum": [
"component",
"usage",
"both"
],
"type": "string"
},
"description": "Who meets the rule: component (the component itself), usage (the code that uses it) or both. Rules without a scope, like the Design Tokens', match any scope."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Where the page starts: 0, or the nextOffset of the page before."
},
"automated": {
"type": "boolean",
"description": "true for the rules tools check all of (unit tests, axe, a type check, a linter or a visual regression test), false for the ones a person checks, at least in part."
},
"component": {
"enum": [
"design-tokens",
"button",
"card",
"checkbox-group",
"checkbox",
"combobox",
"dialog",
"field",
"input",
"popover",
"radio-group",
"select",
"spinner",
"switch",
"tag-group",
"tag",
"textarea",
"tooltip"
],
"type": "string",
"description": "The component or foundation, like button or design-tokens."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"total",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"component",
"level",
"requirement",
"check",
"checks",
"axe",
"automated",
"url"
],
"properties": {
"id": {
"type": "string"
},
"axe": {
"type": "array",
"items": {
"type": "string"
},
"description": "The axe rules that check it."
},
"url": {
"type": "string"
},
"check": {
"type": "string"
},
"layer": {
"enum": [
"ui",
"ux",
"dx",
"ax"
],
"type": "string"
},
"level": {
"enum": [
"must",
"should"
],
"type": "string"
},
"scope": {
"enum": [
"component",
"usage",
"both"
],
"type": "string"
},
"checks": {
"type": "array",
"items": {
"enum": [
"axe",
"unit-test",
"type-check",
"lint",
"visual-regression",
"keyboard",
"aria-snapshot",
"screen-reader",
"emulation",
"zoom",
"contrast-checker",
"review"
],
"type": "string"
}
},
"automated": {
"type": "boolean",
"description": "Whether tools check all of it."
},
"component": {
"type": "string"
},
"requirement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"total": {
"type": "number",
"description": "How many rules match, on every page."
},
"unknown": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"suggestions"
],
"properties": {
"id": {
"type": "string"
},
"suggestions": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"description": "The IDs asked for that no rule has, with the ones that might have been meant."
},
"nextOffset": {
"type": "number",
"description": "The offset of the next page, when there is one."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}