v0.1 — now available

Turn any
MCP server
into a CLI

mcp2cli connects to an MCP server, introspects its tool catalog, and generates a complete CLI. Each tool becomes a subcommand. Each parameter becomes a flag. Single binary. Zero config.

MCP servers are great for agents. Now they're great for humans too.

terminal
$ mcp2cli init --source "npx -y @modelcontextprotocol/server-everything"
Connecting to MCP server...
Found 6 tools
echo Echoes back the input
add Adds two numbers
get-tiny-image Returns a small test image
long-running-operation Simulates a long operation
sample-llm Samples from an LLM
annotated-message Sends an annotated message
Generated CLI: ~/.mcp2cli/bin/server-everything
$ server-everything echo --message "hello from the terminal"
hello from the terminal
1Command
AnyMCP Server
0Config Required
0Dependencies

How it works

Point it at a server. Get a CLI. Every MCP tool becomes a subcommand with typed flags and help text.

Auto-Introspection

Connects to any MCP server over stdio, discovers its full tool catalog, and maps every tool to a subcommand automatically.

Schema-to-Flags Mapping

JSON Schema types become typed CLI flags. Strings, numbers, booleans, arrays, and enums are all handled. Descriptions become help text.

Generated Shell Scripts

Produces standalone bash scripts that route subcommands back through mcp2cli exec. Add to PATH and use anywhere.

JSON & Human Output

Every command supports --json for structured output that pipes into jq, gripe, or any other tool. Human-friendly tables by default.

Update & Sync

Server tools change over time. Run mcp2cli update to re-introspect and regenerate the CLI in place. Always in sync.

Multi-Server Management

Init multiple servers, list them, remove them. Each gets its own config manifest and generated script. No conflicts.

Why mcp2cli?

Test from the terminal

MCP servers were built for agents. Now you can test, debug, and explore them without spinning up a framework.

Compose in pipelines

Pipe MCP tool output into jq, gripe, or any Unix tool. JSON output makes MCP servers first-class shell citizens.

Use in CI

Generated scripts are standalone bash. Check them into your repo, run them in CI, use them in Makefiles. No runtime needed.

Convert a server in 10 seconds

One command to init. The generated CLI is ready immediately.

# Install
cargo install mcp2cli
# Convert any MCP server
mcp2cli init --source "npx -y @modelcontextprotocol/server-filesystem"
# Use it
server-filesystem read-file --path ./README.md