KGV MCP Tools

Multi-IDE integration with 150+ AI-powered tools

Works with VS Code, Cursor, Windsurf, and Google Antigravity

✅ v0.3.1: Governance Migration

Migrated to new governance architecture with proxy tools for Issue, Attempt, Evidence, Link, Handoff, and Analytics. The VS Code extension now includes a fully bundled MCP server (v2.9.1). No external dependencies required - everything works offline after installation.

✅ Self-contained bundle ✅ Works offline ✅ 188+ AI-powered tools ✅ Multi-IDE support

💻 VS Code Extension

v0.3.1 (MCP v2.9.1) • January 6, 2026 • ~1.5MB

Stable

⚠️ Extension Required for VS Code

Unlike Cursor, Windsurf, and Antigravity, VS Code does not have native MCP support. You must install this extension to use KGV MCP tools.

Download VSIX

After downloading: VS Code → Ctrl+Shift+P → "Extensions: Install from VSIX..."

Command Line Installation

🐧 Linux / WSL

wget -O /tmp/vscode-kgv-mcp.vsix https://download.katagenesis.com/vscode-extension/latest.vsix && code --install-extension /tmp/vscode-kgv-mcp.vsix

🍎 macOS

curl -o /tmp/vscode-kgv-mcp.vsix https://download.katagenesis.com/vscode-extension/latest.vsix && code --install-extension /tmp/vscode-kgv-mcp.vsix

🪟 Windows (PowerShell)

Invoke-WebRequest -Uri "https://download.katagenesis.com/vscode-extension/latest.vsix" -OutFile "$env:TEMP\vscode-kgv-mcp.vsix"; code --install-extension "$env:TEMP\vscode-kgv-mcp.vsix"

After Installation

1

Reload VS Code

Ctrl+Shift+P → "Developer: Reload Window"
2
✅ Auto-Configuration
The extension will automatically:
- Detect your IDE (VS Code, Cursor, Windsurf, etc.)
- Create the correct MCP configuration file
- Connect to the KGV MCP server
You'll see a notification: "KGV MCP configured! Reload window to activate."
3

Sign In (One-Time)

Run this command to authenticate your device:

npx @kgv/mcp-server auth login
npx @kgv/mcp-server auth login
⭐

New Commands (v0.2.6+)

Multi-IDE Setup

Configure VS Code, Cursor, Windsurf, and Antigravity all at once:
Ctrl+Shift+P → KGV: Configure All IDEs

Environment Switching

Toggle between Dev and Production environments:
Ctrl+Shift+P → KGV: Switch Environment

🗑️ Uninstall VS Code Extension

To remove KGV from VS Code:

Open Extensions view (Ctrl+Shift+X)
Search for KGV MCP Tools
Click the gear icon and select Uninstall

code --uninstall-extension vialucra.vscode-kgv-mcp

🔧 Troubleshooting: Clean Reinstall

If you're experiencing sign-in errors or version conflicts in VS Code, follow these steps:

🐧 Linux / WSL / macOS

# 1. Uninstall the extension completely
code --uninstall-extension vialucra.vscode-kgv-mcp

# 2. Clear extension cache (optional but recommended)
# For VS Code Remote/SSH/WSL:
rm -rf ~/.vscode-server/extensions/vialucra.vscode-kgv-mcp-*
# For local VS Code (uncommon):
# rm -rf ~/.vscode/extensions/vialucra.vscode-kgv-mcp-*

# 3. Reinstall fresh
wget -O /tmp/vscode-kgv-mcp.vsix https://download.katagenesis.com/vscode-extension/latest.vsix
code --install-extension /tmp/vscode-kgv-mcp.vsix

# 4. Reload VS Code (Ctrl+Shift+P → "Developer: Reload Window")

This clears cached old versions and ensures clean endpoint configuration.

🎯 Cursor IDE

MCP Configuration • Uses npx @kgv/mcp-server

Ready

✅ No Extension Required

Cursor has native MCP support built-in. You only need to create a config file — no VSIX installation needed.

Cursor supports MCP natively. Configure it to use the KGV MCP server via npx.

Setup Steps

1

Create MCP config directory
mkdir -p ~/.cursor
2

Create ~/.cursor/mcp.json

~/.cursor/mcp.json

{
  "mcpServers": {
    "kgv": {
      "command": "npx",
      "args": ["@kgv/mcp-server", "--transport", "stdio"],
      "env": {
        "KGV_IDE_TYPE": "cursor"
      }
    }
  }
}

3

Authenticate with KGV
npx @kgv/mcp-server auth login
4

Enable MCP in Cursor Settings

Settings → Search "MCP" → Enable MCP support
✓

Restart Cursor and start using KGV tools!

⚙️ npm Registry Configuration

Since Cursor uses npx, you must configure npm to access the private KGV registry:

Add to ~/.npmrc

@kgv:registry=https://pkgs.dev.azure.com/vialucra/vialucra/_packaging/kgv-artifacts/npm/registry/

🗑️ Uninstall from Cursor

Delete the configuration file:

rm ~/.cursor/mcp.json

This only affects Cursor. VS Code and other IDEs will remain configured.

🏄 Windsurf (Codeium)

MCP Configuration • Uses npx @kgv/mcp-server

Ready

✅ No Extension Required

Windsurf has native MCP support built-in. You only need to create a config file — no VSIX installation needed.

Windsurf by Codeium supports MCP. Configure it to use the KGV MCP server.

Setup Steps

1

Create MCP config directory
mkdir -p ~/.windsurf
2

Create ~/.windsurf/mcp.json

~/.windsurf/mcp.json

{
  "mcpServers": {
    "kgv": {
      "command": "npx",
      "args": ["@kgv/mcp-server", "--transport", "stdio"],
      "env": {
        "KGV_IDE_TYPE": "windsurf"
      }
    }
  }
}

3

Authenticate with KGV
npx @kgv/mcp-server auth login
✓

Restart Windsurf and start using KGV tools!

⚙️ npm Registry Configuration

Since Windsurf uses npx, you must configure npm to access the private KGV registry:

Add to ~/.npmrc

@kgv:registry=https://pkgs.dev.azure.com/vialucra/vialucra/_packaging/kgv-artifacts/npm/registry/

🗑️ Uninstall from Windsurf

Delete the configuration file:

rm ~/.windsurf/mcp.json

This only affects Windsurf. Other IDEs will remain configured.

🌌 Google Antigravity

MCP Configuration • Uses npx @kgv/mcp-server

Ready

✅ No Extension Required

Antigravity has native MCP support built-in. You only need to create a config file — no VSIX installation needed.

Google Antigravity (Gemini-powered IDE) supports MCP. Configure it to use the KGV MCP server.

Setup Steps

1

Create MCP config directory
mkdir -p ~/.gemini/antigravity
2

Create ~/.gemini/antigravity/mcp_config.json

~/.gemini/antigravity/mcp_config.json

{
  "mcpServers": {
    "kgv": {
      "command": "npx",
      "args": ["@kgv/mcp-server", "--transport", "stdio"],
      "env": {
        "KGV_IDE_TYPE": "antigravity"
      }
    }
  }
}

3

Authenticate with KGV
npx @kgv/mcp-server auth login
✓

Restart Antigravity and start using KGV tools!

⚙️ npm Registry Configuration

Since Antigravity uses npx, you must configure npm to access the private KGV registry:

Add to ~/.npmrc

@kgv:registry=https://pkgs.dev.azure.com/vialucra/vialucra/_packaging/kgv-artifacts/npm/registry/

🗑️ Uninstall from Antigravity

Delete the configuration file:

rm ~/.gemini/antigravity/mcp_config.json

This only affects Antigravity. VS Code and other IDEs will remain configured.

📦 Previous Releases

Loading releases...

ℹ️ MCP Server is distributed via @kgv/mcp-server npm package. Used by Cursor, Windsurf, Antigravity, and as the backend for VS Code extension.

Loading MCP releases...

Unable to load MCP release history. Current version: npx @kgv/mcp-server --version

KGV MCP Tools

✅ v0.3.1: Governance Migration

💻 VS Code Extension

⚠️ Extension Required for VS Code

Command Line Installation

After Installation

Reload VS Code

✅ Auto-Configuration

Sign In (One-Time)

New Commands (v0.2.6+)

🗑️ Uninstall VS Code Extension

🔧 Troubleshooting: Clean Reinstall

🎯 Cursor IDE

✅ No Extension Required

Setup Steps

⚙️ npm Registry Configuration

🗑️ Uninstall from Cursor

🏄 Windsurf (Codeium)

✅ No Extension Required

Setup Steps

⚙️ npm Registry Configuration

🗑️ Uninstall from Windsurf

🌌 Google Antigravity

✅ No Extension Required

Setup Steps

⚙️ npm Registry Configuration

🗑️ Uninstall from Antigravity

📦 Previous Releases