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.
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 #
| Result | When |
|---|---|
| { "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. |