### Usage: Local Agents (stdio) with global install

Source: https://github.com/sjawhar/macrofactor/blob/main/docs/superpowers/specs/2026-03-23-mcp-server-design.md

Example of running the MCP server locally after a global installation.

```bash
# Option B: global install
npm install -g @sjawhar/macrofactor-mcp
macrofactor-mcp
```

--------------------------------

### Start Development Server

Source: https://github.com/sjawhar/macrofactor/blob/main/AGENTS.md

Starts the development server using Vite.

```bash
npm run dev
```

--------------------------------

### Verify Build Setup

Source: https://github.com/sjawhar/macrofactor/blob/main/docs/superpowers/plans/2026-03-23-mcp-server.md

Command to run the build process and verify that tsup is installed and the configuration is valid. Expects failure initially as entry points do not exist.

```bash
pnpm run build:mcp
```

--------------------------------

### Install Dependencies and Set Up Credentials

Source: https://github.com/sjawhar/macrofactor/blob/main/README.md

Install project dependencies using pnpm and configure MacroFactor credentials by creating a .env file with your email and password.

```bash
pnpm install
cat > .env << 'EOF'
MACROFACTOR_USERNAME=your@email.com
MACROFACTOR_PASSWORD=your-password
EOF
```

--------------------------------

### Commit Initial MCP Server Setup

Source: https://github.com/sjawhar/macrofactor/blob/main/docs/superpowers/plans/2026-03-23-mcp-server.md

Commits the initial project setup changes for the MCP server using jj.

```bash
jj describe -m "chore: add MCP server dependencies and build config"
jj new
```

--------------------------------

### Usage: Local Agents (stdio) with npx

Source: https://github.com/sjawhar/macrofactor/blob/main/docs/superpowers/specs/2026-03-23-mcp-server-design.md

Example of running the MCP server locally without a global installation using npx.

```bash
# Option A: npx (no install)
npx @sjawhar/macrofactor-mcp
```

--------------------------------

### Install Dependencies

Source: https://github.com/sjawhar/macrofactor/blob/main/AGENTS.md

Installs project dependencies using pnpm.

```bash
pnpm install
```

--------------------------------

### Initialize and Render Benchmark

Source: https://github.com/sjawhar/macrofactor/blob/main/docs/sbs-evals/sbs-bench/review.html

Initializes the benchmark display by calling init() and then rendering the benchmark results using renderBenchmark().

```javascript
init();
renderBenchmark();
```

--------------------------------

### Preview Production Build

Source: https://github.com/sjawhar/macrofactor/blob/main/AGENTS.md

Previews the production build locally.

```bash
npm run preview
```