{"report":{"v":1,"package":"@heroui/react-mcp","version":"1.1.4","ranAt":"2026-11-16T11:25:41.673Z","install":{"ok":true,"integrity":"sha512-h0DhQZLS74ykk0gdnXzuOdF+E2Ke/j1CuoJ8WSwemO4cFk8CJ5ASZJGA1CsErLC2urX1jZj+Zmfb2sjZ5u+XRQ==","deps":126,"scripts":[],"bins":["heroui-react-mcp"],"license":"MIT","engines":"node >=22.22.0","repository":"git+https://github.com/heroui-inc/heroui-mcp.git","bin":"heroui-react-mcp"},"start":{"ok":true,"ms":428,"serverName":"@heroui/react-mcp","serverVersion":"1.1.4","protocol":"2025-06-18","stderr":"HeroUI MCP Server running on STDIO\nAPI URL: https://mcp-api.heroui.com\nVersion: 1.1.4\n"},"tools":[{"name":"list_components","description":"List all available components in HeroUI v3 - v2 components NOT supported.\n⚠️ VERSION INFO: This returns v3 components only - NOT v2 components.\nMigration from v2 is available - visit https://heroui.com/docs/react/migration.\nIf you need v2 components, visit https://v2.heroui.com (not supported by this MCP).\nAlways call this first before using any component to verify it exists in v3.\nReturns the component names exactly as they should be used in imports and other tool calls.\nv3 uses compound patterns (e.g., Card.Header, Card.Content) - different from v2's flat props.\nExample workflow: list_components → get_component_docs → get_component_source_code (optional).","params":[]},{"name":"get_component_docs","description":"Get complete component documentation (including examples, props, usage) directly from heroui.com.\nAccepts an array of component names and returns the full MDX documentation for each component.\nReturns raw markdown content from the component's .mdx file, which includes:\n- Import statements\n- Usage examples\n- Variants and sizes\n- Props documentation\n- Styling information\n- API Reference\n- And more\n\nThis tool replaces get_component_info, get_component_props, and get_component_examples.\nUse this when you need complete component documentation in one call.\nWorkflow: list_components → get_component_docs.","params":["components"]},{"name":"get_component_source_code","description":"Get the actual React/TypeScript source code implementation of HeroUI v3 components.\nAccepts an array of component names and returns source code for each.\nReturns the internal implementation for learning purposes or debugging.\nShows how the component is built using React Aria Components.\nUse this to understand component internals, not for copying implementation.\nThe source shows accessibility features, keyboard handling, and ARIA attributes.\nNote: For using components, refer to examples via get_component_docs.\nIMPORTANT: Do NOT copy this code directly - use the component via @heroui/react imports.\nThis shows v3 implementation which uses React Aria Components as foundation.\nGitHub links are provided for viewing the source in context.","params":["components"]},{"name":"get_component_source_styles","description":"Get the CSS styles and BEM classes for HeroUI v3 components.\nAccepts an array of component names and returns styles for each.\nReturns the complete CSS implementation including all variants and states.\nShows BEM class structure (e.g., .button, .button--accent, .button--disabled).\nIMPORTANT: These are framework-agnostic styles from @heroui/styles package.\nDO NOT mix BEM classes with React components - choose one approach:\n- Use @heroui/react for full React components with accessibility\n- Use @heroui/styles for CSS-only styling without JavaScript\nBEM classes provide styling only - no JavaScript behavior or accessibility.\nFor production use, prefer @heroui/react components for full functionality.\nGitHub links are provided for viewing styles in context.","params":["components"]},{"name":"get_theme_variables","description":"Get HeroUI v3 default theme variables and design tokens (actual variable values).\nIncludes both light and dark mode variables for all categories:\n- Colors: Color tokens (accent, success, danger, background, foreground)\n- Typography: Font sizes, weights, line heights\n- Spacing: Margin, padding, gap values\n- Borders: Border radius, widths, colors\n- Shadows: Box shadows and elevations\n- Animations: Durations, timing functions\nVariables use modern oklch() color format for better color manipulation.\nApply these in your CSS with :root or theme-specific selectors.\nExample variables: --color-accent, --radius-md, --font-size-body, --spacing-4.\nFor theme documentation and guides, use the get_docs tool instead.\nIMPORTANT: HeroUI v3 uses Tailwind CSS v4 - ensure compatibility.","params":[]},{"name":"get_docs","description":"Get HeroUI v3 React documentation content for guides, principles, and release notes (NOT component docs).\nFetches official documentation from heroui.com.\nReturns the complete MDX content of documentation pages.\nUse for understanding concepts, design principles, implementation guides, and version history.\nDocumentation covers: getting started, theming, colors, styling, animation, release notes.\nIMPORTANT: For component documentation, use get_component_docs instead.\nExample paths: /docs/react/getting-started/theming, /docs/react/releases/v3-0-0-rc-1.\nAll React documentation paths start with /docs/react/ prefix.\nReturns MDX content which may include code examples and explanations.\nThis is v3 documentation - ensure you're working with HeroUI v3, not v2.\nNOTE: For HeroUI Native documentation, use the @heroui/native-mcp server instead.","params":["path"]}],"toolsHash":"6bc9ccb24d0720338b45c14070e1b83d583efd21f820ba37ed53046e8ebb0d7f","wrote":[],"callsAt":"2026-11-16T11:25:50.043Z","calls":[{"tool":"list_components","ok":true,"ms":132,"bytes":945},{"tool":"get_theme_variables","ok":true,"ms":298,"bytes":3253}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["mcp-api.heroui.com","registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":["mcp-api.heroui.com"],"flags":[{"kind":"orders","tool":"list_components","quote":"t https://v2.heroui.com (not supported by this MCP). Always call this first before using any component to verify it exists in v3. Returns the component names exactly as they s"},{"kind":"orders","tool":"get_component_source_code","quote":"using components, refer to examples via get_component_docs. IMPORTANT: Do NOT copy this code directly - use the component via @heroui/react imports. This shows v3 implem"},{"kind":"orders","tool":"get_component_source_styles","quote":"ucture (e.g., .button, .button--accent, .button--disabled). IMPORTANT: These are framework-agnostic styles from @heroui/styles package. DO NOT mix BEM classes with React"},{"kind":"orders","tool":"get_theme_variables","quote":"me documentation and guides, use the get_docs tool instead. IMPORTANT: HeroUI v3 uses Tailwind CSS v4 - ensure compatibility."},{"kind":"orders","tool":"get_docs","quote":"tarted, theming, colors, styling, animation, release notes. IMPORTANT: For component documentation, use get_component_docs instead. Example paths: /docs/react/getting-st"}],"tools":6,"wrote":0,"callsTried":2,"callsAnswered":2,"callContacts":[]},"history":[{"package":"@heroui/react-mcp","version":"1.1.4","ranAt":"2026-11-16T11:25:41.673Z","outcome":"started","tools":6,"contacts":1,"flags":5,"serious":0,"toolsHash":"6bc9ccb24d0720338b45c14070e1b83d583efd21f820ba37ed53046e8ebb0d7f"}],"page":"https://bragproof.smaverk.com/r/%40heroui/react-mcp"}