Docs / CLI

MCP Command

Start the Better Fullstack MCP server over stdio for AI coding agents.

The mcp command starts the Better Fullstack MCP server over stdio. Agents can use it to inspect schemas, validate compatibility, preview generated files, create projects, and add supported features to existing projects.

npx -y create-better-fullstack@latest mcp

The server uses stdio transport. Configure your MCP client to launch the command and communicate over standard input/output.

Client examples

Claude Code with npm:

claude mcp add --transport stdio better-fullstack -- npx -y create-better-fullstack@latest mcp

For pnpm, Bun, or Yarn, replace the command after -- with the matching launcher:

Package manager	Launcher
npm	`npx -y create-better-fullstack@latest mcp`
pnpm	`pnpm dlx create-better-fullstack@latest mcp`
Bun	`bunx create-better-fullstack@latest mcp`
Yarn	`yarn dlx create-better-fullstack@latest mcp`

Generic MCP client config with npm:

{
  "mcpServers": {
    "better-fullstack": {
      "command": "npx",
      "args": ["-y", "create-better-fullstack@latest", "mcp"]
    }
  }
}

Equivalent command/args for other package managers:

Package manager	`command`	`args`
pnpm	`pnpm`	`["dlx", "create-better-fullstack@latest", "mcp"]`
Bun	`bunx`	`["create-better-fullstack@latest", "mcp"]`
Yarn	`yarn`	`["dlx", "create-better-fullstack@latest", "mcp"]`

Tool Surface

Tool	Purpose
`bfs_get_guidance`	Returns workflow rules and field semantics.
`bfs_get_schema`	Returns valid options for one category or all categories.
`bfs_check_compatibility`	Validates stack selections before generation.
`bfs_plan_project`	Dry-runs generation in memory.
`bfs_create_project`	Writes a new project to disk.
`bfs_plan_addition`	Plans feature additions for an existing project.
`bfs_add_feature`	Adds supported features to an existing project.

Project planning, creation, and addition responses include graph metadata (graphSummary, effectiveStack, and stackPartSpecs) alongside the generated file or mutation summary.

See the MCP tools reference for inputs, outputs, and safe workflows.

Safety notes

bfs_plan_project does not write files.
bfs_create_project writes files but does not install dependencies.
bfs_add_feature mutates an existing Better Fullstack project and does not install dependencies.
Agents should call bfs_get_guidance and bfs_check_compatibility before project creation.

docs opens the public documentation site.
builder opens the interactive Stack Builder.
sponsors shows Better Fullstack sponsors.

See the CLI reference for examples of these utility commands.

Client examples

Tool Surface

Safety notes

Related Commands