# Switchboard MCP server

> Provides a local firewall and password manager to control MCP server access and manage secrets for AI coding agents.

- Repository: https://github.com/wkoverfield/switchboard
- Page: https://hostedmcp.org/servers/wkoverfield/switchboard
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.2.3

## Install

### Claude Code

```sh
claude mcp add switchboard -- npx -y @switchboard-mcp/cli
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "switchboard": {
      "command": "npx",
      "args": [
        "-y",
        "@switchboard-mcp/cli"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "switchboard": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@switchboard-mcp/cli"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"switchboard","type":"stdio","command":"npx","args":["-y","@switchboard-mcp/cli"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "switchboard": {
      "command": "npx",
      "args": [
        "-y",
        "@switchboard-mcp/cli"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add switchboard -- npx -y @switchboard-mcp/cli
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.switchboard]
command = "npx"
args = ["-y", "@switchboard-mcp/cli"]
```

### Gemini CLI

```sh
gemini mcp add -s user switchboard npx -- -y @switchboard-mcp/cli
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "switchboard": {
      "command": "npx",
      "args": [
        "-y",
        "@switchboard-mcp/cli"
      ]
    }
  }
}
```

## FAQ

### Is Switchboard a hosted service?

No, everything runs locally with no account, no hosted service, and no telemetry.

### How are secrets stored in Switchboard?

Secrets are stored in your OS keychain as named references, ensuring that config files contain references rather than plaintext tokens.

### Can Switchboard prevent an agent from bypassing it?

Switchboard is not a sandbox; it governs routed paths. It can detect and report bypass routes like raw shell access or direct MCP routes via the scan command.

### What happens when I grant an agent access?

The agent is put on a scoped, expiring pass where only named tools are reachable and everything else is denied.
