What problem does it solve?
Many agents and developer tools must reconnect to remote MCP servers individually, which leads to repeated authorization flows, fragmented credentials, and excessive context usage. This CLI centralizes named connections locally so you can connect once and invoke tools, resources, and prompts from any shell or scripted workflow without reauthenticating each time.
Core Features & Use Cases
- Centralized connections: Save named MCP server connections per profile and reuse them across tools and scripts.
- Tool invocation: List, inspect, and call remote MCP tools interactively or with JSON arguments, with local argument validation against the tool's JSON schema.
- Auth and tunneling: Support OAuth PKCE flows with an optional ngrok tunnel for public callbacks, and a local callback server for capturing tokens.
- Profiles & inheritance: Maintain nested profiles with inherited connections and per-profile auth state for staging, production, or multi-tenant workflows.
- Transport resilience: Uses Streamable HTTP with SSE fallback and sensible error messages for robust connectivity.
Quick Start
Use mcp-cli to connect to a server with no browser by running the connect command with the --no-open flag, save the connection under a name, and then run the named connection's tools list to see available tools.