depot
Inspect Depot builds, CI runs, job logs and Actions runners; retry or cancel CI runs.
사용해야 할까요
품질 및 안전성
발견 사항 (5)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains suspicious base64-like encoded stringdepot_gha_list_jobs에서
- MEDIUMTool description contains suspicious base64-like encoded stringdepot_gha_search_logs에서
- MEDIUMTool description contains suspicious base64-like encoded stringdepot_gha_get_analytics에서
- MEDIUMTool description contains suspicious base64-like encoded stringdepot_gha_list_recommendations에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"depot": {
"url": "https://depot.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://depot.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (22)
🟢depot_list_projects(region_id, page_size, page_token)
List the organization's Depot projects. A project is an isolated container-build cache (region, hardware, cache policy). Use the returned projectId with the build and registry tools. Depot: ProjectService/ListProjects.
입력 스키마
{
"type": "object",
"properties": {
"region_id": {
"description": "Only projects in this region or cloud connection, e.g. us-east-1.",
"type": "string"
},
"page_size": {
"description": "Page size, 1-250.",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page_token": {
"description": "Cursor from the previous response's nextPageToken. Omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_get_project(project_id)
Get one Depot project — name, region, hardware size, cache policy, build timeout and autoscaling. Depot: ProjectService/GetProject.
입력 스키마
{
"type": "object",
"properties": {
"project_id": {
"type": "string",
"minLength": 1,
"description": "Project id, from depot_list_projects."
}
},
"required": [
"project_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_list_builds(project_id, page_size, page_token)
List container builds in a project, newest first: status (STATUS_RUNNING / FAILED / SUCCESS / ERROR / CANCELED), timestamps, build duration, time saved by cache, and cached vs total steps. Depot: core BuildService/ListBuilds.
입력 스키마
{
"type": "object",
"properties": {
"project_id": {
"type": "string",
"minLength": 1,
"description": "Project id, from depot_list_projects."
},
"page_size": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"page_token": {
"description": "Cursor from the previous response's nextPageToken. Omit for the first page.",
"type": "string"
}
},
"required": [
"project_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_get_build(build_id)
Get one container build's status, timestamps, duration, time saved and cached/total step counts. Depot: core BuildService/GetBuild.
입력 스키마
{
"type": "object",
"properties": {
"build_id": {
"type": "string",
"minLength": 1,
"description": "Build id, from depot_list_builds."
}
},
"required": [
"build_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_get_build_steps(project_id, build_id, page_size, page_token)
List the BuildKit steps of a container build: name, digest, start/end time, cache state (CACHED / UNCACHED), any error, and whether it has logs. Find the failing step here, then pass its digest to depot_get_build_step_logs. Depot: build.v1 BuildService/GetBuildSteps.
입력 스키마
{
"type": "object",
"properties": {
"project_id": {
"type": "string",
"minLength": 1,
"description": "Project id the build belongs to."
},
"build_id": {
"type": "string",
"minLength": 1,
"description": "Build id, from depot_list_builds."
},
"page_size": {
"description": "Page size, 1-1000.",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"page_token": {
"description": "Cursor from the previous response's nextPageToken. Omit for the first page.",
"type": "string"
}
},
"required": [
"project_id",
"build_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_get_build_step_logs(project_id, build_id, step_digest, page_size, page_token)
Get the log lines (message + timestamp) of one container-build step, identified by its digest from depot_get_build_steps. Depot: build.v1 BuildService/GetBuildStepLogs.
입력 스키마
{
"type": "object",
"properties": {
"project_id": {
"type": "string",
"minLength": 1,
"description": "Project id the build belongs to."
},
"build_id": {
"type": "string",
"minLength": 1,
"description": "Build id."
},
"step_digest": {
"type": "string",
"minLength": 1,
"description": "The step's digest, from depot_get_build_steps."
},
"page_size": {
"description": "Page size, 1-1000.",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"page_token": {
"description": "Cursor from the previous response's nextPageToken. Omit for the first page.",
"type": "string"
}
},
"required": [
"project_id",
"build_id",
"step_digest"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_list_registry_images(project_id, page_size, page_token)
List the images stored in a project's Depot Registry: tag, digest, pushedAt and sizeBytes. Depot: build.v1 RegistryService/ListImages.
입력 스키마
{
"type": "object",
"properties": {
"project_id": {
"type": "string",
"minLength": 1,
"description": "Project id, from depot_list_projects."
},
"page_size": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"page_token": {
"description": "Cursor from the previous response's nextPageToken. Omit for the first page.",
"type": "string"
}
},
"required": [
"project_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_get_usage(start_at, end_at)
Get the organization's Depot usage over a window: container builds per project (build count, minutes saved, minutes billed), GitHub Actions jobs per repo/workflow/runner (minutes elapsed and billed), storage, and agent sandboxes. Depot: UsageService/GetUsage.
입력 스키마
{
"type": "object",
"properties": {
"start_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "Window start, RFC 3339 (e.g. 2026-09-01T00:00:00Z)."
},
"end_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "Window end, RFC 3339 (e.g. 2026-09-30T00:00:00Z)."
}
},
"required": [
"start_at",
"end_at"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_ci_list_runs(status, repo, sha, trigger, pr, ...)
List Depot CI runs, newest first. Filter by status (default: running + queued — pass ["failed"] to find failures), repo, commit SHA prefix, trigger event, or pull request number (requires repo). Depot: CIService/ListRuns.
입력 스키마
{
"type": "object",
"properties": {
"status": {
"description": "Run statuses to include (ORed). Default on Depot's side: running and queued.",
"type": "array",
"items": {
"type": "string",
"enum": [
"queued",
"running",
"finished",
"failed",
"cancelled"
]
}
},
"repo": {
"description": "Repository in owner/name format, e.g. depot/cli.",
"type": "string"
},
"sha": {
"description": "Commit SHA prefix (1-40 hex chars).",
"type": "string",
"pattern": "^[0-9a-fA-F]{1,40}$"
},
"trigger": {
"description": "Trigger event, e.g. push, pull_request, schedule, workflow_dispatch.",
"type": "string"
},
"pr": {
"description": "Pull request number. Requires repo.",
"type": "string"
},
"page_size": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"page_token": {
"description": "Cursor from the previous response's nextPageToken. Omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_ci_get_run_status(run_id)
Get a Depot CI run's status with its nested workflows, jobs and attempts (ids, keys, statuses, error messages). This is how to find the workflowId / jobId / attemptId for the log, diagnosis and retry tools. Depot: CIService/GetRunStatus.
입력 스키마
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"description": "CI run id, from depot_ci_list_runs."
}
},
"required": [
"run_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_ci_list_workflows(name, repo, status, trigger, sha, ...)
List Depot CI workflows across runs, newest first, with per-status job counts. Filter by name/path text, repo, status, trigger, SHA prefix or PR number. Depot: CIService/ListWorkflows.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"description": "Text to match in the workflow name or file path.",
"type": "string"
},
"repo": {
"description": "Repository in owner/name format.",
"type": "string"
},
"status": {
"description": "Workflow statuses to include (ORed).",
"type": "array",
"items": {
"type": "string",
"enum": [
"queued",
"running",
"finished",
"failed",
"cancelled"
]
}
},
"trigger": {
"description": "Trigger event, e.g. push or pull_request.",
"type": "string"
},
"sha": {
"description": "Commit SHA prefix (1-40 hex chars).",
"type": "string",
"pattern": "^[0-9a-fA-F]{1,40}$"
},
"pr": {
"description": "Pull request number.",
"type": "string"
},
"page_size": {
"description": "Page size, 1-200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_ci_get_job(job_id)
Get one Depot CI job: status, conclusion, error message, timestamps, runner config (labels, image, CPUs, memory), matrix values, parent run/workflow context, dependencies and attempt history. Depot: CIService/GetJob.
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"minLength": 1,
"description": "CI job id, from depot_ci_get_run_status."
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_ci_get_job_logs(job_id, attempt_id, page_token)
Get persisted log lines for a Depot CI job attempt, oldest first (step key/name, timestamp, line number, body). Pass job_id to read the job's latest attempt, or attempt_id for a specific one — exactly one. Pass nextPageToken back as page_token for more lines. Depot: CIService/GetJobAttemptLogs.
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"description": "CI job id — resolves to its latest attempt.",
"type": "string"
},
"attempt_id": {
"description": "A specific attempt id.",
"type": "string"
},
"page_token": {
"description": "Cursor from the previous response's nextPageToken. Omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_ci_get_failure_diagnosis(target_type, target_id)
Get Depot's failure diagnosis for a CI run, workflow, job or attempt. For runs and workflows, identical failures are grouped by error fingerprint; for a job or attempt it is a focused diagnosis with evidence. Empty when no failure evidence is found. The best first call when a run failed. Depot: CIService/GetFailureDiagnosis.
입력 스키마
{
"type": "object",
"properties": {
"target_type": {
"type": "string",
"enum": [
"run",
"workflow",
"job",
"attempt"
],
"description": "What target_id identifies."
},
"target_id": {
"type": "string",
"minLength": 1,
"description": "The run, workflow, job or attempt id."
}
},
"required": [
"target_type",
"target_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_gha_list_jobs(repositories, statuses, conclusions, runner_labels, query, ...)
List GitHub Actions jobs that ran on Depot-managed runners, newest first: status, conclusion, runner label, requested CPU/memory, duration, billable time and GitHub URL. Defaults to the last 30 days (max window 90 days). Depot: GithubActionsService/ListGithubActionsJobs.
입력 스키마
{
"type": "object",
"properties": {
"repositories": {
"description": "Connected repositories in owner/name format, e.g. [\"acme/widgets\"]. Empty = all.",
"type": "array",
"items": {
"type": "string"
}
},
"statuses": {
"description": "Job states to include.",
"type": "array",
"items": {
"type": "string",
"enum": [
"queued",
"waiting",
"running",
"finished"
]
}
},
"conclusions": {
"description": "Job conclusions to include, e.g. [\"failure\"].",
"type": "array",
"items": {
"type": "string",
"enum": [
"success",
"failure",
"cancelled",
"skipped",
"neutral"
]
}
},
"runner_labels": {
"description": "Runner labels to include.",
"type": "array",
"items": {
"type": "string"
}
},
"query": {
"description": "Case-insensitive text matched against job and workflow names; numeric values also match exact GitHub job/run ids.",
"type": "string"
},
"start_at": {
"description": "Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z).",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"end_at": {
"description": "Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z).",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"page_size": {
"description": "Page size, 1-250.",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page_token": {
"description": "Cursor from the previous response's nextPageToken. Omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_gha_search_logs(query, start_at, end_at, repositories, workflows, ...)
Search GitHub Actions log lines from Depot runners, newest match first (job, workflow, step, timestamp, body, lineId). Defaults to the last hour (max window 30 days). Filter by repository, workflow, runner label, action or compute id. Depot: GithubActionsService/SearchGithubActionsLogs.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"description": "Text to match in log bodies, e.g. \"timeout\". Empty returns unfiltered lines.",
"type": "string"
},
"start_at": {
"description": "Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z).",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"end_at": {
"description": "Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z).",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"repositories": {
"description": "Connected repositories in owner/name format, e.g. [\"acme/widgets\"]. Empty = all.",
"type": "array",
"items": {
"type": "string"
}
},
"workflows": {
"description": "Workflow names to include.",
"type": "array",
"items": {
"type": "string"
}
},
"runner_labels": {
"description": "Runner labels to include.",
"type": "array",
"items": {
"type": "string"
}
},
"actions": {
"description": "Actions to include, e.g. actions/checkout.",
"type": "array",
"items": {
"type": "string"
}
},
"compute_id": {
"description": "A single Depot compute id.",
"type": "string"
},
"page_size": {
"description": "Page size, 1-1000.",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"page_token": {
"description": "Cursor from the previous response's nextPageToken. Omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_gha_get_analytics(start_at, end_at, aggregation_unit, repositories, workflows, ...)
Get time-bucketed GitHub Actions analytics for Depot runners: job counts (successful/failed/cancelled), failure rate, elapsed and billable seconds, average duration — as totals plus hourly or daily buckets. Defaults to the last 30 days (max 90). Depot: GithubActionsService/GetGithubActionsAnalytics.
입력 스키마
{
"type": "object",
"properties": {
"start_at": {
"description": "Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z).",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"end_at": {
"description": "Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z).",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"aggregation_unit": {
"description": "Bucket size. Default: day.",
"type": "string",
"enum": [
"hour",
"day"
]
},
"repositories": {
"description": "Connected repositories in owner/name format, e.g. [\"acme/widgets\"]. Empty = all.",
"type": "array",
"items": {
"type": "string"
}
},
"workflows": {
"description": "Workflow names to include.",
"type": "array",
"items": {
"type": "string"
}
},
"jobs": {
"description": "Job display names to include.",
"type": "array",
"items": {
"type": "string"
}
},
"runner_labels": {
"description": "Runner labels to include, e.g. depot-ubuntu-24.04-8.",
"type": "array",
"items": {
"type": "string"
}
},
"workflow_paths": {
"description": "Workflow file paths to include, e.g. .github/workflows/ci.yml.",
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢depot_gha_list_recommendations(start_at, end_at, repositories, workflows, jobs, ...)
List Depot's runner-size recommendations from job CPU and memory metrics: SIZE_UP when average CPU or memory reaches 90%, SIZE_DOWN when both averages stay ≤30% and peaks ≤70%, with current vs suggested size and per-minute price. Defaults to the last 30 days. Depot: GithubActionsService/ListGithubActionsRecommendations.
입력 스키마
{
"type": "object",
"properties": {
"start_at": {
"description": "Window start, RFC 3339 (e.g. 2026-09-17T00:00:00Z).",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"end_at": {
"description": "Window end, RFC 3339 (e.g. 2026-09-18T00:00:00Z).",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"repositories": {
"description": "Connected repositories in owner/name format, e.g. [\"acme/widgets\"]. Empty = all.",
"type": "array",
"items": {
"type": "string"
}
},
"workflows": {
"description": "Workflow names to include.",
"type": "array",
"items": {
"type": "string"
}
},
"jobs": {
"description": "Job display names to include.",
"type": "array",
"items": {
"type": "string"
}
},
"runner_labels": {
"description": "Runner labels to include, e.g. depot-ubuntu-24.04-8.",
"type": "array",
"items": {
"type": "string"
}
},
"workflow_paths": {
"description": "Workflow file paths to include, e.g. .github/workflows/ci.yml.",
"type": "array",
"items": {
"type": "string"
}
},
"page_size": {
"description": "Page size, 1-250.",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page_token": {
"description": "Cursor from the previous response's nextPageToken. Omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴depot_create_project(name, region_id, organization_id, cache_keep_gb, cache_keep_days, ...)
WRITE. Create a Depot container-build project (an isolated build cache). Idempotent by name: if an active project with the same name exists, that project is returned. Defaults: cache 50 GB / 14 days, hardware HARDWARE_16X32 on AWS builders. Depot: ProjectService/CreateProject.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Display name for the project."
},
"region_id": {
"type": "string",
"minLength": 1,
"description": "Depot region or cloud connection, e.g. us-east-1 or eu-central-1."
},
"organization_id": {
"description": "Owning organization. Only needed for user tokens that belong to more than one org.",
"type": "string"
},
"cache_keep_gb": {
"description": "Max cache size per architecture, GB (25-1000). Default 50.",
"type": "integer",
"minimum": 25,
"maximum": 1000
},
"cache_keep_days": {
"description": "Days to keep cache entries since last use (1-30). Default 14.",
"type": "integer",
"minimum": 1,
"maximum": 30
},
"hardware": {
"description": "Builder size, e.g. HARDWARE_16X32 (16 CPU / 32 GB).",
"type": "string",
"enum": [
"HARDWARE_4X4",
"HARDWARE_4X8",
"HARDWARE_8X8",
"HARDWARE_8X16",
"HARDWARE_16X32",
"HARDWARE_32X64",
"HARDWARE_64X128",
"HARDWARE_96X192",
"HARDWARE_192X384",
"HARDWARE_384X768"
]
},
"build_timeout_minutes": {
"description": "Max duration of each build, minutes. Omit for no timeout.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"max_concurrent_builds": {
"description": "Builds per builder before autoscaling adds one. Omit to disable autoscaling.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"name",
"region_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴depot_ci_retry_job(workflow_id, job_id)
WRITE — starts compute. Retry one failed or cancelled Depot CI job, plus any skipped jobs that depend on it. Fails if a dependent job already started; use depot_ci_retry_failed_jobs then. Depot: CIService/RetryJob.
입력 스키마
{
"type": "object",
"properties": {
"workflow_id": {
"type": "string",
"minLength": 1,
"description": "Workflow id containing the job, from depot_ci_get_run_status."
},
"job_id": {
"type": "string",
"minLength": 1,
"description": "Job id to retry."
}
},
"required": [
"workflow_id",
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴depot_ci_retry_failed_jobs(workflow_id)
WRITE — starts compute. Retry only the failed and cancelled jobs in a Depot CI workflow, plus skipped jobs that depend on them. Jobs that succeeded are left alone. Depot: CIService/RetryFailedJobs.
입력 스키마
{
"type": "object",
"properties": {
"workflow_id": {
"type": "string",
"minLength": 1,
"description": "Workflow id, from depot_ci_get_run_status or depot_ci_list_workflows."
}
},
"required": [
"workflow_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴depot_ci_cancel_run(run_id)
WRITE — stops work in progress. Cancel a queued or running Depot CI run and all of its unfinished workflows, jobs and attempts. Cancelled jobs can be retried afterwards with depot_ci_retry_failed_jobs. Depot: CIService/CancelRun.
입력 스키마
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"description": "CI run id, from depot_ci_list_runs."
}
},
"required": [
"run_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거