Mcpc

mcpc — a universal MCP CLI client

mcpc is a command-line client for the Model Context Protocol (MCP)
that maps every MCP operation to an intuitive shell command.

Use it to manually inspect and debug MCP servers, to script repeatable MCP workflows in plain shell, or to
give AI agents the full MCP protocol through a single Bash() tool call, so they can interact with any MCP
server and its latest capabilities using the most universal programming interface there is: the UNIX shell.

Key features:

- 🔧 Full MCP support - Tools, prompts, resources, async tasks, skills, notifications, and logging over stdio and Streamable HTTP.
- 🔄 Persistent sessions - Keep connections to multiple servers alive in parallel, whether the server protocol is stateful or stateless.
- 🗺️ Progressive tool discovery - Find relevant MCP tools on the fly to save tokens and increase accuracy.
- 🔌 Code mode - JSON output composes with jq, xargs, and shell pipelines for MCP workflows as shell scripts.
- 🔒 Secure - Full OAuth 2.1 support with CIMD and DCR, uses OS keychain for credentials storage.
- 🤖 AI sandboxing - Proxy MCP server connections to protect credentials from AI-generated code.
- 🪶 Lightweight - Minimal dependencies, works on Mac/Win/Linux, doesn't use LLMs on its own.
- 💸 Agentic payments - Experimental support for the x402 protocol on Base.

mcpc is the most MCP specification-compliant CLI client available:
the only one that covers tools, resources, prompts, async tasks, and skills, plus the OAuth client-credentials and
enterprise-managed authorization extensions, on the latest protocol version. Here's how it compares to other MCP CLI
clients (see Related work for the full table, legend, and notes):

Table of contents

- Motivation
- Install
- Quickstart
- Usage
- Sessions
-…