Server data from the Official MCP Registry
MCP server for GoCD: dashboard, pipelines, artifacts, agents. Context-lean output.
About
MCP server for GoCD: dashboard, pipelines, artifacts, agents. Context-lean output.
Security Report
Valid MCP server (1 strong, 4 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
6 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: GOCD_BASE_URL
Environment variable: GOCD_ACCESS_TOKEN
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-sahilll15-gocd": {
"env": {
"GOCD_BASE_URL": "your-gocd-base-url-here",
"GOCD_ACCESS_TOKEN": "your-gocd-access-token-here"
},
"args": [
"-y",
"gocd-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
gocd-mcp
An MCP server for GoCD. It exposes GoCD's REST API as MCP tools so any MCP client (Claude Code, Claude Desktop, Cursor) can read pipeline state and drive pipelines. Two implementations live here and behave identically on the wire: pick whichever fits how you want to install it.
go/— Go implementation. Ships as a single static binary or a Docker image. Fast cold start, low memory.ts/— TypeScript implementation. Runs on Node with no dependencies, sonpxneeds no build step.
Both return the same context-lean output: the dashboard is summarized by default, rows are column-oriented, and responses are compact JSON. A full GoCD dashboard is several MB across many pipelines; these tools trim it to what the model needs.
Tools
Read tools (safe):
| Tool | What it does |
|---|---|
gocd_dashboard | Dashboard health. No args = summary; filter/status/detail drill down |
gocd_pipeline_status | Paused / locked / schedulable for one pipeline |
gocd_pipeline_instance | One run: stages with per-job result, plus trigger |
gocd_pipeline_history | Recent runs for one pipeline. Optional limit |
gocd_stage_instance | One stage run with per-job state and agent |
gocd_stage_history | Recent runs of one stage |
gocd_compare | What changed between two runs: commits per material |
gocd_list_artifacts | A job's artifact files as [path, url] |
gocd_get_artifact | One artifact file, tail-capped (cap_kb) to stay context-lean |
gocd_list_agents | Build agents and state. Optional filter, limit |
gocd_get_agent | One agent by uuid |
gocd_materials | Configured materials. Optional filter |
gocd_environments | Environments and their pipeline/var counts |
gocd_pipeline_groups | Pipeline groups. Filter to list a group's pipelines |
gocd_server_health | Server health messages, counted by level |
gocd_version | GoCD server version |
Write tools (operate):
| Tool | What it does |
|---|---|
gocd_trigger_pipeline | Schedule a pipeline run |
gocd_pause_pipeline | Pause a pipeline |
gocd_unpause_pipeline | Resume a pipeline |
Set GOCD_READONLY=1 to hide the three write tools. Large listings
(dashboard, pipeline_groups, materials, environments) are summarized or
filterable so they never dump the raw multi-MB body into the model's context.
Configuration
Two environment variables, both required:
GOCD_BASE_URL=https://gocd.example.com
GOCD_ACCESS_TOKEN=<personal access token>
GOCD_BASE_URL is the bare host, without a trailing /go. The tools append
/go/api/... themselves. Create the token in GoCD under your profile, Personal
Access Tokens.
Install
npx (Node >= 18), recommended
Zero install, nothing to build. This is the simplest way to run the server:
claude mcp add gocd -e GOCD_BASE_URL=... -e GOCD_ACCESS_TOKEN=... -- npx -y gocd-mcp
Published on npm as gocd-mcp and on the
MCP Registry as io.github.Sahilll15/gocd, so registry-aware clients can find it by name.
Go binary
Download a prebuilt binary from Releases, or build it:
cd go && go build -o gocd-mcp .
Register it:
claude mcp add gocd -e GOCD_BASE_URL=... -e GOCD_ACCESS_TOKEN=... -- /path/to/gocd-mcp
Docker
claude mcp add gocd -e GOCD_BASE_URL=... -e GOCD_ACCESS_TOKEN=... \
-- docker run -i --rm -e GOCD_BASE_URL -e GOCD_ACCESS_TOKEN ghcr.io/sahilll15/gocd-mcp
To run the TypeScript source directly during development (Node >= 22.6, uses type-stripping):
cd ts && node --experimental-strip-types src/server.ts
Which one
They are functionally identical. In a local benchmark the Go build started about
4x faster (~21ms vs ~80ms cold start) and used about 6x less memory; per-request
latency was a tie because the GoCD network round-trip dominates. Prefer the Go
binary or Docker image for a spawned-per-session server; prefer npx when you want
the zero-install path and already have Node.
Layout
gocd-mcp/
├── go/ Go implementation (main.go, internal/gocd)
├── ts/ TypeScript implementation (src/server.ts source; publishes as compiled dist/server.js)
├── Dockerfile builds the Go binary into a distroless image
├── .goreleaser.yaml + .github/workflows/release.yml prebuilt binaries + ghcr image on tag
└── server.json MCP Registry manifest
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption