gitwtfhub

wtf is mcp-switchboard?

cmer/mcp-switchboard — explained in plain English

Analysis updated 2026-05-18

3TypeScriptAudience · developerComplexity · 3/5Setup · easy

TL;DR

A self-hosted gateway that centralizes your MCP servers and gives each coding agent its own endpoint with a per-agent switch for which servers it can see.

Mindmap

mindmap
  root((repo))
    What it does
      Central MCP server hub
      Per agent endpoints
      OAuth handling
    Tech stack
      TypeScript
      Node.js
      SQLite
      Docker
    Use cases
      Multi agent tool management
      Shared OAuth credentials
      Namespaced multi account tools
    Audience
      Developers
      Claude Code users
      Homelab operators
    Setup
      npx quick start
      Docker compose
      Admin password

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Give Claude Code and Codex each their own curated set of MCP tools from one shared switchboard.

REASON 2

Manage OAuth logins and API keys for many MCP servers in a single place instead of per agent.

REASON 3

Run separate work and personal accounts of the same service as distinct, namespaced tool sets.

What's in the stack?

TypeScriptNode.jsSQLiteDocker

How it stacks up

cmer/mcp-switchboard000madz000/payload-test-api-route-handlerakash-sr/memobsidian
Stars333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity3/52/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

No built-in TLS or multi-user auth, intended for a trusted LAN, not the public internet.

Wtf does this do

MCP Switchboard is a small, self-hosted tool that acts as a central hub for MCP servers, the connectors that let AI coding agents like Claude Code or Codex reach outside tools and services. Instead of configuring each agent separately with its own set of servers, you register all your MCP servers once in the switchboard and then give each agent its own endpoint showing exactly the servers you want that agent to see. Setup is meant to be simple. Adding a popular service like GitHub, Linear, Notion, Stripe, or Supabase can be done through a visual template picker. Services that use OAuth send you straight to a browser consent screen, while others just ask for an API key. The switchboard also supports pasting an existing claude mcp add command or a raw mcpServers JSON block, which it parses and previews before creating the server entry. It handles both local servers, which run as processes it spawns and restarts if they crash, and remote servers reached over HTTP or SSE with various authentication methods, including keeping OAuth tokens refreshed automatically in the background. Each agent gets its own switch matrix, so you can turn individual servers on or off per agent without restarting anything, and changes apply live. Tools from different servers are namespaced, so two accounts of the same service, like a personal and a work Gmail, appear as separate, clearly labeled tool sets rather than colliding with each other. A built in tool lets agents themselves list which servers are connected and what they do. You can run it with a single npx command, install it globally, run it from source with hot reload for development, or deploy it with Docker, with state persisted to a local directory. Authentication is intentionally basic: one admin password for the web interface and one bearer token per agent, built for a trusted home network rather than the open internet. Secrets are encrypted at rest, but the tool has no built in TLS or multi-user support, so the README recommends putting something like Caddy or Tailscale in front of it for transport security.

Yoink these prompts

Prompt 1
Help me run mcp-switchboard with npx and connect it to Claude Code using the mcp add command.
Prompt 2
Walk me through adding a GitHub and a Notion server from the template picker and enabling them per agent.
Prompt 3
Show me how to deploy this with Docker Compose and set PUBLIC_URL for LAN access.
Prompt 4
Explain how to put Tailscale or Caddy in front of this switchboard for transport security.

Frequently asked questions

wtf is mcp-switchboard?

A self-hosted gateway that centralizes your MCP servers and gives each coding agent its own endpoint with a per-agent switch for which servers it can see.

What language is mcp-switchboard written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, SQLite.

How hard is mcp-switchboard to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mcp-switchboard for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.