Meta

• License Expression: MIT
  SPDX License Expression
• Author: MCPBundles
• Tags mcp , ai , tools , cli , model-context-protocol
• Requires: Python >=3.10
• Provides-Extra: browser , all

Classifiers

• Development Status
  • 5 - Production/Stable
• Intended Audience
  • Developers
• Programming Language
  • Python :: 3
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13

MCPBundles CLI

Connect AI to 500+ tools from the command line.

The mcpbundles CLI provides full MCP (Model Context Protocol) access to the MCPBundles platform — tool discovery, execution, interactive shell, AI agent integration, and a desktop proxy tunnel for local services.

Browse the full catalog: 500+ MCP tools | MCP server providers | MCP bundle servers

Features

• Hub MCP access — discover and call 500+ tools directly from your terminal
• Interactive shell — REPL with tab completion, command history, and live connection switching
• Multi-connection support — connect to Hub, individual bundles, or different workspaces simultaneously
• Aggregated local proxy — expose multiple connections as a single unauthenticated MCP endpoint
• AI agent integration — generate tool manifests for AI coding agents
• Code execution — run sandboxed code with --stream for progressive output
• Desktop proxy tunnel — securely forward cloud requests to local services (databases, browsers, APIs)
• Rich terminal output — tables, syntax highlighting, JSON, streaming, and NO_COLOR support
• Multiple auth methods — OAuth2 PKCE (browser) or API key (CI/CD)
• Shell completion — dynamic tab completion for bash, zsh, and fish

Installation

# Recommended Python CLI install
pipxinstallmcpbundles

# Python package manager
pipinstallmcpbundles

# Node.js package manager
npminstall-gmcpbundles

# macOS Homebrew
brewinstallthinkchainai/tap/mcpbundles

Quick Start

# Authenticate (opens browser)
mcpbundleslogin

# Or use an API key (CI/CD, headless)
mcpbundleslogin--api-keymb_your_key_here

# List available tools
mcpbundlestools

# Get full schema for a tool
mcpbundlestoolscode_execution

# Call a tool
mcpbundlescallget-contactslimit=10

# Execute code
mcpbundlesexec"result = 2 + 2; print(result)"

# Execute from file with streaming output
mcpbundlesexec-fscript.py--stream

# Start interactive shell
mcpbundlesshell

Commands

Auth & Identity

Command	Description
mcpbundles login	Authenticate via browser (OAuth2 PKCE)
mcpbundles login --api-key mb_...	API key auth (headless/CI)
mcpbundles logout	Remove stored credentials
mcpbundles whoami	Show current user, workspace, and server

Tool Discovery (always live from server)

Command	Description
mcpbundles tools	List all available MCP tools
mcpbundles tools <name>	Show full schema for a specific tool
mcpbundles tools -f <keyword>	Filter tools by name or description
mcpbundles tools --json	JSON output for piping
mcpbundles resources	List available MCP resources
mcpbundles prompts	List available MCP prompts

Tool Execution

Command	Description
mcpbundles call <tool> key=value	Call a tool with typed arguments
mcpbundles call <tool> key:=true	JSON-typed argument (bool, number, array)
mcpbundles call <tool> -f data.json	Arguments from JSON file
mcpbundles read <uri>	Read an MCP resource
mcpbundles prompt <name> key=value	Get an MCP prompt
mcpbundles exec "code"	Execute code (shortcut for code_execution)
mcpbundles exec -f script.py	Execute code from file
mcpbundles exec -f script.py --stream	Stream output line-by-line

Named Connections

Command	Description
mcpbundles connect --as hub	Connect to Hub (default)
mcpbundles connect --as hubspot --server hubspot	Direct MCP server connection
mcpbundles connect --as dev --server localhost:8000	Dev server connection
mcpbundles connections	List active connections
mcpbundles disconnect <name>	Remove a connection
mcpbundles tools --as @hubspot	Target a specific connection

Interactive Shell

$mcpbundlesshell
MCPBundlesShell—connectingtohub...
Connected.Typehelpforcommands,exittoquit.

mcpbundles(hub)>tools
mcpbundles(hub)>callget-contactslimit=5
mcpbundles(hub)>execprint("hello world")
mcpbundles(hub)>usehubspot# switch connection live
mcpbundles(hubspot)>tools
mcpbundles(hubspot)>exit

AI Agent Integration

Command	Description
mcpbundles init	Generate .skills/mcpbundles-cli/ for AI agents
mcpbundles init --format json	JSON format manifest
mcpbundles serve	Local MCP proxy on localhost:8080
mcpbundles serve --connections hub,hubspot,stripe	Aggregate multiple connections

Local MCP Proxy (serve)

Start a local unauthenticated MCP server that proxies to remote MCPBundles:

# Single connection
mcpbundlesserve--port8080

# Multi-connection aggregation
mcpbundlesserve--connectionshub,hubspot,stripe

In aggregated mode, list_tools merges tools from all connections and call_tool routes to the correct upstream automatically. Local AI clients connect without credentials.

Desktop Proxy Tunnel

Command	Description
mcpbundles proxy start	Start WebSocket tunnel daemon
mcpbundles proxy stop	Stop tunnel daemon
mcpbundles proxy restart	Restart tunnel
mcpbundles proxy status	Show tunnel status
mcpbundles proxy logs	View tunnel logs
mcpbundles proxy logs -f	Follow logs in real-time

Configuration

Command	Description
mcpbundles config show	Show all settings
mcpbundles config set key value	Set a config value
mcpbundles config get key	Get a config value
mcpbundles config reset	Reset to defaults

Shell Completion

mcpbundlesinstall-completionbash# or zsh, fish

After installation, restart your shell for tab completion on commands, tool names, resource URIs, and connection names.

Output Modes

Flag	Behavior
--pretty	Rich tables, colors, syntax highlighting (default for discovery)
--json	Raw JSON to stdout, pipe-friendly (default for execution)
--raw	Full MCP response envelope (debugging)
--stream	Progressive line-by-line output (for exec)
-q / --quiet	Suppress non-essential output

Respects NO_COLOR environment variable.

Exit Codes

Code	Meaning
0	Success
1	User/input error (bad args, missing auth)
2	Tool execution error (tool returned isError)
3	Connection/server error (unreachable, 5xx)
4	Internal error

Configuration Files

All configuration is stored in ~/.mcpbundles/ by default. With ENVIRONMENT=development, the CLI normally uses ~/.mcpbundles-dev/ — unless MCPBundles Desktop already supervises a sidecar in the prod store (~/.mcpbundles/), in which case the CLI aligns with that store automatically. Override with MCPBUNDLES_CONFIG_DIR when needed.

File	Purpose
config.yaml	CLI settings (server, workspace, output format)
token.json	Encrypted OAuth tokens
sessions/	Named connection session files
completion_cache.json	Tab completion cache (60s TTL)
shell_history	REPL command history
tunnel.pid	Proxy daemon PID
tunnel.log	Proxy daemon logs

Config precedence (highest wins):

1. CLI flags (--url, --json, -q)
2. Environment variables (MCPBUNDLES_API_KEY, MCPBUNDLES_BASE_URL)
3. Config file (~/.mcpbundles/config.yaml)
4. Defaults

Security

• OAuth2 PKCE — no client secret stored on disk
• API keys prefixed mb_ — recognized and routed automatically
• Tokens encrypted with machine-specific Fernet key
• File permissions set to user-only (0600)
• Desktop proxy only forwards to localhost
• All tunnel traffic encrypted over WSS

Requirements

• Python 3.10+
• macOS or Linux
• Google Chrome (optional, for browser proxy feature)

Development

gitclonehttps://github.com/thinkchainai/mcpbundles-proxy.gitproxy
cdproxy
python-mvenv.venv&&.venv/bin/pipinstall-e".[dev]"
pytest

Learn More

• What is MCP? — Model Context Protocol explained
• CLI setup guide — full CLI documentation
• Browse all tools — search 500+ MCP tools
• Browse providers — every connected service
• Claude Code + MCP — connect Claude Code to 500+ APIs

Support

• Docs: https://www.mcpbundles.com/docs
• Email: support@mcpbundles.com

License

MIT License

Verified details

These details have been verified by PyPI

Maintainers

👁 Avatar for tonylewislondon from gravatar.com
tonylewislondon

Unverified details

These details have not been verified by PyPI

Project links

• Browse Providers
• Browse Tools
• Documentation
• Homepage
• Repository
• What is MCP?

• Download URL: mcpbundles-1.5.60.tar.gz
• Upload date: Jun 18, 2026
• Size: 187.9 kB
• Tags: Source
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.13.12

Hashes for mcpbundles-1.5.60.tar.gz

Algorithm	Hash digest
SHA256	ef8928185e626cb9d561bec3461018e86e7b6207ce3c6b01b4df292cee1fa69b
MD5	e0ba6ec150bcd109ddd70388624f0328
BLAKE2b-256	523bd6ae5aac0ba3bff1dbeca595d4f13201f234c228ce2e651bcede1015908a

See more details on using hashes here.

• Download URL: mcpbundles-1.5.60-py3-none-any.whl
• Upload date: Jun 18, 2026
• Size: 154.8 kB
• Tags: Python 3
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.13.12

Hashes for mcpbundles-1.5.60-py3-none-any.whl

Algorithm	Hash digest
SHA256	d6e3f539163ba75a6602c43829c84d6f48fd93ba1766446eed54acd8defe0905
MD5	9b2f5de61fa266f1088f1d3295d45545
BLAKE2b-256	91846a72651eeaaf1d3582f32355d7bd5caee2b0082f07c41c4b5fb37bb98027

See more details on using hashes here.