Skip to content

Craftpipe/devpilot-mcp

DevPilot MCP

npm version License: MIT Tests TypeScript Node MCP

Replace 6 DevOps tools with one MCP server.
Deploy, monitor, rollback, and audit your entire DevOps lifecycle through a single AI-native interface.

Quick Start · Tools · Pro Features · Security · Architecture



See it in action

 Agent     "Deploy main to production and verify everything looks good"

 DevPilot  deploy_pipeline({
             repo: "acme/api",
             branch: "main",
             provider: "vercel",
             project_id: "acme-api",
             test_workflow: "ci.yml",
             health_url: "https://api.acme.com/health",
             sentry_project_slug: "acme-api"
           })

 Pipeline:

 Step              Status    Duration
 run_tests         success     42.1s
 trigger_deploy    success      1.2s
 health_check      success      0.3s
 error_check       success      0.8s

 Overall: success — deployed dpl_8xKpQ2 in 44.4s
 Agent     "We have an incident — what changed in the last hour?"

 DevPilot  incident_report({ project_slug: "acme-api", timeframe: "1h" })

 Timeline:

 14:02  deploy   dpl_7mNR9  branch: hotfix/auth — ready in 28s
 14:07  error    TypeError: Cannot read properties of undefined (reading 'user')
 14:07  error    UnhandledPromiseRejection in /api/auth/callback (×14)

 Correlations:

 TypeError: Cannot read ...   deploy dpl_7mNR9   confidence: HIGH
 Reason: errors appeared 5 minutes after deployment on same branch

 2 errors correlated — 2 high confidence

Architecture

graph LR
    A["AI Agent<br/>(Claude, Cursor, Windsurf)"] -->|MCP Protocol| B["DevPilot MCP"]
    B --> C["Vercel"]
    B --> D["Railway"]
    B --> N["Netlify"]
    B --> FL["Fly.io"]
    B --> E["Sentry"]
    B --> F["GitHub Actions"]
    B --> GL["GitLab CI"]
    B --> G["Health Endpoints"]

    style A fill:#1f2937,stroke:#f97316,color:#f0f6fc
    style B fill:#0d1117,stroke:#f97316,stroke-width:2px,color:#f97316
    style C fill:#161b22,stroke:#000000,color:#f0f6fc
    style D fill:#161b22,stroke:#7c3aed,color:#f0f6fc
    style N fill:#161b22,stroke:#00c7b7,color:#f0f6fc
    style FL fill:#161b22,stroke:#7b3fe4,color:#f0f6fc
    style E fill:#161b22,stroke:#362d59,color:#f0f6fc
    style F fill:#161b22,stroke:#30363d,color:#8b949e
    style GL fill:#161b22,stroke:#fc6d26,color:#f0f6fc
    style G fill:#161b22,stroke:#30363d,color:#8b949e
Loading

Quick Start

npx devpilot-mcp
Claude Desktop

Add to your claude_desktop_config.json:

  • macOS / Linux: ~/.config/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "devpilot": {
      "command": "npx",
      "args": ["devpilot-mcp"],
      "env": {
        "VERCEL_TOKEN": "your-vercel-token",
        "RAILWAY_TOKEN": "your-railway-token",
        "SENTRY_TOKEN": "your-sentry-token",
        "SENTRY_ORG": "your-sentry-org",
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}
Cursor

Add to .cursor/rules/mcp_servers.json in your project root:

{
  "mcpServers": {
    "devpilot": {
      "command": "npx",
      "args": ["devpilot-mcp"],
      "env": {
        "VERCEL_TOKEN": "your-vercel-token",
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}
Windsurf

Open settings (Cmd+Shift+P / Ctrl+Shift+P then search "MCP") and add:

{
  "mcpServers": {
    "devpilot": {
      "command": "npx",
      "args": ["devpilot-mcp"],
      "env": {
        "VERCEL_TOKEN": "your-vercel-token",
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}
With Pro License

Set the PRO_LICENSE environment variable to unlock premium tools:

{
  "mcpServers": {
    "devpilot": {
      "command": "npx",
      "args": ["devpilot-mcp"],
      "env": {
        "PRO_LICENSE": "CPK-your-license-key",
        "VERCEL_TOKEN": "your-vercel-token",
        "RAILWAY_TOKEN": "your-railway-token",
        "SENTRY_TOKEN": "your-sentry-token",
        "SENTRY_ORG": "your-sentry-org",
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}

Or from the command line:

PRO_LICENSE=CPK-your-license-key npx devpilot-mcp

Environment Variables

Variable Required For Description
VERCEL_TOKEN Vercel tools Personal access token from vercel.com/account/tokens
RAILWAY_TOKEN Railway tools API token from railway.app/account/tokens
NETLIFY_TOKEN Netlify tools Personal access token from app.netlify.com/user/applications
FLY_API_TOKEN Fly.io tools Personal access token from fly.io/user/personal_access_tokens
SENTRY_TOKEN Sentry tools Auth token from sentry.io/settings/auth-tokens
SENTRY_ORG Sentry tools Organization slug from sentry.io/settings
GITHUB_TOKEN GitHub Actions tools Personal access token with workflow scope
GITLAB_TOKEN GitLab CI tools Personal access token from gitlab.com/-/user_settings/personal_access_tokens
GITLAB_PROJECT_ID GitLab CI tools Numeric project ID from GitLab project settings
GITLAB_URL GitLab CI tools Custom GitLab instance URL (optional, defaults to gitlab.com)
PRO_LICENSE Pro tools License key from Gumroad or MCPize

Tools

Free Tools (6)

Tool Provider Description
deploy_status Vercel / Railway / Netlify / Fly.io Get recent deployments with state, URL, branch, and timing
trigger_deploy Vercel / Railway / Netlify / Fly.io Trigger a new deployment for a project and branch
get_errors Sentry Fetch recent error events with title, count, level, and stack trace
run_tests GitHub Actions / GitLab CI Trigger a CI workflow and return run ID, URL, and status
deployment_logs Vercel / Railway / Netlify / Fly.io Fetch build and runtime logs for a specific deployment
health_check HTTP Check one or more URLs — returns up/down, response time, status code

Pro Features (6)

Tool Provider Description
rollback_deploy Vercel / Railway / Netlify / Fly.io Roll back to the previous (or specified) deployment
incident_report Sentry + Vercel Correlate errors with recent deployments — returns confidence-scored timeline
deploy_pipeline All Full pipeline: test → deploy → health check → error check
cost_monitor Vercel / Railway / Netlify / Fly.io Infrastructure cost breakdown and trend over 7d / 30d / 90d
environment_sync Vercel / Railway / Netlify / Fly.io Diff env vars across environments — values are never exposed
audit_trail Internal Query the DevPilot audit log for all tool calls and outcomes

Feature Comparison

Capability Free Pro
Deployment Status & listing
Trigger Deployments
Error Monitoring (Sentry)
CI Workflows (GitHub Actions)
Deployment Logs
Health Checks
Rollback Deployments
Incident Reports with error-deploy correlation
Full Deploy Pipeline (test → deploy → verify)
Cost Monitoring
Environment Variable Sync
Audit Trail

Provider Support

Feature Vercel Railway Netlify Fly.io Sentry GitHub Actions GitLab CI
Deployment Status
Trigger Deploy
Deployment Logs
Rollback
Cost Monitor
Environment Sync
Error Monitoring
Incident Correlation✅ source✅ errors
CI Trigger / Run Tests

Security

No Stored Credentials No Telemetry MIT License Audit Trail

Principle Details
No stored credentials API tokens are passed via environment variables — DevPilot never stores or transmits them
Values never exposed environment_sync compares key names only — env var values are masked and never returned
Audit trail Every Pro tool call is logged to a local SQLite audit log for compliance review
Per-call token injection Tokens are read from process.env at call time — rotate without restarting the server
No telemetry Zero analytics, zero phone-home. All data stays in your environment

Best Practices

# Never hardcode tokens — use environment variables
VERCEL_TOKEN=xxx GITHUB_TOKEN=yyy npx devpilot-mcp

# Use scoped tokens with minimal permissions
# Vercel: read-only token for deploy_status, full token for trigger_deploy
# GitHub: token with only workflow scope for run_tests

# Review the audit log regularly (Pro)
# → call audit_trail({ timeframe: "7d" })

Pro License

Unlock rollback, incident reports, full deploy pipelines, cost monitoring, environment sync, and the audit trail.

Get your license:

# Activate
export PRO_LICENSE=CPK-your-license-key
npx devpilot-mcp

# Or inline
PRO_LICENSE=CPK-your-license-key npx devpilot-mcp

Built by Craftpipe — AI-powered developer tools

GitHub · npm · Support

MIT License © 2026 Craftpipe

About

Unified DevOps lifecycle MCP server — deploy, test, monitor, rollback across Vercel, Railway, Sentry, and GitHub Actions through AI coding agents

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors