Skip to main content
The Pointbreak MCP server is primarily designed to be invoked by AI assistants, but it does expose a minimal command-line interface.

​
Installation

Install the MCP server binary: 
curl -fsSL https://withpointbreak.com/install.sh | sh
Or download manually from download.withpointbreak.com/cli/latest.

​
Binary Location

After installation: macOS/Linux: 
~/.local/bin/pointbreak
Windows: 
%USERPROFILE%\.local\bin\pointbreak.exe

​
Usage

​
Basic Invocation

The MCP server is typically started by AI assistants automatically. For manual testing: 
pointbreak
This starts the MCP server and waits for connections over stdio.

​
Verify Installation

Check that Pointbreak is installed and accessible: 
pointbreak --version
Output: 
pointbreak 0.1.0

​
Help

Display available options: 
pointbreak --help

​
Configuration

The MCP server auto-discovers and connects to your IDE. No manual configuration is required for standard usage.

​
Environment Variables

POINTBREAK_IDE_AUTO_CONNECT Control automatic IDE discovery:
  • true (default): Auto-detect and connect to IDE
  • false: Require explicit IDE registration
Example: 
POINTBREAK_IDE_AUTO_CONNECT=false pointbreak

​
MCP Integration

AI assistants typically start Pointbreak via MCP configuration:

​
Claude Code

Add to ~/.config/claude/claude_desktop_config.json: 
{
  "mcpServers": {
    "pointbreak": {
      "command": "/Users/yourusername/.local/bin/pointbreak",
      "args": ["mcp", "serve"]
    }
  }
}

​
Codex

Add to your Codex MCP configuration: 
{
  "servers": {
    "pointbreak": {
      "command": "/Users/yourusername/.local/bin/pointbreak",
      "args": ["mcp", "serve"]
    }
  }
}

​
Windsurf

Add to your Windsurf settings: 
{
  "mcp.servers": {
    "pointbreak": {
      "command": "/Users/yourusername/.local/bin/pointbreak",
      "args": ["mcp", "serve"]
    }
  }
}

​
Logging

View MCP server logs in VS Code:
  1. Open Output panel: View → Output
  2. Select “Pointbreak MCP Server” from dropdown
Logs include:
  • Connection status
  • Debug session events
  • Error messages
  • Performance metrics

​
Debugging the MCP Server

If the MCP server isn’t working:
  1. Check it’s installed: 
    which pointbreak
pointbreak --version
  2. Test manual start: 
    pointbreak
    Should wait for input (press Ctrl+C to exit).
  3. Check VS Code extension logs:
    • View → Output → “Pointbreak MCP Server”
  4. Verify IDE connection:
    • Extension should show “MCP server started” in Output panel
    • Green status indicator in VS Code status bar

​
Platform Support

Supported platforms:
  • macOS 10.15+ (x64 and ARM64)
  • Windows 10+ (x64 and ARM64)
  • Linux (recent distributions, x64 and ARM64)
Pre-built binaries available for:
  • darwin-arm64 (Apple Silicon)
  • darwin-x64 (Intel Mac)
  • linux-arm64
  • linux-x64
  • alpine-arm64
  • alpine-x64
  • win32-arm64
  • win32-x64

​
Uninstallation

Remove the binary: macOS/Linux: 
rm ~/.local/bin/pointbreak
Windows: 
Remove-Item $env:USERPROFILE\.local\bin\pointbreak.exe
Also uninstall the VS Code extension from the Extensions panel.

​
More Information