Bestax

Gives coding agents the props, examples, CSS variables and Agent Skills for the Bestax React component library (Bulma v1). Runs offline.

Documentation

bestax-mcp

npm version npm downloads License: MIT Socket Badge OpenSSF Scorecard OpenSSF Best Practices npm provenance Security policy

The official MCP server for @allxsmith/bestax-bulma — React components for Bulma v1.

It gives a coding agent the whole library: every component's props (including compound sub-parts like Navbar.Brand), ~900 working examples, the --bulma-* CSS variables behind every component, the helper props that replace inline styles, and the bestax Agent Skills as invocable prompts.

Offline and version-pinned. The index ships inside the package — no network calls, nothing to rate-limit. It documents one specific bestax-bulma release, and the server checks the version actually installed in your project and warns you when they disagree, rather than confidently describing props you do not have.

Setup

Claude Code

claude mcp add bestax -- npx -y bestax-mcp@1

Cursor, Claude Desktop, Windsurf, Cline

Add to your MCP config (.cursor/mcp.json, claude_desktop_config.json, …):

{
  "mcpServers": {
    "bestax": {
      "command": "npx",
      "args": ["-y", "bestax-mcp@1"]
    }
  }
}

Run it from your project directory so it can find your installed @allxsmith/bestax-bulma and check it against the indexed version.

The @1 pins the major version. Without it, npx resolves whatever is newest on every launch — so a breaking change, or a compromised release, reaches your agent the next time it starts, with no review step. Add it to your dev dependencies instead if you would rather your lockfile decide.

Tools

Start with list_components — its output names the tool to call next. Reach for search_bestax when you need a component whose name you do not know.

ToolWhat it gives you
list_componentsAll 87 components with a one-line purpose, by category
search_bestaxComponents, props, examples, CSS variables and skills in one ranked list
get_componentImport, summary and props; optionally examples, CSS variables, accessibility, related
get_propsOne prop table, including compound sub-paths (Navbar.Brand)
get_examplesWorking tsx examples from the component's docs page
get_css_variablesThe --bulma-* custom properties a component reads, with Sass names and defaults
get_helper_propsSpacing, colour, typography, flexbox and visibility props — call this before writing an inline style
lookup_bulma_classesThe bestax component and props for a Bulma class string (button is-primary), one row per class
list_skillsThe seven bestax Agent Skills
get_skillA skill's instructions, or one of its reference documents

Prompts

One per skill, so a task can start from the library's own guidance: custom-component, form, theming, layout-scaffold, icons, migrate, optimize.

Resources

bestax://catalog · bestax://components/{name} · bestax://skills/{name} · bestax://skills/{name}/references/{ref}

Environment

VariableEffect
BESTAX_MCP_NO_VERSION_CHECKSet to 1 to skip the installed-version check entirely

Links

Source code licensed MIT