> ## Documentation Index
> Fetch the complete documentation index at: https://developers.zite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Build with agents

> The Zite MCP lets an AI agent build and edit Zite apps in a cloud sandbox — using your own model, with no Zite AI credits.

The **Zite MCP** is a [Model Context Protocol](https://modelcontextprotocol.io) server that gives an AI
agent — Claude, ChatGPT, Cursor, or any MCP client — the tools to create workspaces, edit code in a cloud
sandbox, run checks, and publish apps. It feels like Claude Code operating on a Zite app, and it uses
**your** model, so no Zite AI credits are spent.

It's one server at `https://mcp.zite.com/mcp` with two tool groups on a single connection: **17 build tools**
(create / edit / commit / publish apps) and **16 data tools** (read / write records). The agent acts **as
you** — scoped to your workspaces, every change attributed to you.

<CardGroup cols={2}>
  <Card title="Connect" icon="plug" href="/mcp/connect">
    Add `mcp.zite.com/mcp` to your AI tool and authorize it.
  </Card>

  <Card title="The build loop" icon="repeat" href="/mcp/build-loop">
    From an empty sandbox to a published app.
  </Card>

  <Card title="Build tools" icon="wrench" href="/mcp/build-tools">
    Reference for the 17 build tools.
  </Card>

  <Card title="Data tools" icon="database" href="/api/mcp/overview">
    16 data tools for reading and writing records.
  </Card>
</CardGroup>

<Tip>
  Automating builds from CI or your own backend? The [Build API](/build-api/overview) exposes these same
  operations as REST.
</Tip>

## All tools

Every tool below is available on one connection to `https://mcp.zite.com/mcp`. Build tools are documented
in full on [Build tools](/mcp/build-tools); data tools on [Data tools](/api/mcp/tools).

| Group               | Tool                  | Description                                                                      |
| ------------------- | --------------------- | -------------------------------------------------------------------------------- |
| **Workspaces**      | `create_workspace`    | Create a new, empty workspace (a database with no tables)                        |
|                     | `list_workspaces`     | List every workspace you can access, with its apps and forms                     |
|                     | `get_workspace`       | Read one workspace — its apps, forms, and project overview                       |
| **Sandboxes**       | `create_sandbox`      | Boot a build sandbox for a workspace and return the framework guide              |
|                     | `create_app`          | Scaffold an empty app in the sandbox (free — no AI build runs)                   |
| **Files & editing** | `list_files`          | List files in the sandbox, with a substring or glob filter                       |
|                     | `grep`                | Regex search across the sandbox's code                                           |
|                     | `read_file`           | Read a file, optionally a line range                                             |
|                     | `edit_file`           | Replace an exact string in a file — the primary way to change code               |
|                     | `write_file`          | Create a new file or fully rewrite one                                           |
|                     | `bash`                | Run a shell script in the sandbox (npm installs, git, one-off scripts)           |
| **Checks & logs**   | `check_app`           | Regenerate types, then type-check and validate app config                        |
|                     | `get_logs`            | Read workflow run logs — inputs, output, console, stack traces                   |
| **Ship**            | `commit`              | Type-check, commit and push, then build and snapshot in the background           |
|                     | `publish_app`         | Take the latest successful build live                                            |
| **Integrations**    | `setup_integration`   | List connectable services, attach an existing connection, or return an OAuth URL |
| **Feedback**        | `send_feedback`       | Report a platform problem to the Zite team                                       |
| **Schema**          | `get_database_schema` | Get every table and field in a database in one call                              |
|                     | `get_table_schema`    | Get the fields for a single table                                                |
|                     | `create_table`        | Create a table with the given fields                                             |
|                     | `update_table`        | Rename a table                                                                   |
|                     | `delete_table`        | Permanently delete a table and its records                                       |
|                     | `create_field`        | Add a field (column) to a table                                                  |
|                     | `update_field`        | Change a field's name, type, or configuration                                    |
|                     | `delete_field`        | Permanently delete a field and its data                                          |
| **Records**         | `query_records`       | Query records with filtering, sorting, and pagination                            |
|                     | `get_record`          | Get a single record by ID                                                        |
|                     | `create_record`       | Create a record                                                                  |
|                     | `update_record`       | Update a record's fields                                                         |
|                     | `delete_record`       | Delete a record                                                                  |
|                     | `bulk_create_records` | Create many records in one call                                                  |
|                     | `bulk_update_records` | Update many records in one call                                                  |
| **SQL**             | `execute_sql`         | Run a read-only SQL query using human-readable table and field names             |

<Note>
  If the sandbox, commit, and publish tools don't appear in your client's tool list, app building isn't
  enabled for your organization yet. The workspace tools, the data tools, and `send_feedback` are always
  available.
</Note>
