---
title: MCP tools
description: The deploy tools on the Agent Lab MCP server. An AI tool can do what you can do in the console, and nothing more.
url: https://agentlab.cresclab.com/docs/en/deploy/mcp-tools
language: en
updated: 2026-10-06
---

# MCP tools

The deploy tools on the Agent Lab MCP server. An AI tool can do what you can do in the console, and nothing more.

## Endpoint

```text
https://api.agentlab.cresclab.com/v1/mcp
```

See [Deploy with an AI tool](https://agentlab.cresclab.com/docs/en/deploy/ai-agent.md#connect) to connect. Every tool takes an `organization` argument; the server says its value when the client connects.

## Apps and versions

| Tool                    | What it does                                                          |
| ----------------------- | --------------------------------------------------------------------- |
| `sites_list`            | Lists apps with their addresses and internal addresses.               |
| `sites_create`          | Creates an app. The address label can't be reused.                    |
| `sites_deploy`          | Starts a new version and returns an upload address and token.         |
| `sites_deploy_finalize` | After the upload finishes, sends the version to be built.             |
| `sites_deploy_status`   | A version's stage, failure reason, port and notices.                  |
| `sites_deploy_retry`    | Retries a version the platform failed, without a new upload.          |
| `sites_promote`         | Makes a version live. Also used to roll back.                         |
| `sites_runtime_status`  | Which version is serving and how many instances are ready.            |
| `sites_restart`         | Applies saved settings without downtime.                              |
| `sites_files`           | A version's file list: paths, sizes and hashes, never the contents.   |
| `sites_lifecycle`       | Pauses, resumes, removes or restores an app, in every branch at once. |
| `sites_purge`           | Deletes an app permanently. This can't be undone.                     |

## Scheduled jobs

| Tool                                             | What it does                                                                  |
| ------------------------------------------------ | ----------------------------------------------------------------------------- |
| `scheduled_jobs_list`, `scheduled_jobs_get`      | Lists jobs, or reads one.                                                     |
| `scheduled_jobs_create`, `scheduled_jobs_update` | Creates or changes a job. An update replaces the whole job, so read it first. |
| `scheduled_jobs_run`                             | Runs a job now.                                                               |
| `scheduled_jobs_runs`                            | Run history, and one run's log.                                               |
| `scheduled_jobs_lifecycle`                       | Pauses, resumes or deletes a job.                                             |

## Branches and docs

| Tool                | What it does                                                       |
| ------------------- | ------------------------------------------------------------------ |
| `environments_list` | Lists the organization's branches.                                 |
| `docs_read`         | Reads these docs as Markdown. Without a page it returns the index. |

> [!NOTE] Name the branch when there is more than one
> When the organization has more than one branch, every call must name one; otherwise it's refused with `environmentRequired`.

## Docs links in answers

When a deploy is refused, the failure in `sites_deploy_status` carries `help`, the Markdown address of [Troubleshoot failed deployments](https://agentlab.cresclab.com/docs/en/deploy/troubleshooting.md). Image notices carry `noticesHelp`, pointing at the [container runtime contract](https://agentlab.cresclab.com/docs/en/deploy/runtime-contract.md#notices).