How to Use the Gerrit MCP in Windsurf

Q: How do I install the Gerrit MCP server in Windsurf?

Edit your /.codeium/windsurf/mcpconfig.json file. Add the server details under the mcpServers block, then hit refresh in the MCP panel. You can also use the built-in UI under Settings.

Q: How does the agent know which branches exist?

It checks the API directly. The listbranches tool pulls the exact tree for whatever repository you specify, so the agent never guesses about your project structure.

Let Windsurf's Cascade agent handle your code reviews. Query changes, check patch sets, and audit branches without leaving your IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gerrit MCP to Windsurf

Create your Vinkius account to connect Gerrit to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Gerrit with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous review tracking

This toolset lets Cascade read your Gerrit instance directly. You ask it to find open PRs you need to look at, and it chains `query_changes` with `get_change` to grab the exact context. It reads the project state, fetches the patch sets, and maps out what changed. You skip the web UI completely. The agent sees a broken build, runs `list_reviewers` to see who approved it, and pulls the relevant `list_patchsets` data right into your editor.

Windsurf MCP Server for project audits

Managing hundreds of repositories gets messy fast. Hook up this MCP Server and tell your agent to map out the current structure. It uses `list_projects` to find the repos and `list_branches` to verify where code is actually landing. Speed is the whole point here. Instead of clicking through ten different Gerrit menus, Cascade pulls the raw group data via `list_groups` and cross-references it with `get_project` in seconds.

Account and access mapping

Figuring out who owns what patch is usually a headache. Your agent fires `get_account` to verify your current context, then runs `list_emails` to check associated addresses. That data feeds directly into how Cascade interprets code ownership. It knows exactly who to ping for a review because it pulled the live roster straight from the source.

Setup guide

Set up Gerrit MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Gerrit MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Gerrit payment history." If connected, Cascade will call the Gerrit tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "gerrit-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Gerrit. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Gerrit now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Gerrit MCP in Windsurf

Edit your `~/.codeium/windsurf/mcp_config.json` file. Add the server details under the `mcpServers` block, then hit refresh in the MCP panel. You can also use the built-in UI under Settings.

No. This MCP Server is strictly read-only for now. Cascade reads the status, pulls patch sets, and lists reviewers, but you still need to hit the approve button yourself.

You pass standard syntax right to the agent. Tell it to look for "status:open" or "owner:self", and it feeds those strings into the `query_changes` tool.

It checks the API directly. The `list_branches` tool pulls the exact tree for whatever repository you specify, so the agent never guesses about your project structure.

The server only reads metadata like change subjects, patch set IDs, reviewer emails, and group descriptions. Your actual file contents stay on your local machine and your Gerrit instance. Vinkius handles the authorization token securely in an isolated V8 sandbox.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript