> 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.md).

# Model Context Protocol (MCP)

MCP can mean two different Buzzy workflows. Choose the path that matches what you are trying to do.

## Buzzy Builder MCP

Use **Buzzy Builder MCP** when an AI agent such as Codex or Claude is helping you build, template, inspect, or edit a Buzzy app.

This is the builder workflow: your agent connects to Buzzy's MCP server, follows the Buzzy bootstrap instructions, works through the app-building stages, and helps you review or refine the generated app.

Start here if you want to:

* create a new app with an AI coding agent
* start from an existing Buzzy template
* edit an existing Buzzy app through an agent-assisted workflow
* set up and bootstrap an MCP-connected builder repo
* use review gates, screenshots, Playwright checks, and staged changes while building

{% content-ref url="/pages/9fHV6ZjwQVuCyGx0M8gL" %}
[Buzzy Builder MCP](/the-building-blocks/mcp/buzzy-builder-mcp.md)
{% endcontent-ref %}

{% hint style="success" %}
New here? The hands-on [**Tutorial: Build a carer app from a template**](/getting-started-with-buzzy/tutorial-carer-app-from-a-template.md) is the quickest way to see the whole Builder MCP workflow end to end.
{% endhint %}

## Buzzy Custom MCP

Use **Buzzy Custom MCP** when you have a Buzzy app and want that app to be available to AI assistants such as ChatGPT or Claude.

This is the app-exposure workflow: Buzzy generates MCP tools from your app's datatables, functions, permissions, and screens so authenticated users can query data, create records, perform actions, and view widgets through an AI assistant.

Start here if you want to:

* enable MCP for an app you built in Buzzy
* let users interact with app data through ChatGPT, Claude, or another MCP-aware client
* understand generated MCP tools, OAuth, widgets, and app security rules
* test that REST API, runtime, and MCP access return the same allowed data for each user

{% content-ref url="/pages/x9pefXfFm2ds0lbP1Fv7" %}
[Buzzy Custom MCP](/the-building-blocks/mcp/buzzy-custom-mcp.md)
{% endcontent-ref %}

## Shared MCP Concepts

The Model Context Protocol is an open standard that lets AI assistants interact with external applications and data sources in a structured way. In both Buzzy workflows, MCP provides the bridge between an AI client and Buzzy, while Buzzy handles app structure, data, permissions, and runtime behavior.

When you need the canonical definition of Buzzy row data, metadata fields, parent-child relationships, or linked-table values, refer to the REST API docs:

* [Row Metadata and Relationships](/rest-api/buzzy-rest-api/rest-api/microapp-data-operations/row-metadata-and-relationships.md)
* [microappdata](/rest-api/buzzy-rest-api/rest-api/microapp-data-operations/microappdata.md)
* [microappdata/row](/rest-api/buzzy-rest-api/rest-api/microapp-data-operations/microappdata-row.md)


---

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