MCP Tools Cli

@moritalous

Basic information

About MCP Tools Cli

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

MCP Tools Cli 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"
      ]
    }
  }
}

MCP Tools Cli tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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.

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

More Developer Tools MCP servers

Foremerge

naw103

Catch intent conflicts before code conflicts. The open-source coordination protocol for coding agents, built above Git.

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

Meticulous

Adgentek Ad Server (AdsMCP)

Adgentek

AdsMCP is the MCP entry point into the Adgentek Ad Server. Call ads_serve with the conversation context and get back a native ad matched to user intent, or no ad when one does not fit. Publishers earn on a CPM basis. Fre

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP