Skip to content
 __  __  ____ ____  __  __
|  \/  |/ ___|  _ \ \ \/ /
| |\/| | |   | |_) | \  /
| |  | | |___|  __/  /  \
|_|  |_|\____|_|    /_/\_\

MCP servers as CLI tools.

Stop loading tool schemas into context.
Give the AI a terminal command instead.

go install github.com/codestz/mcpx/cmd/mcpx@latest
Native MCP
# .mcp.json — loaded at session start
"serena": { ... } # ~20K tokens
"sequential-thinking": { ... } # ~5K tokens
"filesystem": { ... } # ~10K tokens
"github": { ... } # ~30K tokens
"brave-search": { ... } # ~4K tokens
 
Total: ~69K tokens before any work.
MCPX
# CLAUDE.md — 3 lines
Use `mcpx list` to discover tools.
Use `mcpx <server> <tool> --help`.
Call tools via Bash as needed.
 
 
 
Total: 0 tokens. Tools called on demand.
0
tokens upfront
<5ms
startup time
1
binary, zero deps
servers, same cost

See it work

terminal
$mcpx list
serena uvx (daemon)
sequential-thinking npx
$mcpx ping serena
serena: ok (21 tools, 47ms)
$mcpx serena find_symbol --name "Auth" --json
{ "name": "AuthService", "file": "src/auth.go", "kind": "class" }
_

Three commands to start

1
Install
go install github.com/codestz/mcpx/cmd/mcpx@latest
2
Configure
mcpx init
3
Call
mcpx serena find_symbol --name "Auth"

On-Demand Discovery

Tools discovered lazily with mcpx list and --help. The AI only pays for what it uses.

UNIX Composability

Every MCP tool becomes a CLI command. Pipe between servers, redirect, compose. The AI already knows how.

Daemon Mode

Heavy servers stay warm between calls via unix socket. Zero spawn cost after first invocation.

Secure by Default

No shell expansion. Secrets from OS keychain. Strict variable parsing. Zero injection surface.

Any MCP Server

If it speaks MCP protocol, mcpx wraps it. Zero changes to the server required.

Single Binary

Written in Go. No runtime dependencies. Ships as one file. Sub-millisecond startup.

MCP tools belong in the terminal.

mcpx puts them there.

Released under the MIT License.