Skip to content
aicoolies logo
mcp2cli logo

mcp2cli

Turn any MCP server, OpenAPI spec, or GraphQL endpoint into a CLI — at runtime, with zero codegen.

mcp2cli turns MCP servers, OpenAPI specs, and GraphQL endpoints into standard CLIs at runtime — no codegen, no schema bloat. Tools and arguments load only when requested via --list and --help flags, cutting up to 96–99% of the tokens that native MCP integrations waste on schema preloading. Works with Claude Code, Cursor, Codex, and any agent that can call shell commands, and ships with OAuth, stdio/HTTP/SSE transports, and a bake mode for reusable connections.

About mcp2cli

MCP servers, OpenAPI specs, and GraphQL endpoints all share the same problem when wired into agentic workflows: every session loads full schemas upfront, and those schemas can consume thousands of tokens before any real work begins. In long Claude Code, Cursor, or Codex sessions with multiple servers configured, that overhead compounds across every turn — even when the agent only ever calls one or two tools. mcp2cli turns any of these surfaces into a standard command-line interface at runtime, with no code generation and no persistent server. Tools and arguments load on demand through `--list` and `--help` flags, so the agent fetches only the schema fragments it actually uses, only when it needs them.

The savings claim is concrete: 96 to 99 percent fewer tokens compared to native MCP tool calls in typical workloads. mcp2cli supports MCP over HTTP, SSE, and stdio transports, OpenAPI specs as local files or remote URLs, and GraphQL endpoints with introspection-driven query generation. OAuth is built in across all three modes — authorization code with PKCE for browser logins, client credentials for machine-to-machine flows, and automatic token refresh persisted under `~/.cache/mcp2cli/oauth/`. A `bake` subcommand lets developers freeze a configured connection into a named alias (`mcp2cli @petstore list-pets`), and `bake install` writes a standalone wrapper into `~/.local/bin` so an agent can call the baked tool as if it were a native binary.

mcp2cli surfaced on Hacker News in May 2026 with 144 points and over a hundred comments, driven largely by the "MCP tax" framing that landed with teams already tracking per-session token costs. The project is MIT licensed, written in Python, distributed via PyPI (`uvx mcp2cli` or `uv tool install mcp2cli`), and ships an installable AI agent skill that teaches Claude Code, Cursor, and Codex how to invoke it. With more than 2,100 GitHub stars and active commits in the past week, it represents one of the first production-ready answers to a problem that grows worse as MCP adoption deepens — and as agent sessions get longer, token-efficient tool invocation is likely to become a default expectation rather than an optimization.

Pricing & Platform Specs

Pricing Summary

100% free and open source under the MIT license ($0 software cost). mcp2cli is an open-source CLI tool that automatically wraps and exposes Model Context Protocol (MCP) servers as interactive command-line utilities with zero licensing fees.

Supported Platforms

CLI distributed via PyPI (uvx / uv tool install). Works on macOS, Linux, and Windows. Integrates with Claude Code, Cursor, Codex, and any agent that can invoke shell commands.

Explore categories, tags & use cases

Categories

Protocol bridge converting MCP stdio transport to HTTP/SSE endpoints

mcp-proxy is a protocol bridge that converts MCP servers using stdio transport into HTTP and Server-Sent Events endpoints accessible over the network. This enables remote MCP server hosting, load balancing, and sharing servers across multiple AI clients. Supports both directions: wrapping stdio servers with HTTP and connecting to remote SSE servers through local stdio. Over 2,400 GitHub stars.

Open Source

Apache-2.0 Python framework for building MCP servers, clients, apps, and deployable agent tool surfaces.

FastMCP is an Apache-2.0 Python framework for building MCP servers, clients, and apps with decorators, type hints, transports, auth patterns, deployment docs, and telemetry hooks. The project now resolves to PrefectHQ/fastmcp, with Prefect Horizon available as a separate enterprise MCP gateway for identity, RBAC, audit, monitoring, and server governance.

Open Source

CLI package manager for MCP servers with profile-based configuration

MCPM is a command-line package manager for MCP servers that handles installation, configuration, and profile management. It supports profile-based server grouping where different AI workflows use different sets of MCP servers. Features a server registry, automatic dependency resolution, and configuration file management for Claude Desktop and other MCP clients.

Open Source

Side-by-Side Comparisons

WOZCODE logo
WOZCODE
vs
mcp2cli logo
mcp2cli

WOZCODE vs mcp2cli — Token Optimization at Different Layers of the Claude Code Stack

WOZCODE and mcp2cli both promise to cut Claude Code costs dramatically, but they attack the problem from opposite ends. WOZCODE intercepts tool execution to compress the dynamic loop while you are coding; mcp2cli converts verbose MCP, OpenAPI, and GraphQL schemas into compact CLI tools so Claude reads less before every turn. Picking the right one — or running both — depends on where your token budget is actually bleeding.

WOZCODEmcp2cli

Community experience

Sources & verification

Sources checked
Content verified

Verification dates are editorial checks. Routine CMS saves and automatic updatedAt timestamps do not advance them.

FAQ

What is mcp2cli?

mcp2cli turns MCP servers, OpenAPI specs, and GraphQL endpoints into standard CLIs at runtime — no codegen, no schema bloat. Tools and arguments load only when requested via --list and --help flags, cutting up to 96–99% of the tokens that native MCP integrations waste on schema preloading. Works with Claude Code, Cursor, Codex, and any agent that can call shell commands, and ships with OAuth, stdio/HTTP/SSE transports, and a bake mode for reusable connections.

Is mcp2cli free?

Yes — mcp2cli is open source and free to use. 100% free and open source under the MIT license ($0 software cost). mcp2cli is an open-source CLI tool that automatically wraps and exposes Model Context Protocol (MCP) servers as interactive command-line utilities with zero licensing fees.

Is mcp2cli open source?

Yes — mcp2cli is open source.

Is mcp2cli still maintained?

Yes — mcp2cli is active. Its listing was last verified on August 26, 2026.

What are the best mcp2cli alternatives?

The first editor-selected mcp2cli alternatives are mcp-proxy, FastMCP, MCPM.