# GoReleaser MCP server

> Validate GoReleaser configs, fix deprecated options and read GoReleaser documentation from your AI assistant.

- Listing: https://mcp.tc/i/goreleaser
- Connect: this is a local (stdio) server; install it on your machine (see Install). The listing link is a page, not an MCP endpoint.
- Type: local (stdio)
- Auth: no API key needed
- Category: [Developer Tools](https://mcp.tc/c/developer-tools)
- Vendor: GoReleaser
- Homepage: <https://goreleaser.com/mcp>
- Repository: <https://github.com/goreleaser/mcp>
- Package: npm `@goreleaser/mcp`

## About

A local MCP server for GoReleaser, the release automation tool. It checks GoReleaser configuration files for errors and deprecated options, gives instructions for fixing deprecations, and exposes the GoReleaser documentation to the assistant. An update\_config prompt helps modernize an existing configuration.

It runs locally over stdio. Install it with npm (@goreleaser/mcp), Homebrew, winget, or use the OCI image ghcr.io/goreleaser/mcp. No sign-in or API key is documented. Register the goreleaser-mcp command in your MCP client configuration.

## What it can do

- Validate GoReleaser configurations for errors
- Detect deprecated configuration options
- Get detailed instructions to fix deprecations
- Read embedded GoReleaser documentation
- Use the update\_config prompt to modernize a config

## Example prompts

- "Check my .goreleaser.yaml for errors and deprecated options."
- "Update my GoReleaser configuration to the latest recommended format."
- "How do I configure Homebrew casks in GoReleaser?"
- "Fix the deprecation warnings in my GoReleaser config."

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport stdio goreleaser -- npx -y @goreleaser/mcp
```

2. Start Claude Code and type `/mcp`. **goreleaser** should show as connected.

Add `--scope user` to make it available in every project.

### Claude Desktop

1. Open **Settings → Developer → Edit Config**. It opens `claude_desktop_config.json`. Add:

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "goreleaser": {
      "command": "npx",
      "args": [
        "-y",
        "@goreleaser/mcp"
      ]
    }
  }
}
```

2. Save the file and restart Claude Desktop.

Needs Node.js on your computer. The file lives in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=goreleaser&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBnb3JlbGVhc2VyL21jcCJdfQ%3D%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "goreleaser": {
      "command": "npx",
      "args": [
        "-y",
        "@goreleaser/mcp"
      ]
    }
  }
}
```

Needs Node.js on your computer.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=goreleaser&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40goreleaser%2Fmcp%22%5D%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"goreleaser","type":"stdio","command":"npx","args":["-y","@goreleaser/mcp"]}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "goreleaser": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@goreleaser/mcp"
      ]
    }
  }
}
```

Needs Node.js on your computer.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "goreleaser": {
      "command": "npx",
      "args": [
        "-y",
        "@goreleaser/mcp"
      ]
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

### Codex

```bash
codex mcp add goreleaser -- npx -y @goreleaser/mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.goreleaser]
command = "npx"
args = ["-y", "@goreleaser/mcp"]
```

Needs Node.js on your computer.

### Gemini CLI

```bash
gemini mcp add goreleaser npx -- -y @goreleaser/mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients that start local servers accept this shape:

```json
{
  "mcpServers": {
    "goreleaser": {
      "command": "npx",
      "args": [
        "-y",
        "@goreleaser/mcp"
      ]
    }
  }
}
```

Zed puts servers under `context_servers` in its settings, with the same `command`, `args` and `env` fields.

Needs Node.js on your computer.

## Details

- Server version: 0.6.0
- Last checked: 2026-10-04
- Listed: 2026-10-04
- Updated: 2026-10-04

---
Source: https://mcp.tc/i/goreleaser (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report