Switchboard
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Switchboard
One MCP endpoint for all your AI agents.
Group your MCP servers into profiles (personal, work, a client's) and give Cursor, Claude Code, VS Code and every other agent exactly the tools it should see. Switch a client's profile with one click; it changes live, without restarting anything.
Docs · Quick start · Self-hosting · Changelog
Why
Profiles, not toggles. Stop enabling and disabling servers in every project. Define
personal,workandclient-acmeonce.One server, many accounts. Give a profile its own API key or sign-in for a server (
workandpersonalGitHub), without adding the server twice.Switch live. Set a client up once; after that its profile is a switch in Switchboard. Flip it and the client gets the new tools instantly, with no config edit or restart.
Any client. Cursor, Claude Code, Claude Desktop, VS Code, Windsurf, Codex and Gemini CLI are set up for you; any other MCP client shows up the moment it connects.
One process per server. Ten clients share one copy of each MCP server, started when added, stopped when idle and restarted if it crashes.
Less context. Large profiles can be served as
search_tools/get_schema/call_tool, or as oneexecutetool where the model writes code that calls tools in a sandbox.Local first, hostable. Runs on your machine with secrets in your OS keychain, or on a server with API keys and a login, from one Docker image.
Related MCP server: dsh-mcp-lazy
Quick start
npx mcp-switchboard upThis starts Switchboard and opens it at http://localhost:7690 (Node 24 or later). Then:
Import the MCP servers you already use in Cursor, Claude Code, Claude Desktop or VS Code, or add new ones.
Create profiles and pick the servers and tools in each. The first one becomes the default.
Set up your clients on the Clients page (one click each, restart the client once), then switch their profiles whenever you like.
Prefer to let your agent do it? The Set up with AI button gives you a prompt to paste into Claude Code, Cursor or Codex.
How clients get their tools
Each client is set up once with its own URL, which Switchboard writes into the client's config file for you:
// ~/.cursor/mcp.json
{
"mcpServers": {
"switchboard": { "url": "http://127.0.0.1:7690/c/cursor/mcp" }
}
}From then on, which profile Cursor gets is a setting in Switchboard. New clients use the default profile, and any MCP client can connect to /c/<any-name>/mcp or the shared /mcp and appear in the list. To pin a connection to one profile instead, use /p/<profile>/mcp. Clients that only speak stdio use switchboard connect --client <name>.
Tool surfaces
Each profile chooses how its tools are presented:
Surface | What the client sees | Best for |
| every allowed tool, as is | small profiles |
|
| many tools, any model |
|
| multi-step work across tools |
|
| the default |
From the terminal
Everything in the web UI is also a command:
switchboard import # servers from your AI clients
switchboard server add github -- npx -y @modelcontextprotocol/server-github
switchboard server add linear --url https://mcp.linear.app/mcp
switchboard server auth linear # OAuth sign-in in the browser
switchboard secret set github-token # use as secret://github-token
switchboard profile add work --servers github,linear
switchboard profile credentials work github -e GITHUB_TOKEN=secret://github-work # its own account
switchboard client connect cursor # set it up once
switchboard client use cursor work # switch its profile, live
switchboard status~/.switchboard/config.json is plain JSON you can also edit by hand; Switchboard reloads it and tells connected clients when their tools change.
Run it on a server
One setup for every machine you work on, and for cloud agents that need an HTTPS MCP URL:
docker run -d -p 7690:7690 -v switchboard:/data \
-e SWITCHBOARD_ADMIN_PASSWORD='a long password' \
-e SWITCHBOARD_PUBLIC_URL=https://switchboard.example.com \
ghcr.io/visveshkhanna/switchboard:latestHosted, every MCP client needs an API key (each key acts as one client, so its profile switches like any other) and the web UI asks for the admin password. deploy/ has Docker Compose with automatic HTTPS and a Fly.io config; see the Self-hosting guide.
Develop
pnpm install
pnpm dev # daemon from source + web UI with hot reload, isolated from your real setup
pnpm check # lint, type-check and testSee CONTRIBUTING.md. Report security problems as described in SECURITY.md.
License
Apache License 2.0. See NOTICE for credits.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for progressive tool usage at any scale (see https://klavis.ai)
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Search, vet & assemble MCP servers from your agent: verified tools, risk labels, and trust scores.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAggregates multiple MCP servers into a single standard MCP interface for agents like Claude Code, with automatic tool prefixing and hot-reload.2-
- AlicenseNot gradedqualityBmaintenanceExposes all of a DeepSeek Harness profile's configured MCP servers through a single stable proxy tool that can search, describe, and call their tools on demand, so no per-tool schemas are sent on every request. Servers connect only on first use, idle out again, and cache their tool metadata to disk so discovery and description never spawn a process.235 npm11MIT
- AlicenseNot gradedqualityCmaintenanceRuns every configured MCP server once in a shared background engine and exposes them over a single HTTP endpoint, so Claude Code, Codex, Cursor, VS Code, Gemini CLI and SSH-connected remote machines all connect through one entry and pick up added, removed, or disabled servers and tools immediately. Also provides per-tool hiding, runtime supervision with logs and auto-restart, and secret storage isolated from the API.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to connect once to a local MCP endpoint and access tools from all configured MCP servers, add or remove connectors live, and generate sandboxed connectors for services that lack one. It centralizes multi-server access while keeping credentials isolated and calls logged without recording arguments or results.MIT