Skip to main content

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)

Source distribution for mcpswitch-cli 0.1.0
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)

Table of built distributions (wheels) for mcpswitch-cli 0.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page