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.

Last updated 2026-10-06

View Markdown Open in Claude Open in ChatGPT

Endpoint#

text

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

See Deploy with an AI tool to connect. Every tool takes an organization argument; the server says its value when the client connects.

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.

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.

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.

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.

When a deploy is refused, the failure in sites_deploy_status carries help, the Markdown address of Troubleshoot failed deployments. Image notices carry noticesHelp, pointing at the container runtime contract.