MCP Tools CLI
A CLI for any MCP server: list and call tools, resources and prompts, run mock and proxy modes, guard access and manage agent configs
- 1,629 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Launches MCP servers and connects to remote servers over HTTP
- Proxy mode turns shell scripts into tools and runs them
Install
- Works in
Manual install
brew tap f/mcptools
brew install mcpmacOS install. The binary is installed as mcp and is also available as mcpt.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Launches MCP servers and connects to remote servers over HTTP
- Proxy mode turns shell scripts into tools and runs them
This is third-party code. Review the repository files before installing.
What it does
MCP Tools is a Go command-line utility for working with Model Context Protocol servers over stdio and HTTP transports. It lists and calls a server's tools, resources and prompts, prints results as a table or JSON, and opens an interactive shell or a web interface. Mock mode spins up a stub server for client testing, proxy mode turns shell scripts into MCP tools, and guard mode restricts tool access by patterns. A separate command scans and edits MCP configuration across VS Code, Cursor, Windsurf, Claude Desktop and Claude Code. It also scaffolds a new TypeScript server.
Who it is for. For developers and devops engineers who build, debug or wire up MCP servers.
Good fit when
- You need to quickly see what tools and resources an MCP server exposes and call them from the terminal
- You need a mock or proxy server to test an MCP client without a full implementation
- You need to add or restrict MCP servers in Cursor, VS Code, Claude Desktop and Claude Code configs
Not a fit when
- You need a ready application MCP server, not a tool for working with servers
- You need config scanning outside macOS: that command is macOS only for now
Example request
Connect to my MCP server with mcp tools and call the tool I need with parametersLimitations
Application config scanning and editing work on macOS only for now. Guard mode applies to the stdio transport only, not HTTP. The HTTP SSE transport supports only protocol version 2024-11-05. The scaffolding generator creates TypeScript projects only.
How to disable. Remove the binary via brew uninstall mcp, or delete the installed go binary. Its settings and logs live in ~/.mcpt.
FAQ
What is the binary called after install?
Homebrew installs mcp with an mcpt alias. Building from source produces mcptools, which you can alias to mcpt.
Does it work with remote servers?
Yes. URLs default to streamable HTTP, and the SSE transport is picked up automatically when the address ends with /sse.
Discussion
No questions or reviews yet.
Related
CLI toolsA universal MCP CLI client from Apify: persistent sessions, OAuth, JSON output for scripts and shell access to any MCP server for agents
A CLI that turns any MCP server, OpenAPI spec or GraphQL endpoint into commands at runtime, with no codegen
A proxy compresses the tool descriptions of a large MCP server so the model spends context only on the calls it needs.
A Python framework and CLI for MCP: write servers as plain functions, test tools and install servers into Claude Code, Cursor and other clients
The mcpl CLI searches tools across several MCP servers and calls them from the terminal, with OAuth sign-in done by a human
An MCP bridge: a single run_python tool runs code in a container and calls your MCP servers
README in short
The README calls the project a Swiss Army knife for MCP servers and describes the tools, resources, prompts, call, shell and web commands for inspecting and calling a server's capabilities. It also covers the mock, proxy and guard server modes, plus server aliases and application config management. Install is via Homebrew on macOS or go install on Windows and Linux, and Homebrew installs the templates into the home directory. Output formats are table, json and pretty. MIT licensed.