LibreAI / Dev Tools / mcp2cli
// devtools · knowsuchagency/mcp2cli

mcp2cli

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

★ 2.4k stars⑂ 179 forksMITupdated 2026-09
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

mcp2cli is an open-source dev tools project by knowsuchagency (knowsuchagency/mcp2cli on GitHub). It has 2,416 GitHub stars and 179 forks, is released under the MIT license, and was last updated on GitHub on 12 September 2026.

GitHub stars
2,416
Forks
179
License
MIT
Last updated on GitHub
12 September 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Pick your source: an MCP server (HTTP/SSE or stdio), an OpenAPI spec URL/file, or a GraphQL endpoint.

  2. Get mcp2cli

    Run it zero-install with uvx, or install it globally with uv tool.

  3. Connect and explore

    Run with --list (and --search) against your source, adding --oauth or --auth-header if the API needs authentication.

  4. Call and bake

    Call a tool/operation as a subcommand; if you'll reuse it, bake the connection into a named tool and call it with @name.

// features

Why people love it

Three source types

--mcp (HTTP/SSE), --mcp-stdio, --spec (OpenAPI JSON/YAML, local or remote) and --graphql modes all expose commands the same way.

Zero codegen

Commands are generated at runtime from the live schema — no client SDK to generate, build or keep in sync.

Built-in OAuth

Authorization-code + PKCE and client-credentials flows across all modes, with token caching/refresh and a manual-callback mode for headless hosts.

Secret hygiene

Auth values support env: and file: prefixes so secrets don't appear in process listings; baked configs mask known credential values.

Bake mode

Save a source, filters (--include/--exclude/--methods) and cache TTL as a named tool in ~/.config/mcp2cli/baked.json, even installable as a wrapper command.

Agent-friendly output

--json guarantees valid JSON on stdout, TOON output trims tokens on large arrays, usage-aware ranking keeps --list short, and specs are cached with a configurable TTL.

Advertisement
// run it

Run it yourself

  1. Clone the repo

    Clone mcp2cli if you want the source; the normal path is uvx/uv in step 2.

    git clone https://github.com/knowsuchagency/mcp2cli.git
    cd mcp2cli
  2. Run or install

    Run directly without installing, or install it globally.

    uvx mcp2cli --help
    # or: uv tool install mcp2cli
  3. List and call tools

    List an MCP server's tools, then call one as a subcommand (OpenAPI and GraphQL sources work the same way with --spec / --graphql).

    mcp2cli --mcp https://mcp.example.com/sse --list
    mcp2cli --mcp https://mcp.example.com/sse search --query "test"
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains mcp2cli?

knowsuchagency maintains it; the package is on PyPI as mcp2cli.

Is it free?

Yes, MIT-licensed.

Does it need a paid API key?

Only whatever the target API itself requires — mcp2cli adds auth-header and OAuth support to supply it, including from env vars or files.

How does it compare to an MCP gateway like MetaMCP?

A gateway hosts aggregated servers for clients to connect to. mcp2cli is the opposite direction: it consumes MCP/OpenAPI/GraphQL sources and presents them as a local CLI for humans, scripts and agents.

How do I get started?

uvx mcp2cli --help, then mcp2cli --spec <openapi.json URL> --list and call an operation.

// keep exploring

Similar tools

Dev Tools

OpenCLI

Turn any website into a CLI — and let AI agents drive your already-logged-in browser

★ 29.9k starsApache-2.0
View guide →
Dev Tools

ripwire

The ripgrep of AI context — a zero-dependency C++23 CLI + MCP server that maps your repo for coding agents

★ 2.4k starsApache-2.0
View guide →
Dev Tools

agents-cli

The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.

★ 6.0k starsApache-2.0
View guide →
Dev Tools

CodeGraphContext

An MCP server plus a CLI tool that indexes local code into a graph database to provide context to AI assistants.

★ 4.2k starsMIT
View guide →
Dev Tools

mcp-proxy

A bridge between Streamable HTTP / SSE and stdio MCP transports — connect any client to any server

★ 2.8k starsMIT
View guide →
Dev Tools

gitdiagram

Turn any GitHub repo into an interactive architecture diagram - just swap 'hub' for 'diagram'

★ 18.0k starsMIT
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if mcp2cli is not the right fit.

Get mcp2cli

Free and open — grab the source, star the repo, and start creating.