MCPSwitch
Smart MCP profile manager for Claude Code.
Stop wasting 30-40% of your context window on MCP tools you never use.
The Problem
Every MCP server you install adds its tool schemas to Claude's context window at session start.
84 tools across 6 servers = 15,540 tokens consumed before you type a single message.
That's up to 40% of your context window gone — every session, every time.
MCPSwitch lets you define lean profiles for different workflows and switch between them instantly.
Install
pip install mcpswitch
Or run from source:
git clone https://github.com/sathibabu/mcpswitch
cd mcpswitch
pip install -e .
Quick Start
# See what your current MCP config is costing you
mcpswitch analyze
# Save your current config as a profile
mcpswitch import --name full
# Create a lean profile
mcpswitch create python-backend
# Add only the servers you need for Python work
mcpswitch add python-backend github
mcpswitch add python-backend context7
# Switch to it before starting a Claude Code session
mcpswitch use python-backend
# See all profiles and their token costs
mcpswitch list
Commands
| Command | What it does |
|---|---|
mcpswitch status |
Show active profile + token cost of loaded servers |
mcpswitch analyze |
Break down token cost by server, show savings potential |
mcpswitch list |
List all profiles with token estimates |
mcpswitch use <profile> |
Switch to a profile (rewrites Claude config) |
mcpswitch import --name <n> |
Save current config as a named profile |
mcpswitch create <profile> |
Create a new empty profile |
mcpswitch add <profile> <server> |
Add a server to a profile |
mcpswitch remove <profile> <server> |
Remove a server from a profile |
mcpswitch save <profile> |
Save current active config as profile |
mcpswitch delete <profile> |
Delete a profile |
Real-World Savings
| Scenario | All MCPs | Lean Profile | Saved |
|---|---|---|---|
| Python backend work | 15,540 tokens | 3,200 tokens | 12,340 tokens (79%) |
| Frontend work | 15,540 tokens | 4,100 tokens | 11,440 tokens (74%) |
| Writing/docs | 15,540 tokens | 900 tokens | 14,640 tokens (94%) |
Fewer wasted tokens = more context for your actual code = better Claude responses.
How It Works
MCPSwitch reads and writes the Claude MCP config files:
- Claude Code CLI:
~/.claude/claude_desktop_config.json - Claude Desktop:
~/AppData/Roaming/Claude/claude_desktop_config.json(Windows)
Profiles are stored in ~/.mcpswitch/profiles.json. Every config change is backed up automatically before overwriting.
Pricing
- Free: unlimited profiles, all commands, open source
- Pro ($19/month): coming soon — auto-detect project type and switch profiles automatically, usage analytics, team profile sharing
License
MIT
Metadata
Release files for mcpswitch-cli 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcpswitch_cli-0.1.0.tar.gz | 39.8 kB | Without provenance | Details for mcpswitch_cli-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcpswitch_cli-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for mcpswitch_cli-0.1.0-py3-none-any.whl |
Total release size: 84.4 kB
Release files / mcpswitch_cli-0.1.0.tar.gz
| Download URL | mcpswitch_cli-0.1.0.tar.gz |
|---|---|
| Size | 39.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6447ef6792de54d5f26a9389bd4b8b96cb6db20a3e4deeafecd518121e15bbe2
|
|
BLAKE2b-256 checksum How to use checksums |
106870722d8cb1d830c1ac027533b6a5db3edcd4c4daafbb9e6b32662de2a220
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.9.0
|
Release files / mcpswitch_cli-0.1.0-py3-none-any.whl
| Download URL | mcpswitch_cli-0.1.0-py3-none-any.whl |
|---|---|
| Size | 44.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
16c68d06a29c8f86814d7987a86ec6cf6a8ec540c508c0befdf8d11060194bff
|
|
BLAKE2b-256 checksum How to use checksums |
a74a442b551754c8333a219a51bc0b4fe33be5a247db061c415ae080df0114df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.9.0
|
Security for mcpswitch-cli 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.