MCP.so
Sign In

mcp-tools-cli

@moritalous

Repository

About mcp-tools-cli

command-line client for interacting with Model Context Protocol (MCP) servers.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_time",
        "--local-timezone=America/New_York"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-tools-cli?

mcp-tools-cli is a command-line client for interacting with Model Context Protocol (MCP) servers. It allows users to list available tools on a configured MCP server and call those tools directly from the terminal.

How to use mcp-tools-cli?

Install it via pip install mcp-tools-cli. Create a mcp_config.json file (or use --config-path) with server definitions under mcpServers. Then run commands like mcp-tools-cli list-tools --mcp-name <name> or mcp-tools-cli call-tool --mcp-name <name> --tool-name <tool>.

Key features of mcp-tools-cli

  • Lists tools available on any configured MCP server.
  • Calls MCP tools with optional JSON or string arguments.
  • Supports custom configuration file path via --config-path.
  • Provides clear error messages for common issues.
  • Works with any MCP server specified in the configuration file.

Use cases of mcp-tools-cli

  • Quickly inspect which tools an MCP server offers without custom code.
  • Integrate MCP tool calls into shell scripts or automation pipelines.
  • Test MCP server endpoints interactively during development.
  • Use as a lightweight alternative to a full MCP client when only tool listing and calling are needed.

FAQ from mcp-tools-cli

What configuration file does mcp-tools-cli use?

It uses a JSON file named mcp_config.json by default, which must contain a mcpServers object defining the command, arguments, and environment variables for each MCP server.

What actions can I perform with mcp-tools-cli?

Two actions are available: list-tools to list the tools provided by a given MCP server, and call-tool to invoke a specific tool with optional arguments.

How do I pass arguments to a tool when calling it?

Use the --tool-args option. It accepts a JSON string (e.g., '{"key":"value"}') or a plain string. If the string is not valid JSON, it is automatically passed as the query argument to the tool.

What happens if the MCP server is not defined in the configuration file?

The client prints a ValueError message indicating the MCP server name was not found in the configuration file.

Is a sample configuration provided?

Yes, a sample file mcp_config.sample.json is included in the package, configured for the Time MCP Server. To use it, install mcp-server-time first.

Frequently asked questions

What configuration file does mcp-tools-cli use?

It uses a JSON file named `mcp_config.json` by default, which must contain a `mcpServers` object defining the command, arguments, and environment variables for each MCP server.

What actions can I perform with mcp-tools-cli?

Two actions are available: `list-tools` to list the tools provided by a given MCP server, and `call-tool` to invoke a specific tool with optional arguments.

How do I pass arguments to a tool when calling it?

Use the `--tool-args` option. It accepts a JSON string (e.g., `'{"key":"value"}'`) or a plain string. If the string is not valid JSON, it is automatically passed as the `query` argument to the tool.

What happens if the MCP server is not defined in the configuration file?

The client prints a `ValueError` message indicating the MCP server name was not found in the configuration file.

Is a sample configuration provided?

Yes, a sample file `mcp_config.sample.json` is included in the package, configured for the Time MCP Server. To use it, install `mcp-server-time` first.

Comments

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

moritalous

More Developer Tools MCP servers

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.

MCP Unity Editor (Game Engine)

CoderGamester

Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs

1.8K

Deepwiki MCP Server

regenrek

📖 MCP server for fetch deepwiki.com and get latest knowledge in Cursor and other Code Editors

1.4K

Hello World MCP Server (Reference Extension)

anthropics

Desktop Extensions: One-click local MCP server installation in desktop apps

2.0K