@htmlbricks/mcp

Model Context Protocol server for HTML Bricks (hb-* web components). It exposes the agent catalog reference, list.json, CDN helpers, search, and prompts so coding agents can build correct markup (snake_case attributes, Bootstrap 5, Bootstrap Icons).

Usage (agentic IDEs)

Run via stdio (example for MCP clients):

{
  "command": "npx",
  "args": ["-y", "@htmlbricks/mcp"]
}

Requires Node.js 18+. The published package embeds AGENT_WEBCOMPONENTS_REFERENCE.md and list.json for the same version as @htmlbricks/hb-bundle. If assets are missing, the server falls back to jsDelivr for that version.

Resources

| URI | Content | |-----|---------| | htmlbricks://docs/development-guide | Conventions and workflow | | htmlbricks://catalog/agent-reference | Full merged component reference (Markdown) | | htmlbricks://catalog/package-list | list.json: per package, definitions.events (event names → schema for detail) and definitions.component (prop types as JSON Schema) |

Tools

• search_catalog — keyword search in the reference
• get_component_schemas — definitions.events + definitions.component for one hb-* (from bundled list.json)
• get_bundle_cdn_urls — jsDelivr URLs for hb-bundle matching this package version

Prompts

• plan_htmlbricks_page — structured task to read resources and plan UI with hb-* elements