{"report":{"v":1,"package":"@hashicorp/design-system-mcp","version":"0.2.3","ranAt":"2026-11-16T11:34:48.314Z","install":{"ok":true,"integrity":"sha512-MdYDIAqwOQ50H2/iu4ow5l9hB/gCy6hg60n4jv2BK6Hc9fHooC0yycu4o6PXpKcMiH/Nju7MST1u1EELtJ/keQ==","deps":702,"scripts":["@ibm/plex-mono","@ibm/plex-sans","core-js"],"bins":["helios-design-system-mcp"],"license":"MPL-2.0","engines":"node >=24","repository":"https://github.com/hashicorp/design-system.git","bin":"helios-design-system-mcp"},"start":{"ok":true,"ms":149,"serverName":"helios-design-system-mcp","serverVersion":"0.2.3","protocol":"2025-06-18","stderr":"Helios Design System MCP server running on stdio\n"},"tools":[{"name":"search_hds_components","description":"Find Helios Design System components by name, from the component catalog shipped inside the installed @hashicorp/design-system-components package. This is a name lookup, not a question answerer: it matches a substring against each component's invocation name, class name, module path and docs route. Pass 'advanced table' or 'Hds::Flyout', not 'how do I make a table sortable'. Use it to confirm a component exists and to recover its exact invocation name and spelling before writing a template. Results are intentionally concise. Follow up with get_hds_component for a component's arguments, accepted values, blocks and yielded contextual components. Use search_hds_docs with the result's docsPath for usage guidance, examples, accessibility guidance and design recommendations. Every documented component carries a docsPath; Hds::Yield is the sole exception. The catalog is read from disk and never fetched. Exact and prefix matches rank first, so if `truncated` is true, narrow the query or use the first results as the most relevant matches.","params":["query","limit"]},{"name":"get_hds_component","description":"Read the full API of one Helios Design System component: every argument with its type, whether it is required and which values it accepts, plus the blocks it takes and the contextual components it yields. The data is generated from the TypeScript declarations of the installed @hashicorp/design-system-components package, so it is the authoritative answer to 'what arguments does this take' — prefer it over prose documentation, which can lag the code. Pass the template invocation, the class name, the bare name or the module path. When the name does not resolve, search_hds_components results come back as suggestions rather than an error. An argument's `values` list is capped at 25; when `valuesTruncated` is true, `valuesCount` holds the real total. In practice only icon-name and HTML-tag arguments hit the cap — use search_hds_icons to pick an icon name. Yielded contextual components are listed by the name they take inside the block. Their own arguments are separate catalog entries, so look up 'Hds::Alert::Title' to see what [A].Title accepts. The catalog is read from disk and never fetched.","params":["name"]},{"name":"search_hds_docs","description":"Search the bundled Helios Design System documentation (helios.hashicorp.design) and return ranked passages with snippets. The corpus is a snapshot committed into this server: search runs entirely locally and never makes a network request. Every result carries the canonical URL of the passage, and the response carries the bundledAt timestamp, so a client that needs the live page can fetch it itself. Follow up with read_hds_docs, passing a result's `id`, to read the full passage including its code examples. Results are ranked, not filtered for truth: a non-empty result set is not evidence that Helios has the thing you asked about. Check `pageAnchored` and `unmatchedTerms`, and read the snippets.","params":["query","limit","section","tab","docsPath"]},{"name":"read_hds_docs","description":"Read one passage of the bundled Helios Design System documentation by id, as markdown. Ids come from search_hds_docs; run that first rather than guessing an id. The returned markdown keeps the <Doc::*> and <Hds::*> usage examples and the inlined code snippets, which is what search snippets strip out. The corpus is a snapshot committed into this server: nothing is fetched. The first content block carries the canonical URL and the bundledAt timestamp so a client can fetch the live page itself.","params":["id","includeChildren","maxBytes"]},{"name":"search_hds_icons","description":"Find HDS icons — the icon set Helios ships — by name or keyword, from the catalog inside the installed @hashicorp/flight-icons package. Each icon's searchable text includes its description keywords, so 'warning' reaches alert-triangle even though the two share no characters. Use it to pick the @name value for <Hds::Icon> or <Hds::Button @icon=>, and to confirm an icon exists before writing a name that would render nothing. Use the optional size filter when you need an icon available at a particular size; otherwise pick the size at the call site. The catalog is read from disk and never fetched. Exact and prefix matches on the icon name rank first, so an icon you named by hand comes back at the top; keyword-only matches rank last. If `truncated` is true, narrow the query or filter by category.","params":["query","limit","category","size","hasMapping"]},{"name":"search_hds_tokens","description":"Find Helios design tokens by name or value, from the token catalog inside the installed @hashicorp/design-system-tokens package. Every result carries the cssVar to write in a stylesheet — var(--token-color-foreground-action) — so use this to replace a hard-coded color, spacing or radius with the token that holds it. The query matches the token value too, so searching a hex code finds which token already defines it. The catalog is read from disk and never fetched. Exact and prefix matches on the token key, name or CSS variable rank first, so a token you named by hand comes back at the top; value-only matches rank last. If `truncated` is true, narrow the query or filter by type.","params":["query","limit","type","category"]}],"toolsHash":"a479299cec454706af9904ad2c756244708d4f2c50d4577c6b6cfd28f4a2d382","wrote":[],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":6,"wrote":0,"callsTried":0,"callsAnswered":0,"callContacts":[]},"history":[{"package":"@hashicorp/design-system-mcp","version":"0.2.3","ranAt":"2026-11-16T11:34:48.314Z","outcome":"started","tools":6,"contacts":0,"flags":0,"serious":0,"toolsHash":"a479299cec454706af9904ad2c756244708d4f2c50d4577c6b6cfd28f4a2d382"}],"page":"https://bragproof.smaverk.com/r/%40hashicorp/design-system-mcp"}