DevRamps MCP Server

An MCP (Model Context Protocol) server that enables AI agents and MCP-compatible tools to create, manage, and debug CI/CD pipelines on the DevRamps platform.

Works with Claude Code, Cursor, and any MCP-compatible client.

Setup

Install

npm install -g @devramps/mcp-server

Configure your MCP client

Add the DevRamps MCP server to your client's configuration:

{
  "mcpServers": {
    "devramps": {
      "command": "npx",
      "args": ["@devramps/mcp-server"],
      "env": {
        "DEVRAMPS_API_KEY": "<your api key>",
        "DEVRAMPS_ORG_ID": "<your organization id>",
        "DEVRAMPS_API_URL": "https://devramps.com"
      }
    }
  }
}

• DEVRAMPS_API_KEY (required for API tools) — Create one at app.devramps.com/settings/api-keys
• DEVRAMPS_ORG_ID (required for API tools) — Your organization ID from the DevRamps dashboard
• DEVRAMPS_API_URL (optional) — Override the API endpoint (default: https://devramps.com). Set to e.g. http://localhost:3000 for local development

Local-only tools (validate-pipeline, scaffold-pipeline, generate-iam-policies) work without API credentials.

Tools

Creating Pipelines (local, no API needed)

| Tool | Description | |------|-------------| | validate-pipeline | Validate a pipeline definition YAML against the DevRamps schema | | scaffold-pipeline | Generate a .devramps/ directory with pipeline config for a project | | generate-iam-policies | Analyze Terraform files and generate IAM policies |

Pipeline Management (requires API key)

| Tool | Description | |------|-------------| | list-pipelines | List all pipelines with status summaries | | get-pipeline-state | Get detailed state of a pipeline and all its stages | | get-stage-health | Get health metrics for a stage (success rate, deploy times) | | retry-stage | Retry a failed stage deployment | | cancel-stage | Cancel an in-progress stage deployment | | stop-pipeline | Stop a pipeline from promoting revisions | | start-pipeline | Resume a stopped pipeline | | stop-stage-promotion | Block a stage from receiving new revisions | | start-stage-promotion | Resume promotion for a stage | | bypass-stage-blockers | Force-bypass blockers on a stage |

Debugging (requires API key)

| Tool | Description | |------|-------------| | get-step-logs | Retrieve execution logs for a specific step | | get-pipeline-events | List pipeline events for deployment history | | list-revisions | List pipeline revisions with commit info |

Resources

| Resource | Description | |----------|-------------| | pipeline-schema | Pipeline definition YAML format reference | | step-type-docs | Documentation for all available step types |

Prompts

| Prompt | Description | |--------|-------------| | scaffold-project | Guided workflow to scaffold a pipeline for a project | | debug-deployment | Guided workflow to diagnose a failed deployment |

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Run tests
npm test

License

MIT