by knowsuchagency · knowsuchagency/mcp2cli
Point mcp2cli at an MCP server (or any OpenAPI/GraphQL endpoint) and get a typed CLI you can use from shells, scripts, or other agents — no code generation.
mcp2cli inspects the target server's schema and dispatches calls at runtime. Useful for sanity-checking an MCP server, scripting against it, or letting non-agent tooling reuse the same backend.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"mcp2cli": {
"command": "uvx",
"args": [
"mcp2cli"
]
}
}
}Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.
{
"mcpServers": {
"mcp2cli": {
"command": "uvx",
"args": [
"mcp2cli"
]
}
}
}Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.
{
"mcpServers": {
"mcp2cli": {
"command": "uvx",
"args": [
"mcp2cli"
]
}
}
}Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".
{
"mcpServers": {
"mcp2cli": {
"command": "uvx",
"args": [
"mcp2cli"
]
}
}
}Same shape as Claude Desktop. Restart Windsurf to pick up changes.
{
"mcpServers": [
{
"name": "mcp2cli",
"command": "uvx",
"args": [
"mcp2cli"
]
}
]
}Continue uses an array of server objects rather than a map.
{
"context_servers": {
"mcp2cli": {
"command": {
"path": "uvx",
"args": [
"mcp2cli"
]
}
}
}
}Add to context_servers. Zed hot-reloads on save.
claude mcp add mcp2cli -- uvx mcp2cliOne-liner. Verify with claude mcp list. Remove with claude mcp remove.
When to use: You're building/debugging an MCP and want to call tools directly.
Outcome: Tight dev loop without booting a chat client.
Build with fastmcp; debug with mcp2cli
| Tool | Inputs | When to call | Cost |
|---|---|---|---|
| list / call / describe | (see docs) | CLI subcommands; no MCP tools surfaced | 1 call |
call JSON into jq for downstream scriptingSchema not foundEnsure the target speaks one of MCP / OpenAPI / GraphQL
| Alternative | When to use it instead | Tradeoff |
|---|---|---|
| MCP Inspector | You want a UI | Not pipeable |