# Bestax

> Bestax is an open-source MCP server for developer tools. Props, examples, CSS variables and skills for bestax-bulma React components, offline. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://bestax.io/docs/guides/llms
- **Repository:** https://github.com/allxsmith/bestax/tree/HEAD/bestax-mcp
- **MCP Registry name:** io.github.allxsmith/bestax-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

The index ships inside the npm package, so answers need no network calls, and it documents one specific release of @allxsmith/bestax-bulma. The server compares the version installed in your project with the one it documents and warns on a mismatch rather than describing props you do not have. BESTAX_MCP_PROJECT_DIR points it at your project if your client launches servers elsewhere.

Tools include list_components, search_bestax, get_component, get_props (including compound parts such as Navbar.Brand), get_examples and get_css_variables for the --bulma-* variables behind each component. The README mentions about 900 working examples, helper props that replace inline styles, and the bestax Agent Skills offered as invocable prompts.

Pin the major version with bestax-mcp@1 so a new release is not picked up on every launch. It is MIT-licensed and also available through a Claude Code plugin that adds the skills.

## Features

- **Component props:** Full prop tables including compound sub-parts.
- **Working examples:** About 900 tsx examples from the docs.
- **CSS variables:** The --bulma-* variables behind each component.
- **Version check:** Warns when installed and documented versions differ.
- **Agent skills:** Skills for forms, theming, layout and more as prompts.
- **Offline index:** No network calls at runtime.

## Good for

- Look up a component's props while coding
- Find an example for a navbar or form
- Theme a component using its CSS variables
- Migrate between versions with the skills

## Install

### Claude Code (Terminal)

```sh
claude mcp add bestax-mcp -- npx -y bestax-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bestax-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bestax-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bestax-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bestax-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bestax-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bestax-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bestax-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bestax-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bestax-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bestax-mcp"
      ]
    }
  }
}
```

## Tools

- `list_components`: Every component with a one-line purpose, by category
- `search_bestax`: Components, props, examples, CSS variables and skills in one ranked list
- `get_component`: Import, summary and props for a component
- `get_props`: One prop table including compound sub-paths
- `get_examples`: Working tsx examples from the component's docs page
- `get_css_variables`: The --bulma-* CSS variables for a component

## FAQ

### Does it need network access?

No. The index ships inside the package.

### How do I install it?

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

### Why pin @1?

So a breaking or compromised release does not reach your agent without review.

### What if the versions differ?

It warns you.

### Is Bestax free?

Yes. Bestax is open source, so you can use and self-host it for free.

### How do I add Bestax to Claude Code?

Run this command in your terminal: claude mcp add bestax-mcp -- npx -y bestax-mcp

### What are the best alternatives to Bestax?

The closest alternatives to Bestax are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/bestax
