Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Model Context Protocol (MCP) Clients

If you haven’t installed Wassette yet, follow the installation instructions first.

Visual Studio Code

Add the Wassette MCP Server to GitHub Copilot in Visual Studio Code by clicking the Install in VS Code or Install in VS Code Insiders badge below:

Install in VS Code Install in VS Code Insiders

Alternatively, you can add the Wassete MCP server to VS Code from the command line using the code command in a bash/zsh or PowerShell terminal:

bash/zsh

code --add-mcp '{"name":"Wassette","command":"wassette","args":["run"]}'

PowerShell

 code --% --add-mcp "{\"name\":\"wassette\",\"command\":\"wassette\",\"args\":[\"run\"]}"

You can list and configure MCP servers in VS Code by running the command MCP: List Servers in the command palette (Ctrl+Shift+P or Cmd+Shift+P).

GitHub Copilot CLI

After installing GitHub Copilot CLI, add Wassette as a local stdio MCP server:

copilot mcp add wassette -- wassette run

Verify that Wassette is configured and its tools are available:

copilot mcp get wassette

You can also run copilot, enter /mcp add, choose STDIO, set the command to wassette run, keep the default * tool selection, and press Ctrl+S. Copilot CLI stores the user-level configuration in ~/.copilot/mcp-config.json and makes Wassette available immediately without a restart.

To remove the server:

copilot mcp remove wassette

Cursor

To add Wassette to Cursor, you’ll need to manually configure it in your MCP settings. Follow the Cursor MCP setup guide to add the following configuration:

{
  "mcpServers": {
    "wassette": {
      "command": "wassette",
      "args": ["run"]
    }
  }
}

Claude Code

First, install Claude Code (requires Node.js 18 or higher):

npm install -g @anthropic-ai/claude-code

Add the Wassette MCP server to Claude Code using the following command:

claude mcp add -- wassette wassette run

This will configure the Wassette MCP server as a local stdio server that Claude Code can use to execute Wassette commands and interact with your data infrastructure.

You can verify the installation by running:

claude mcp list

To remove the server if needed:

claude mcp remove wassette

Codex CLI

First, install Codex CLI (requires Node.js) using either npm or Homebrew:

npm install -g @openai/codex

Or with Homebrew:

brew install codex

Add the Wassette MCP server to Codex CLI using the following command:

codex mcp add wassette wassette run

Run codex to start the CLI.

Verify the installation by running /mcp inside of Codex CLI.

Gemini CLI

First, install Gemini CLI (requires Node.js 20 or higher):

npm install -g @google/gemini-cli

To add the Wassette MCP server to Gemini CLI, you need to configure it in your settings file at ~/.gemini/settings.json. Create or edit this file to include:

{
  "mcpServers": {
    "wassette": {
      "command": "wassette",
      "args": ["run"]
    }
  }
}

Quit the Gemini CLI and reopen it.

Open Gemini CLI and verify the installation by running /mcp inside of Gemini CLI.