Depot

io.usefulapiv1.0.0Updated Sep 29, 2026

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

Overview

AI-generated overview

Lets an assistant inspect Depot projects, container builds, CI runs and GitHub Actions runners, and retry or cancel CI work.

What it does
A hosted MCP server that exposes Depot through read and write tools. Read tools cover projects, builds, build steps and their logs, registry images, organization usage, Depot CI runs, workflows, jobs and job logs, failure diagnosis, and GitHub Actions jobs, logs, analytics and runner-size recommendations. Write tools create a project, retry a CI job or a workflow's failed jobs, and cancel a CI run. Two meta tools report free-tier usage and offer a Pro upgrade.
When to use it
Useful when an assistant needs to check why a Depot build or CI run failed, read job logs, review runner usage or GitHub Actions analytics, or trigger a retry or cancel without opening the Depot dashboard.
Requirements
A remote endpoint at no local install or package. You must supply a Depot organization API token on first connect, which is validated and stored per user. Network access to the endpoint is required.
Before you install
The server asks for a Depot organization API token, which is stored per user rather than in config files. Several tools mutate data: creating a project, retrying jobs, and cancelling a CI run, so clients should confirm them. A free tier is limited to 100 tool calls per month, and a meta tool can upgrade to a paid Pro plan.

Installation

In SourceWeft

  1. Open Depot 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.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "depot": {
      "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

Add to Claude

json
{  "mcpServers": {    "depot": {      "url": "https://depot.usefulapi.io/mcp"    }  }}

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_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_upgrademetaUpgrade to Pro (unlimited)

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

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited

License

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

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

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestSep 29, 2026