---
title: Tools
slug: docs/1uWp-mcp-tools
description: Every tool of the Back4app MCP server: account, applications, deployments and logs, and which ones change your applications.
createdAt: 2026-11-04T17:49:19.279Z
---

Back4app MCP tools let your AI assistant deploy and manage your applications. Describe what you want, and your assistant picks the tools and fills in their parameters.

**Read** tools only read. **Write** tools create or change something. **Confirm** marks the two-step changes that show you a summary first.

## Account

| Tool     | Type | What it does                                                                                                            |
| -------- | ---- | ----------------------------------------------------------------------------------------------------------------------- |
| `whoami` | Read | The account this connection works with: your Back4app account, or a temporary account with its deadline and claim link. |

You choose the account when your client connects: sign in, or continue without an account.

## Applications

| Tool             | Type           | What it does                                                                                                                            |
| ---------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `list_web_apps`  | Read           | Your applications, newest first: state, URL, plan and last deployment.                                                                  |
| `get_web_app`    | Read           | One application in full: code source, builder, port, start command, health check, plan, URL and the names of its environment variables. |
| `create_web_app` | Write          | Creates an application from a folder of code and starts its first deployment.                                                           |
| `update_web_app` | Write, confirm | Changes settings or environment variables and deploys again.                                                                            |

## Deployments

| Tool               | Type           | What it does                                                                                         |
| ------------------ | -------------- | ---------------------------------------------------------------------------------------------------- |
| `create_upload`    | Write          | For an agent with a terminal: the command that packs your folder and sends it to Back4app.           |
| `deploy_web_app`   | Write          | Deploys new code to an existing application, or deploys its latest code again.                       |
| `get_deployment`   | Read           | One deployment: status, phase, URL once ready; the error and the end of the build log when it fails. |
| `list_deployments` | Read           | An application's deployments, newest first.                                                          |
| `rollback_web_app` | Write, confirm | Puts an application back on its previous version.                                                    |
| `confirm_action`   | Write          | Runs a change you approved after seeing its summary, such as a rollback.                             |

## Logs

| Tool               | Type | What it does                                                                                   |
| ------------------ | ---- | ---------------------------------------------------------------------------------------------- |
| `get_build_logs`   | Read | A deployment's log: fetching the code, the build, starting the container and the health check. |
| `get_runtime_logs` | Read | What the running container wrote. Back4app keeps the last 100 lines.                           |

## Limits

- Code sent in a tool call (with no terminal): up to 200 files and 5 MB.
- Temporary account: 24 hours, one application, Free plan, buildpack only.
- Runtime logs: last 100 lines. Build logs: up to the last 500 lines per request.
