BuildBetter

io.github.buildbetter-appPublished by GitHub account buildbetter-appv0.1.0Updated Nov 3, 2026

Research customer feedback, calls, support, surveys and product usage with source citations.

VerifiedStreamable HTTPWeb executableBusiness & Commerce

Overview

BuildBetter's hosted MCP server (mcp.buildbetter.app); OAuth sign-in required; Streamable HTTP.

No AI overview yet: these facts come from the registry entry and the server itself.

Endpoint
mcp.buildbetter.app
Documentation
docs.buildbetter.ai
Last checked

Installation

In SourceWeft

  1. Open BuildBetter in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.buildbetter-app%2Fbuildbetter/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "buildbetter": {
      "type": "http",
      "url": "https://mcp.buildbetter.app/"
    }
  }
}

README

BuildBetter Skills

AI coding skills enriched with BuildBetter customer evidence.

What is this?

BuildBetter Skills is a collection of AI coding skills you can install into your favorite AI coding agent. Pick the skills you need -- install only the packs that matter for your workflow. BuildBetter Skills works with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, and Amazon Q.

Quick start

Option A: npx (fastest, no install)

bash
npx skills add buildbetter-app/skills

Or install a specific skill:

bash
npx skills add buildbetter-app/skills --skill trust-but-verify

Option B: bb-skills CLI (pack-based install)

bash
pip install bb-skillsbb-skills install spec-workflow    # spec-driven development skillsbb-skills install testing          # browser testing skillsbb-skills install all              # everything

Option C: Codex plugin package

This repo also includes a Codex plugin package at plugins/skills/ plus a repo-local marketplace entry at .agents/plugins/marketplace.json. The plugin bundles the same BuildBetter Skills prompts for Codex and includes Playwright MCP wiring for the browser-testing skills.

bash
codex plugin marketplace add buildbetter-app/skills --ref main --sparse .agents/plugins --sparse plugins/skills --sparse plugins/buildbetter-codexcodex plugin add skills@buildbetter

Option D: BuildBetter MCP/CLI plugins

This repo includes separate BuildBetter MCP/CLI plugins for Codex and Claude Code under plugins/buildbetter-codex/ and plugins/buildbetter-claude/. They include BuildBetter-specific skills for MCP routing, customer voice, synthetic research, native surveys, Smart Tags, project triage, and knowledge gaps. They are separate packages because Codex and Claude Code use different plugin manifest directories and remote MCP config schemas.

Codex:

bash
codex plugin marketplace add buildbetter-app/skills --ref main --sparse .agents/plugins --sparse plugins/skills --sparse plugins/buildbetter-codexcodex plugin add buildbetter@buildbetter

Claude Code:

bash
claude plugin marketplace add buildbetter-app/skills --sparse .claude-plugin plugins/buildbetter-claudeclaude plugin install buildbetter@buildbetter

Option E: Grok, Cursor and MCP marketplaces

The existing Grok/Cursor plugin uses BuildBetter's production MCP and nine public research workflows. For the MCP Registry, Google Connected Apps, Meta, Microsoft 365, Salesforce and AWS preparation, see the distribution guide. Build a reproducible kit with python3 scripts/build_mcp_distribution.py. Provider registration, native-host QA and marketplace approval are separate from building the package.

3. Use them

Skills are installed into your AI coding agent. On platforms with slash commands (Claude Code, Codex, Gemini):

/bb-specify Build a user dashboard with activity feed/bb-plan/trust-but-verify

On passive platforms (Cursor, Copilot, Windsurf, Amazon Q), skills are injected as context automatically.

How it works

You run bb-skills install once per machine. The CLI auto-detects which AI coding platforms you have installed (~/.claude/, ~/.codex/, ~/.gemini/, .cursor/, etc.) and copies skills to all of them in the correct format.

To see what platforms are detected:

bash
bb-skills platforms

To install for a specific platform only:

bash
bb-skills install testing --platform claude

To install a single skill instead of a whole pack:

bash
bb-skills install trust-but-verify

Available packs

PackSkillsDescription
corebb-skills-updateUpdate checker (auto-included)
spec-workflowbb-specify, bb-plan, bb-review, bb-tasks, bb-clarify, bb-analyze, bb-checklist, bb-constitution, bb-implementBuildBetter-enriched spec-driven development
testingapp-navigator, trust-but-verify, generate-testsBrowser-based verification and Playwright test generation

Platform support

PlatformFormatSlash CommandsInstall Path
Claude CodeSKILL.mdYes~/.claude/skills/
Codex CLISKILL.mdYes~/.codex/skills/
Cursor.mdc rulesNo (passive).cursor/rules/
GitHub Copilot.instructions.mdNo (passive).github/instructions/
Gemini CLI.tomlYes~/.gemini/commands/bb-skills/
Windsurf.md rulesNo (passive).windsurf/rules/
Amazon Q.md rulesNo (passive).amazonq/rules/

Skill reference

core

SkillDescription
bb-skills-updateChecks for available BuildBetter Skills updates via GitHub releases

spec-workflow

SkillDescription
bb-specifyDefine what you want to build -- requirements and user stories
bb-planCreate a technical implementation plan with your chosen tech stack
bb-reviewBuildBetter-first usability and code review
bb-tasksGenerate an actionable task list from your implementation plan
bb-clarifyClarify underspecified areas before planning
bb-analyzeCross-artifact consistency and coverage analysis
bb-checklistGenerate quality checklists that validate requirements completeness
bb-constitutionCreate or update project governing principles
bb-implementExecute all tasks to build the feature according to the plan

testing

SkillDescription
app-navigatorMap application routes, pages, and components for UI/UX audit
trust-but-verifyVerify UI/UX and functionality match the original plan
generate-testsGenerate reusable Playwright test files from the app map

BuildBetter integration

The spec-workflow skills can optionally use BuildBetter's customer evidence API to enrich specifications, plans, and reviews with real customer data. This is not required -- all skills work without it. When a BUILDBETTER_API_KEY environment variable is set, the workflow will automatically pull relevant customer insights, feature requests, and pain points into your specs and plans.

To enable it, set the API key in your shell:

bash
export BUILDBETTER_API_KEY=your_key_here

Evidence collection is best-effort and never blocks the workflow. If the key is missing or the API is unreachable, skills continue normally.

Updating

To update all installed skills to the latest version:

bb-skills update

CLI reference

CommandDescription
bb-skills install <pack>Install a skill pack
bb-skills uninstall <pack>Remove an installed skill pack
bb-skills updateUpdate all installed packs to latest
bb-skills listList installed packs and skills
bb-skills platformsShow supported platforms and install paths

Contributing

See CONTRIBUTING.md for guidelines on adding skills, writing adapters, and submitting pull requests.

Acknowledgments

BuildBetter Skills was inspired by and originally derived from github/spec-kit (MIT License). BuildBetter has significantly extended the original with customer evidence integration, browser testing skills, multi-platform support, and a skill management CLI.

License

This project is licensed under the MIT License. See LICENSE for details.

Source: README.md at commit 5c83055

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.1.0LatestNov 3, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.