Depot MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.40.2Updated Nov 14, 2026

Inspect Depot builds, CI runs, job logs and Actions runners; retry or cancel CI runs.

The publisher's own server: Ably MCP by usefulapi

Overview

AI-generated overview

Inspect Depot container builds, CI runs, job logs and GitHub Actions runner usage, and retry or cancel CI work.

What you can do
  • List and inspect projects, builds, build steps and step logs, plus registry images
  • List Depot CI runs, workflows, jobs and job logs, and get failure diagnoses
  • Review GitHub Actions jobs on Depot runners, search their logs, view analytics and runner-size recommendations
  • Check organization usage and list cache entries
  • Create projects, delete cache entries, retry failed jobs and cancel runs (write tools)
When to use it
Useful when you work with Depot for container builds or CI and want an assistant to answer questions like which runs failed and why, how much caching saved, or how runner usage looks, and to retry or cancel CI work without leaving the chat.
Requirements
Remote MCP endpoint connected by URL only; no local install. Sign-in uses OAuth, and on first connect you supply a Depot organization API token from Organization Settings. No API key or Authorization header goes in the client config. A free plan allows 50 tool calls per month; paid plans raise the limit.
Before you install
Write tools change data: creating projects, deleting cache entries (previewed unless confirmed), retrying jobs and cancelling runs, which starts or stops compute. The server also offers subscription upgrade and cancellation tools that return payment links and can charge money. Your Depot organization token is stored per user on the hosted service, so review the provider's handling before connecting.

Installation

In SourceWeft

  1. Open Depot MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fdepot/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "depot-by-usefulapi": {
      "type": "http",
      "url": "https://depot.usefulapi.io/mcp"
    }
  }
}

README

Depot MCP by usefulapi

Use Depot from Claude, Cursor, or any MCP client — inspect projects, container builds, build steps and logs, Depot CI runs and jobs, and GitHub Actions runner usage, and retry or cancel CI work. Hosted, no local install: connect with your own Depot credentials.

Live endpoint: https://depot.usefulapi.io/mcp · Homepage: https://usefulapi.io/depot

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://depot.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http depot https://depot.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "depot": {      "url": "https://depot.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Depot credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/depot/

On first connect you'll provide your Depot organization API token (Organization Settings → API Tokens). They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
depot_list_projectsreadList projects
depot_get_projectreadGet a project
depot_list_buildsreadList builds for a project
depot_get_buildreadGet a build
depot_get_build_stepsreadList a build's steps
depot_get_build_step_logsreadGet a build step's logs
depot_list_registry_imagesreadList registry images
depot_get_usagereadGet organization usage
depot_ci_list_runsreadList Depot CI runs
depot_ci_get_run_statusreadGet a CI run's status tree
depot_ci_list_workflowsreadList Depot CI workflows
depot_ci_get_jobreadGet a CI job
depot_ci_get_job_logsreadGet a CI job's logs
depot_ci_get_failure_diagnosisreadDiagnose a CI failure
depot_gha_list_jobsreadList GitHub Actions jobs on Depot runners
depot_gha_search_logsreadSearch GitHub Actions logs
depot_gha_get_analyticsreadGet GitHub Actions analytics
depot_gha_list_recommendationsreadList runner-size recommendations
depot_cache_list_entriesreadList cache entries
depot_cache_delete_entrieswriteDelete cache entries
depot_create_projectwriteCreate a project
depot_ci_retry_jobwriteRetry a CI job
depot_ci_retry_failed_jobswriteRetry a workflow's failed jobs
depot_ci_cancel_runwriteCancel a CI run
depot_usage_statusmetaUsage status (free-tier meter)
depot_request_featuremetaRequest a missing feature
depot_upgrademetaUpgrade to Pro or Pro+
depot_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run depot_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with depot_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with depot_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Depot.

Source: servers/depot/README.md at commit f22f848

Tools

24

depot_list_projects

List projects

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.

Parameterspage_sizeregion_idpage_token

depot_get_project

Get a project

Get one Depot project — name, region, hardware size, cache policy, build timeout and autoscaling. Depot: ProjectService/GetProject.

Parametersproject_idrequired

depot_list_builds

List builds for a project

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.

Parameterspage_sizepage_tokenproject_idrequired

depot_get_build

Get a build

Get one container build's status, timestamps, duration, time saved and cached/total step counts. Depot: core BuildService/GetBuild.

Parametersbuild_idrequired

depot_get_build_steps

List a build's steps

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.

Parametersbuild_idrequiredpage_sizepage_tokenproject_idrequired

depot_get_build_step_logs

Get a build step's logs

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.

Parametersbuild_idrequiredpage_sizepage_tokenproject_idrequiredstep_digestrequired

depot_list_registry_images

List registry images

List the images stored in a project's Depot Registry: tag, digest, pushedAt and sizeBytes. Depot: build.v1 RegistryService/ListImages.

Parameterspage_sizepage_tokenproject_idrequired

depot_get_usage

Get organization usage

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.

Parametersend_atrequiredstart_atrequired

depot_ci_list_runs

List Depot CI runs

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.

Parametersprsharepostatustriggerpage_sizepage_token

depot_ci_get_run_status

Get a CI run's status tree

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.

Parametersrun_idrequired

depot_ci_list_workflows

List Depot CI workflows

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.

Parametersprshanamerepostatustriggerpage_size

depot_ci_get_job

Get a CI job

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.

Parametersjob_idrequired

depot_ci_get_job_logs

Get a CI job's logs

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.

Parametersjob_idattempt_idpage_token

depot_ci_get_failure_diagnosis

Diagnose a CI failure

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.

Parameterstarget_idrequiredtarget_typerequired

depot_gha_list_jobs

List GitHub Actions jobs on Depot runners

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.

Parametersqueryend_atstart_atstatusespage_sizepage_tokenconclusionsrepositoriesrunner_labels

depot_gha_search_logs

Search GitHub Actions logs

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.

Parametersqueryend_atactionsstart_atpage_sizeworkflowscompute_idpage_tokenrepositoriesrunner_labels

depot_gha_get_analytics

Get GitHub Actions analytics

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.

Parametersjobsend_atstart_atworkflowsrepositoriesrunner_labelsworkflow_pathsaggregation_unit

depot_gha_list_recommendations

List runner-size recommendations

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.

Parametersjobsend_atstart_atpage_sizeworkflowspage_tokenrepositoriesrunner_labelsworkflow_paths

depot_cache_list_entries

List cache entries

List Depot Cache entries of one type, optionally by key prefix: key, size in bytes, name and creation time (Depot returns no last-access time and no repository). Retention and size limits are set only in the dashboard (Organization Settings), not through the API. Depot: CacheService/ListEntries on cache.depot.dev.

Parameterspage_sizeentry_typerequiredkey_prefixpage_token

depot_cache_delete_entries

Delete cache entries

WRITE — deletes cached build data; a later build rebuilds it. Delete Depot Cache entries by exact key. Without confirm it only previews: it shows which keys exist, with their size, and deletes nothing. Show the preview to the user, then call again with confirm: true. Depot: CacheService/DeleteEntry on cache.depot.dev.

Parameterskeysrequiredconfirmentry_typerequired

depot_create_project

Create a project

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.

Parametersnamerequiredhardwareregion_idrequiredcache_keep_gbcache_keep_daysorganization_idbuild_timeout_minutesmax_concurrent_builds

depot_ci_retry_job

Retry a CI job

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.

Parametersjob_idrequiredworkflow_idrequired

depot_ci_retry_failed_jobs

Retry a workflow's failed jobs

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.

Parametersworkflow_idrequired

depot_ci_cancel_run

Cancel a CI run

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.

Parametersrun_idrequired

Version history

25
  1. v1.40.2LatestNov 14, 2026
  2. v1.40.1Nov 13, 2026
  3. v1.39.0Nov 12, 2026
  4. v1.38.3Nov 11, 2026
  5. v1.37.3Nov 7, 2026
  6. v1.36.3Nov 5, 2026
  7. v1.36.2Nov 5, 2026
  8. v1.36.1Nov 4, 2026
  9. v1.36.0Nov 3, 2026
  10. v1.35.1Nov 3, 2026
  11. v1.34.0Nov 1, 2026
  12. v1.32.0Oct 31, 2026
  13. v1.31.0Oct 31, 2026
  14. v1.30.2Oct 30, 2026
  15. v1.30.0Oct 30, 2026
  16. v1.25.0Oct 26, 2026
  17. v1.22.3Oct 25, 2026
  18. v1.22.0Oct 25, 2026
  19. v1.20.0Oct 24, 2026
  20. v1.17.0Oct 23, 2026
  21. v1.16.4Oct 22, 2026
  22. v1.16.3Oct 21, 2026
  23. v1.11.1Oct 9, 2026
  24. v1.10.0Oct 9, 2026
  25. v1.0.0Sep 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations