# Buzzy Builder MCP

Buzzy Builder MCP is the workflow for using an AI agent to build or change a Buzzy app. The agent connects to Buzzy's MCP server, follows Buzzy's bootstrap instructions, and works with you through staged app-building and review.

Use this section when you want an agent to create, inspect, or edit the app itself. If you already have an app and want that app to expose tools to ChatGPT or Claude, use [Buzzy Custom MCP](/the-building-blocks/mcp/buzzy-custom-mcp.md) instead.

## Common Builder Workflows

### Getting started

Start here once per project. This covers MCP credentials, connecting your agent, bootstrapping the local repo, and the review habits that apply to every Builder MCP workflow.

{% content-ref url="/pages/gOBi8D5yPTX9ofnQJTfT" %}
[Getting started with Builder MCP](/the-building-blocks/mcp/buzzy-builder-mcp/getting-started.md)
{% endcontent-ref %}

### For new apps

Start with an empty repo and a focused app prompt. After setup, the agent creates the app and moves through the brief, flows, data model, theme, blueprint, screens, sample data, and refinement stages.

{% content-ref url="/pages/F2S40cO0BLzrIe5wzsVZ" %}
[For new apps](/the-building-blocks/mcp/buzzy-builder-mcp/for-new-apps.md)
{% endcontent-ref %}

### From a template

Start from an existing Buzzy template when the app shape is close to something Buzzy already provides. The agent should still inspect the template, identify the changes you need, and work through staged edits rather than treating the template as finished.

{% content-ref url="/pages/1t1hGsfoVEqERpYTsk06" %}
[From a template](/the-building-blocks/mcp/buzzy-builder-mcp/from-a-template.md)
{% endcontent-ref %}

### Editing existing apps

Use MCP to help an agent inspect the current app, plan the smallest useful change, apply edits in stages, and verify the result in preview or runtime.

{% content-ref url="/pages/tGFxNoN4FMfFD5MuyUyp" %}
[Editing existing apps](/the-building-blocks/mcp/buzzy-builder-mcp/editing-existing-apps.md)
{% endcontent-ref %}

## Working Style

Good Builder MCP work is collaborative and staged:

* connect the agent to Buzzy MCP and bootstrap the repo first
* review generated artifacts before moving downstream
* use sample data and screenshots when screens exist
* ask for a plan before broad screen or data-model changes
* verify important runtime paths before treating the change as complete


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buzzy.buzz/the-building-blocks/mcp/buzzy-builder-mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.