> For the complete documentation index, see [llms.txt](https://docs.buzzy.buzz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buzzy.buzz/the-building-blocks/mcp/buzzy-builder-mcp.md).

# 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.

{% hint style="success" %}
**New to Builder MCP? Start with the tutorial.** The hands-on, screenshot-driven [**Tutorial: Build a carer app from a template**](/getting-started-with-buzzy/tutorial-carer-app-from-a-template.md) walks you through a complete build end to end — connect, describe your app, approve each stage, then refine. It's the fastest way to see the whole workflow.
{% endhint %}

## 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 %}

Prefer a guided, screenshot-by-screenshot build? Follow the full walkthrough:

{% content-ref url="/pages/V268OApcdnzplyJWVIkn" %}
[Getting started with Buzzy Builder MCP](/getting-started-with-buzzy/tutorial-carer-app-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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.