bestax-mcp

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

Each release is published to the official MCP Registry as io.github.allxsmith/bestax-mcp, for clients that install from it.

Claude Code

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

Or install the bestax plugin instead. It runs this same server and adds the bestax Agent Skills:

/plugin marketplace add allxsmith/bestax-skills
/plugin install bestax@bestax

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"]
    }
  }
}

The server checks your installed @allxsmith/bestax-bulma against the version it documents, looking for it from the directory it starts in. If your client starts servers somewhere other than your project, point it at the project with BESTAX_MCP_PROJECT_DIR in the config's env:

{
  "mcpServers": {
    "bestax": {
      "command": "npx",
      "args": ["-y", "bestax-mcp@1"],
      "env": { "BESTAX_MCP_PROJECT_DIR": "/path/to/your/project" }
    }
  }
}

If it finds no installed copy, its first answer says so.

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.

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

Links

• LLMs guide — the canonical entry point for bestax's AI surfaces, including llms.txt and the Agent Skills
• Documentation
• GitHub

Source code licensed MIT