# philschmid/mcp-cli

Lighweight CLI to interact with MCP servers

Repository: https://github.com/philschmid/mcp-cli
Canonical: https://ross.abutalabs.com/products/philschmid-mcp-cli
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2026-02-05T18:31:30+00:00

## Health v2 (maintenance only)
Score: 56/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 66, release rhythm 67, longevity 16
- inputs: {"age_days": 237, "days_push": 209, "days_rel": 222, "gap_med": 1.5, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1258, forks 164 (observed 2026-08-28T04:04:09.653646+00:00)

## What it is
A lightweight Bun-based command-line tool for interacting with MCP (Model Context Protocol) servers over stdio and HTTP. It lets users and AI coding agents discover, inspect, and call MCP tools from the shell with JSON output and connection pooling.

## Use cases
- list tools available on MCP servers from the terminal
- call an MCP tool with JSON arguments from the command line
- inspect a tool's input schema before invoking it
- search MCP tools by glob pattern
- let AI coding agents like Claude Code or Gemini CLI invoke MCP tools via shell
- pipe MCP tool results into jq or other shell tools

## When to choose
- you need a fast, single-binary CLI to exercise MCP servers
- you want shell-friendly JSON output for scripting or agent use
- you use both stdio and HTTP MCP servers and want one tool
- you want warm connection pooling instead of spawning servers per call

## When to avoid
- you need a full MCP client library embedded in an application
- you want a GUI or interactive dashboard for MCP servers
- your environment cannot run Bun-compiled binaries

## Facets
- artifact type: cli-tool
- maturity: active
- function: mcp, cli, developer-tools, agent-framework
- domain: developer-tools, large-language-models
- platform: cli, cross-platform, bun
- tags: model-context-protocol, mcp-client, bun, ai-coding-agents, shell-friendly, -output, command-line, ai-agents

## Member repositories
- philschmid/mcp-cli (main) score 56

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:09.653646+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:05:36.555147+00:00, confidence not recorded.
  - readme: https://github.com/philschmid/mcp-cli (fetched 2026-08-28T04:04:09.653646+00:00, sha a30b895f8d85)
- Data as of 2026-08-30T08:39:29.467469+00:00.