Install on VS Code

VS Code has a built-in MCP wizard — no JSON editing required. Follow the Command Palette prompts and Veilguard installs in under a minute.

PrerequisiteNode.js 18 or later — verify with node --version
1

Open the Command Palette → MCP: Add Server

Press Ctrl + Shift + P (or Cmd + Shift + P on Mac) to open the Command Palette. Type MCP and select MCP: Add Server...

VS Code Command Palette with MCP typed, showing MCP: Add Server... highlighted with an arrow
2

Choose NPM Package as the server type

VS Code asks you to choose the type of MCP server to add. Select NPM PackageInstall from an NPM package name. This is the Model Assisted option highlighted in blue.

VS Code MCP server type picker with NPM Package option highlighted in blue and arrow pointing to it
3

Enter the package name: veilguard

VS Code prompts Enter NPM Package Name. Type veilguard and press Enter.

VS Code Enter NPM Package Name prompt with veilguard typed in
4

Click Allow to confirm the install

VS Code shows a confirmation prompt: "Install veilguard@x.x.x from elmimoha15?". Click Allow.

VS Code dialog asking to install veilguard from veilguard.co with Allow highlighted
5

Enter the Server ID: veilguard

VS Code prompts for a unique identifier for this server. Type veilguard and press Enter.

VS Code Enter Server ID prompt with veilguard typed in
6

Select Global as the configuration target

VS Code asks where to save the MCP config. Choose GlobalAvailable in all workspaces, runs locally — so Veilguard protects every project automatically.

VS Code Add MCP Server scope picker with Global option highlighted in blue
7

Verify it's running

Open your mcp.json — you should see the Running | Stop | Restart | 14 tools status inline above the veilguard block. Then open a GitHub Copilot agent chat and ask it to run a full audit to confirm all tools are working.

VS Code mcp.json file open showing veilguard server with Running status and 14 tools inline
VS Code GitHub Copilot agent chat running a Veilguard full audit and showing full_audit tool results
Pro

Add your Pro key (optional)

Open your mcp.json (VS Code opens it automatically after install, or find it at ~/.config/Code/User/mcp.json). Replace the empty string on VEILGUARD_KEY with your license key and save — the server restarts automatically.

VS Code mcp.json showing the VEILGUARD_KEY field with Running status and 14 tools indicator

Get a Pro key at veilguard.dev/pro. The server restarts automatically when you save.

Notes

  • VS Code stores the global MCP config at ~/.config/Code/User/mcp.json on Linux, ~/Library/Application Support/Code/User/mcp.json on macOS.
  • For auto-scanning with GitHub Copilot agent mode, download the .cursorrules file to your project root.
  • The MCP server requires GitHub Copilot or another MCP-compatible AI extension to call the tools.