Deploy/get_deploy_status
Tool · Deploy

get_deploy_status

Get the current deploy marker and deploy history for one domain on one of the caller's hosting services: current = the repo_url, ref, commit_sha, and deployed_at currently live at the target (null when nothing has been deployed there); history = past deploys, each with the same fields. Pass a ref from history back to deploy_site_from_url to roll back. Requires the read:deploy scope. deployed_at is an ISO date-time.

Read-onlyIdempotentOpen‑worldscope read:deploy

Invoked over the MCP transport with a tools/call request naming this tool.

Authorization #

Requires a valid OAuth 2.1 bearer access_token whose grant includes the read:deploy scope — View the deployment status and history of your websites. The broker resolves the caller from the token and returns only records the account owns.

Parameters #

service_idintegerRequired
The hosting service ID the target domain belongs to. Obtain it via list_services.
target_domainstringRequired
The hosted domain whose deploy state to read. Must belong to the hosting service.

Response #

200 · application/json

deploy_statusobject
service_idinteger
target_domainstring
currentobject · null
historyarray<object>
repo_urlstring
refstring
commit_shastring
deployed_atstring
module_versionstring

Errors #

ResultWhen
{ "error": "invalid_target_domain" }See the tool description for when this result is returned.
{ "error": "not_found" }The requested item does not exist, or it belongs to another account. Cross-account IDs are indistinguishable from missing ones by design.