{"report":{"v":1,"package":"@leonio/kern-ux-mcp","version":"2.0.0","ranAt":"2026-11-16T11:37:07.853Z","install":{"ok":true,"integrity":"sha512-Mwr4ugRSu3giBo54UmrL56vM9KgNbQhEMjn+doEJ3QEVjgYR1SCZDPnbot8q+T0Nq50AC/UBtVJm7/WSZRvqqQ==","deps":14,"scripts":[],"bins":["kern-ux-mcp"],"license":"EUPL-1.2","engines":"node >=24.16.0","repository":"https://github.com/leonio/kern-ux-mcp.git","bin":"kern-ux-mcp"},"start":{"ok":true,"ms":296,"serverName":"kern-ux","serverVersion":"2.0.0","protocol":"2025-06-18"},"tools":[{"name":"validate_html","description":"KERN UX: Checks HTML against KERN's accessibility rules (BITV) and returns the issues. html takes the full markup string, not a file path: pass the html value of a get_* result.","params":["html","locale"]},{"name":"get_component_docs","description":"KERN UX: KERN's guidance for one component, from kern-ux.de: summary, when to use it and when not, do's and don'ts, similar components, the WCAG criteria left to the implementation, and the docs page by section; plus notes where our tool differs from KERN. Also covers what KERN documents but doesn't implement (tabs, nav, header, notificationbanner). Valid IDs come from list_components_by_category.","params":["componentId","locale"]},{"name":"get_tokens","description":"KERN UX: Lists the names of KERN's CSS custom properties: colours, spacing and all variables.","params":[]},{"name":"list_icons","description":"KERN UX: Lists every KERN icon name.","params":[]},{"name":"list_components_by_category","description":"KERN UX: Lists every component ID with its title, category and strategy. Call it before get_component_docs or a get_<id> tool when you don't know the ID.","params":["category"]},{"name":"get_utility_reference","description":"KERN UX: Reference for KERN's CSS utility classes: flex, CSS grid, gap, spacing, stack, alignment, and Surface (background colours). KERN has no kern-bg-* classes: backgrounds use CSS custom properties such as --kern-color-background-subtle, listed under category 'surface'.","params":["category","locale"]},{"name":"render_composition","description":"KERN UX: Renders nested content blocks as one layout: sections, grids, cards, disclosures, forms and multi-step forms (formFlow).\n\nEvery block must have a 'kind' discriminator. Valid kinds and their shapes:\n\n  text:       { kind: \"text\", text: \"...\" }\n  html:       { kind: \"html\", html: \"<p>...</p>\" }\n  button:     { kind: \"button\", button: { label: \"OK\", variant: \"primary\" } }\n  badge:      { kind: \"badge\", badge: { type: \"info\", text: \"Neu\" } }\n  field:      { kind: \"field\", field: { type: \"email\", name: \"email\", label: \"E-Mail\", hint?: \"...\", error?: \"...\" } }\n                 type: text|email|tel|url|number|date|password|textarea|select|radio|checkbox; select/radio need options: [{ value, label }].\n  fieldset:   { kind: \"fieldset\", fieldset: { legend: \"...\", legendSize?: \"large\", hint?: \"...\", contentBlocks: [field, ...] } }\n  form:       { kind: \"form\", form: { action?: \"/senden\", errorSummary?: {}, contentBlocks: [fieldset, field, ...], actions?: { submitLabel: \"Absenden\" } } }\n                 errorSummary lists every field inside the form that has an error, linked to the field.\n  card:       { kind: \"card\", card: { header: { title: \"...\" }, body: \"...\", contentBlocks?: [...], footer?: { primaryLabel: \"...\" } } }\n  section:    { kind: \"section\", section: { headingText: \"...\", contentBlocks: [...] } }\n                 Shorthand: paragraphs: [\"text1\", \"text2\"] is also accepted (auto-converted to text blocks).\n  disclosure: { kind: \"disclosure\", disclosure: { triggerLabel: \"...\", contentBlocks: [...] } }; content: \"...\" also works\n  grid:       { kind: \"grid\", grid: { columnsContent: [ [block, block], [block], [block] ] } }\n                 One inner array of blocks per column, up to 12; columns defaults to their number.\n  formFlow:   { kind: \"formFlow\", formFlow: { currentStep: 1, heading?: \"...\", steps: [{ label: \"...\", contentBlocks: [...] }, ...], navigation?: { backLabel, nextLabel, submitLabel } } }\n                 The steps render inside a form; renderAllSteps: true renders every step, the inactive ones hidden.\n  summary:    { kind: \"summary\", summary: { summaries: [{ title: \"...\", items: [{ key: \"...\", value: \"...\" }], editHref?: \"#...\" }] } }\n\nNested blocks (section.contentBlocks, card.contentBlocks, grid.columnsContent[][], disclosure.contentBlocks, fieldset.contentBlocks, form.contentBlocks) use the same kind-based shapes recursively.\nRules: forms don't nest (no form or formFlow inside a form or formFlow); no card directly inside a card; a section needs contentBlocks or paragraphs, a disclosure contentBlocks or content.\nLimits: blocks nest at most 4 levels deep, 60 blocks in all.","params":["locale","strict","contentBlocks"]},{"name":"render_page","description":"KERN UX: Renders a whole page: an optional Kopfzeile, a header with brand and navigation, <main> with an h1 and content blocks (the same kinds as render_composition), and a footer with up to four link columns. document: true returns a complete HTML document that loads the KERN stylesheets.","params":["locale","strict","title","kopfzeile","header","heading","contentBlocks","footer","document"]},{"name":"get_section","description":"KERN UX: HTML for a <section> with a heading, content blocks (text, html, badge or field) and an optional divider. A composition helper of this repo, not a KERN component. For containers inside, use render_composition.","params":["locale","strict","headingText","headingLevel","contentBlocks","paragraphs","paragraphSize","paragraphBold","divider"]},{"name":"get_card_group","description":"KERN UX: HTML for 1 to 6 cards side by side on KERN's CSS Grid utilities (kern-grid kern-grid-cols-1 kern-grid-cols-{n}-md kern-gap-lg), one per row on small screens. Each card: an optional image, header, body text or simple blocks, and footer buttons.","params":["locale","strict","cards","columns","heading"]},{"name":"get_disclosure","description":"KERN UX: HTML for one expandable area: <details>/<summary> with the kern-accordion classes. Required: triggerLabel, and contentBlocks or content. For several items, use get_accordion with mode 'group'.","params":["locale","strict","triggerLabel","contentBlocks","content","contentIsHtml","open"]},{"name":"get_accordion","description":"KERN UX: HTML for accordions, built on <details> and <summary>. mode 'single' (default) takes title and content; mode 'group' takes items, each with title and content. Sending items without content selects group. Several collapsible topics under headings; for a single one, get_disclosure.","params":[]},{"name":"get_alert","description":"KERN UX: HTML for an alert with role=\"alert\": a heading with a decorative status icon, and optional body text, links and a list. Required: title. type info (default), success, warning or danger; danger is the most severe, and there is no separate high-contrast variant.","params":["locale","strict","type","title","body"]},{"name":"get_badge","description":"KERN UX: HTML for a badge: a short, non-interactive status or category label. Required: type (info, success, warning or danger) and text. showIcon: true adds the status icon.","params":["locale","strict","type","text","showIcon"]},{"name":"get_body","description":"KERN UX: HTML for a body text paragraph (kern-body) in three sizes, optionally bold. No muted variant.","params":["text","size","bold","locale","strict"]},{"name":"get_button","description":"KERN UX: HTML for a button. Required: label. variant primary (default), secondary or tertiary; five sizes; an optional icon. labelVisibility 'sr-only' makes an icon-only button that keeps an accessible name. For actions; to navigate to another page, use get_link.","params":["locale","strict","variant","label","size","block","type","disabled","icon","labelVisibility"]},{"name":"get_card","description":"KERN UX: HTML for a card: an optional image, a header (preline, title, subline, optional link), body text or simple blocks, and up to two footer buttons.","params":["locale","strict","size","hug","media","header","body","bodyIsHtml","contentBlocks","footer"]},{"name":"get_checkbox","description":"KERN UX: HTML for checkboxes. mode 'single' (default): one checkbox, e.g. a consent. mode 'list': a fieldset of independent options under a legend. Several independent choices; for exactly one, use get_radio.","params":[]},{"name":"get_descriptionlist","description":"KERN UX: HTML for a description list (dl): term and value pairs as dt and dd, values as plain text. Terms with descriptions; to review form entries, use get_summary.","params":["items","stacked","locale","strict"]},{"name":"get_details","description":"KERN UX: KERN's example HTML for Details, as is. No parameters besides locale and strict. One region of extra info shown on demand; for your own content, get_disclosure.","params":["locale","strict"]},{"name":"get_dialog","description":"KERN UX: HTML for a modal <dialog> with header, body and footer buttons; cancel and close use formmethod=\"dialog\". Required: title, body, confirmLabel, cancelLabel. triggerLabel adds the button that opens it.","params":["locale","strict","id","title","body","bodyIsHtml","confirmLabel","confirmId","cancelLabel","tertiaryLabel","triggerLabel","triggerVariant","closeButtonLabel"]},{"name":"get_divider","description":"KERN UX: HTML for a divider, <hr class=\"kern-divider\">, decorative by default.","params":["decorative","locale","strict"]},{"name":"get_dropdown","description":"KERN UX: HTML for a dropdown (experimental): a <details>/<summary> with radio or checkbox options inside. Not a menu or a select.","params":["locale","strict","triggerLabel","name","options","inputType","open"]},{"name":"get_fieldset","description":"KERN UX: HTML for a fieldset: related form fields under a legend, with an optional hint and group error. Put the fields in contentBlocks as field blocks, e.g. { legend: 'Ihre Anschrift', legendSize: 'large', contentBlocks: [{ kind: 'field', field: { type: 'text', name: 'strasse', label: 'Straße und Hausnummer' } }] }.","params":["legend","legendSize","optional","hint","error","horizontal","contentBlocks","locale","strict"]},{"name":"get_grid","description":"KERN UX: HTML for 1 to 12 equal-width columns on KERN's CSS Grid utilities (kern-grid kern-grid-cols-1 kern-grid-cols-{n}-md kern-gap-lg), one column on small screens. For columns of different widths, see get_utility_reference.","params":["columns","containerFluid","rowAlignment","includeHeading","headingText","headingLevel","columnsContent","locale","strict"]},{"name":"get_heading","description":"KERN UX: HTML for a heading, h1 to h6. Every level gets kern-heading-medium; KERN's other heading sizes aren't offered. Page and section headings; inside cards, dialogs or forms, use get_title.","params":["text","level","locale","strict"]},{"name":"get_icon","description":"KERN UX: HTML for an icon, decorative by default. Required: name (see list_icons). A meaningful icon needs decorative: false and an ariaLabel.","params":["locale","strict","name","size","decorative","ariaLabel"]},{"name":"get_inputdate","description":"KERN UX: HTML for a date input: one native type=date field with label, optional hint and error. KERN's own date pattern, a fieldset with separate day, month and year inputs, isn't rendered by this tool.","params":["locale","strict","name","value","placeholder","autocomplete","label","hint","error","optional","required","disabled","readonly","type"]},{"name":"get_inputemail","description":"KERN UX: HTML for an email input (type=email) with label, optional hint and error. autocomplete defaults to email.","params":["locale","strict","name","value","placeholder","autocomplete","label","hint","error","optional","required","disabled","readonly","type"]},{"name":"get_inputfile","description":"KERN UX: HTML for a file input for one file, with label, optional hint and error. Required: name, label. Name the allowed formats and size limit in hint.","params":["locale","strict","name","accept","label","hint","error","optional","required","disabled"]},{"name":"get_inputgroup","description":"KERN UX: HTML for a text input with a visual prefix or suffix, e.g. '€' or '.de'. Only the plain text-field variant: no buttons or error state inside the group.","params":["locale","strict","name","label","prefix","suffix","value","placeholder","disabled","readonly"]},{"name":"get_inputnumber","description":"KERN UX: HTML for a number input with label, optional hint and error. Required: name, label. Like KERN, it renders type=\"text\" with inputmode=\"numeric\" and pattern=\"[0-9]*\", not type=\"number\". Numbers like a postcode; for phone numbers, get_inputtel; dates, get_inputdate.","params":["locale","strict","name","value","placeholder","autocomplete","label","hint","error","optional","required","disabled","readonly"]},{"name":"get_inputpassword","description":"KERN UX: HTML for a password input (type=password) with label, optional hint and error. Only the field: no show-password toggle, no forgot-password link.","params":["locale","strict","name","value","placeholder","autocomplete","label","hint","error","optional","required","type"]},{"name":"get_inputtel","description":"KERN UX: HTML for a phone number input (type=tel) with label, optional hint and error. autocomplete defaults to tel. Name the expected format, e.g. with area code, in hint.","params":["locale","strict","name","value","placeholder","autocomplete","label","hint","error","optional","required","disabled","readonly","type"]},{"name":"get_inputtext","description":"KERN UX: HTML for a text input with label, optional hint and error. Required: name, label. Name the expected format in hint. Single-line free text; for known options, use get_radio or get_checkbox.","params":["locale","strict","name","value","placeholder","autocomplete","type","label","hint","error","optional","required","disabled","readonly"]},{"name":"get_inputurl","description":"KERN UX: HTML for a URL input (type=url) with label, optional hint and error. It expects a full address with https://; say so in hint.","params":["locale","strict","name","value","placeholder","autocomplete","label","hint","error","optional","required","disabled","readonly","type"]},{"name":"get_kopfzeile","description":"KERN UX: HTML for the Kopfzeile, the thin bar with the German flag that marks an official website of the Federal Republic of Germany. Only for official federal websites. render_page can add it to a whole page.","params":["label","fluid","locale","strict"]},{"name":"get_label","description":"KERN UX: HTML for a <label> with kern-label.","params":["text","locale","strict"]},{"name":"get_layers","description":"KERN UX: KERN's example HTML for Layers, as is. No parameters besides locale and strict. Surfaces by level (kern-layer, kern-level-*); components adapt to their level.","params":["locale","strict"]},{"name":"get_link","description":"KERN UX: HTML for a text link, <a class=\"kern-link\">. Not the icon link, small link or link button. For navigation only; for an action that changes data, use get_button.","params":["text","href","locale","strict"]},{"name":"get_lists","description":"KERN UX: HTML for a ul or ol with kern-list and two example items. Not KERN's bullet, number, size or horizontal variants.","params":["text","ordered","locale","strict"]},{"name":"get_loader","description":"KERN UX: HTML for a loading spinner with role=\"status\" and hidden screen-reader text. An unknown wait over a second; for steps of a process, use get_progress.","params":["locale","strict","visible","srText"]},{"name":"get_pattern","description":"KERN UX: KERN's header pattern as fixed HTML (flex and grid variants). There is no footer pattern: render_page renders a page with header and footer, and render_composition can build one from a section and a 4-column grid.","params":["locale","strict"]},{"name":"get_preline","description":"KERN UX: HTML for a preline (kern-preline), default size only. Short text above a title or heading; never on its own.","params":["text","locale","strict"]},{"name":"get_progress","description":"KERN UX: HTML for a progress bar: a native <progress> in kern-progress, with an optional linked label. Steps of a fixed process, never loading; for a wait, use get_loader.","params":["locale","strict","value","max","label","labelPosition"]},{"name":"get_radio","description":"KERN UX: HTML for radio buttons. mode 'list': a fieldset of options under a legend, one of which can be selected, with optional hint and error. mode 'single': one radio button on its own. Exactly one of a few options; for several, get_checkbox; 5 to 15, get_select.","params":[]},{"name":"get_search","description":"KERN UX: KERN's example HTML for Search, as is. No parameters besides locale and strict.","params":["locale","strict"]},{"name":"get_select","description":"KERN UX: HTML for a select with label, optional hint and error, inside the kern-form-input__select-wrapper KERN requires. Required: name, label and options, each { value, text }; an option can be selected or disabled. One of 5 to 15 options; for fewer, prefer get_radio. Never for navigation.","params":["locale","strict","name","options","label","hint","error","optional","required","disabled"]},{"name":"get_subline","description":"KERN UX: HTML for a subline (kern-subline), default size only. Short text below a title or heading; never on its own.","params":["text","locale","strict"]},{"name":"get_summary","description":"KERN UX: HTML for a summary: a title, answers as term and value pairs, and an optional edit link. mode 'single' or 'group'. Unlike a task list, it shows no status.","params":[]},{"name":"get_table","description":"KERN UX: HTML for a data table: column headings, optional row headings, caption and footer row, in a scrolling container. Mark numeric and currency columns numeric to right-align them. KERN's action-column pattern isn't offered.","params":["locale","strict","caption","headers","rows","footer","size","striped","responsive"]},{"name":"get_tasklist","description":"KERN UX: HTML for a task list: tasks with a title, an optional link and a status badge. numbered (default true) numbers them; numbered: false gives an unnumbered checklist.","params":["locale","strict","heading","numbered","items"]},{"name":"get_textarea","description":"KERN UX: HTML for a multi-line text field (textarea) with label, optional hint and error. Required: name, label. Only for multi-line text; for a single line, use get_inputtext.","params":["locale","strict","name","value","placeholder","rows","cols","label","hint","error","optional","required","disabled","readonly"]},{"name":"get_title","description":"KERN UX: HTML for a title: always an <h2> with kern-title and the size modifier. Headings inside cards, dialogs or forms; for page sections, use get_heading.","params":["text","size","locale","strict"]}],"toolsHash":"3d9fe4fc8269f47cce8a6a8816cc9dbafb66410a07884bad297fef78b0ce6115","wrote":[],"callsAt":"2026-11-16T11:37:12.936Z","calls":[{"tool":"get_tokens","ok":true,"ms":6,"bytes":31342},{"tool":"list_icons","ok":true,"ms":1,"bytes":768},{"tool":"list_components_by_category","ok":true,"ms":2,"bytes":5901},{"tool":"get_utility_reference","ok":true,"ms":3,"bytes":11770},{"tool":"get_accordion","ok":false,"ms":3,"bytes":0,"error":"tool reported an error: Input validation error: Invalid arguments for tool get_accordion: \n- title: Invalid input: expected string, received undefined\n- content: Invalid input: expected string, received undefined"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"very-long","tool":"render_composition","quote":"2642 characters or more"}],"tools":54,"wrote":0,"callsTried":5,"callsAnswered":4,"callContacts":[]},"history":[{"package":"@leonio/kern-ux-mcp","version":"2.0.0","ranAt":"2026-11-16T11:37:07.853Z","outcome":"started","tools":54,"contacts":0,"flags":1,"serious":0,"toolsHash":"3d9fe4fc8269f47cce8a6a8816cc9dbafb66410a07884bad297fef78b0ce6115"}],"page":"https://bragproof.smaverk.com/r/%40leonio/kern-ux-mcp"}