Deploy/get_private_repo_deploy_status
Tool · Deploy

get_private_repo_deploy_status

Get the current deployment status for a private-repo (.cpanel.yml-managed) deploy on one domain on one of the caller's hosting services. This is the read-status companion to deploy_private_repo (cPanel VersionControl lineage) — distinct from get_deploy_status, which covers the URL-deploy lineage. Returns repository_root, branch, current_ref, commit_sha, last_deploy_outcome, and last_deployed_at for the active deployment. last_deployed_at is an ISO date-time. Requires the read:deploy scope.

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 private-repo deploy state to read. Must belong to the hosting service.

Response #

200 · application/json

private_repo_deploy_statusobject
service_idinteger
target_domainstring
repository_rootstring
branchstring
current_refstring
commit_shastring
last_deploy_outcomestring
last_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.