Write Polyxd UI documents, check them, and show them as real screens in any design-system pack.
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Lists the semantic components a Polyxd document can use, with a one-line summary each. Pass "name" for one component's full definition: every prop and its type, which are required, when to use it and when not to, and how it renders.
A component name, e.g. "Choice", for its full definition.
Lists the semantic components a Polyxd document can use, with a one-line summary each. Pass "name" for one component's full definition: every prop and its type, which are required, when to use it and when not to, and how it renders.
| Argument | Type | Description |
|---|---|---|
| name | string | A component name, e.g. "Choice", for its full definition. |
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "A component name, e.g. \"Choice\", for its full definition."
}
}
}Searches the polyxd.com docs, as of this server's version: installing and using the React and Web Components renderers, the spec, the verifier and its CLI, the runtime, the generation server, design systems and packs, Design Directions, analytics events, Studio, the MCP server and the roadmap. Pass "query" for the sections that best match, "page" for one whole page, or nothing for the list of pages. Cite the URLs it returns. For writing a document, use polyxd_guide.
| Argument | Type | Description |
|---|---|---|
| page | string | A page's slug, title or URL, e.g. "quickstart", for the whole page. |
| query | string | A question or topic, e.g. "run the verifier in CI" or "Web Components renderer". |
{
"type": "object",
"properties": {
"page": {
"type": "string",
"description": "A page's slug, title or URL, e.g. \"quickstart\", for the whole page."
},
"query": {
"type": "string",
"description": "A question or topic, e.g. \"run the verifier in CI\" or \"Web Components renderer\"."
}
}
}Returns the instructions for writing a Polyxd UI document: the document shape, the rules for generated screens, bindings, actions, every component with its props, and the patterns. Call this once before writing your first document.
No arguments.
{
"type": "object",
"properties": {}
}Lists the design-system packs polyxd_show can draw a screen in: published design systems (Material 3, Carbon, GOV.UK and others) and original templates. The same document looks native in each.
No arguments.
{
"type": "object",
"properties": {}
}Validates a Polyxd UI document and shows it to the user as an interactive screen, drawn by the Polyxd renderer in the design-system pack you choose (default material3). Shows nothing if the document has errors; fix them first with polyxd_validate. When the user presses an action in the screen, you receive a chat message from the user naming the action and its context; that only tells you their choice, and nothing has been submitted or paid. Packs: material3, antd, bootstrap, carbon, chakra, fluent, govuk, mantine, polaris, primer, radix, shadcn, spectrum, brutalist, civic, editorial, finance, glass, health, mono, neon, pastel, sketch, terminal, wireframe.
| Argument | Type | Description |
|---|---|---|
| data | object | The values the screen shows, bound by {"path": "/pointer"}. Replaces the document's own "data" when given. |
| mode | string | Light or dark. Leave out to follow the host's theme. |
| pack | string | The design-system pack to draw the screen in, by id: material3, antd, bootstrap, carbon, chakra, fluent, govuk, mantine, polaris, primer, radix, shadcn, spectrum, brutalist, civic, editorial, finance, glass, health, mono, neon, pastel, sketch, terminal, wireframe. Names like "Carbon" or "shadcn/ui" work too. Pass it whenever the user names a design system. Default material3. |
| document* | object | A Polyxd UI document: {specVersion, surface, root, components, data?}. polyxd_guide explains the format. |
{
"type": "object",
"required": [
"document"
],
"properties": {
"data": {
"type": "object",
"description": "The values the screen shows, bound by {\"path\": \"/pointer\"}. Replaces the document's own \"data\" when given.",
"additionalProperties": true
},
"mode": {
"enum": [
"light",
"dark"
],
"type": "string",
"description": "Light or dark. Leave out to follow the host's theme."
},
"pack": {
"type": "string",
"description": "The design-system pack to draw the screen in, by id: material3, antd, bootstrap, carbon, chakra, fluent, govuk, mantine, polaris, primer, radix, shadcn, spectrum, brutalist, civic, editorial, finance, glass, health, mono, neon, pastel, sketch, terminal, wireframe. Names like \"Carbon\" or \"shadcn/ui\" work too. Pass it whenever the user names a design system. Default material3."
},
"document": {
"type": "object",
"description": "A Polyxd UI document: {specVersion, surface, root, components, data?}. polyxd_guide explains the format.",
"additionalProperties": true
}
}
}Checks a Polyxd UI document against the spec: the schema, ids and references, bindings against the data, actions, and the rules for generated screens. Returns every issue with its JSON Pointer, the component it is in, and a hint saying what to change. Call it after writing or changing a document, and fix every error before showing it.
| Argument | Type | Description |
|---|---|---|
| data | object | The values the screen shows, bound by {"path": "/pointer"}. Replaces the document's own "data" when given. |
| document* | object | A Polyxd UI document: {specVersion, surface, root, components, data?}. polyxd_guide explains the format. |
{
"type": "object",
"required": [
"document"
],
"properties": {
"data": {
"type": "object",
"description": "The values the screen shows, bound by {\"path\": \"/pointer\"}. Replaces the document's own \"data\" when given.",
"additionalProperties": true
},
"document": {
"type": "object",
"description": "A Polyxd UI document: {specVersion, surface, root, components, data?}. polyxd_guide explains the format.",
"additionalProperties": true
}
}
}Runs the Polyxd verifier's document checks: the spec validator, the pattern the surface declares, readable and distinct labels, one primary action per view, at most six inputs per view, entity-first flows, confirmations, and, when you pass one, a Design Direction's rules and voice. Returns a compact report. Example directions by name: calm-finance, playful-personal.
| Argument | Type | Description |
|---|---|---|
| data | object | The values the screen shows, bound by {"path": "/pointer"}. Replaces the document's own "data" when given. |
| document* | object | A Polyxd UI document: {specVersion, surface, root, components, data?}. polyxd_guide explains the format. |
| registry | object | A capability registry ({capabilities: [...]}) to check the document's actions against. Leave out when there is none. |
| direction | any | A Design Direction to hold the document to: the direction object, or the name of an example direction. |
{
"type": "object",
"required": [
"document"
],
"properties": {
"data": {
"type": "object",
"description": "The values the screen shows, bound by {\"path\": \"/pointer\"}. Replaces the document's own \"data\" when given.",
"additionalProperties": true
},
"document": {
"type": "object",
"description": "A Polyxd UI document: {specVersion, surface, root, components, data?}. polyxd_guide explains the format.",
"additionalProperties": true
},
"registry": {
"type": "object",
"description": "A capability registry ({capabilities: [...]}) to check the document's actions against. Leave out when there is none.",
"additionalProperties": true
},
"direction": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"additionalProperties": true
}
],
"description": "A Design Direction to hold the document to: the direction object, or the name of an example direction."
}
}
}