mcpli MCP server
Commit Oct 18, 2026Provides a command-line interface for interacting with MCP servers through list, describe, call, and REPL commands.
Also known as eliware/mcpli
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 18, 2026
- License
- MIT
What is mcpli MCP?
mcpli provides a command-line interface for interacting with MCP servers through list, describe, call, and REPL commands.
Summary generated from the project's README
About mcpli MCP server
Interacting with MCP servers through a terminal interface is what mcpli enables for developers and shell automation scripts. This command-line client allows users to manage and execute tools from remote servers by providing a structured way to communicate with them via the command line. It requires Node.js 26 or later to function.
Users connect to servers by configuring the MCP_URL, MCP_PORT, and MCP_TOKEN environment variables or by passing the --url and --token flags directly to commands. The client operates by closing the connection after each individual command execution. It provides specific commands including list to see available tools, describe to inspect a tool, call to execute a tool with JSON arguments, and a repl for interactive sessions.
What you can do with it
- 1List available server toolsA developer can quickly see all tools exposed by a specific MCP server.
- 2Execute specific tool functionsYou can trigger a tool like task-search by passing a JSON string of arguments.
- 3Automate server interactions in scriptsThe tool is designed for shell automation and can be used within command-line workflows.
- 4Inspect tool definitionsUsers can retrieve detailed information about a specific tool's capabilities.
Written from the project's README. Every use case is checked against a quote from it.
README
View on GitHub
@eliware/mcpli 
A powerful command-line MCP client for agents, developers, and shell automation.
Table of Contents
- Features
- Requirements
- Setup
- Usage
- Development
- Testing
- Troubleshooting
- Security
- Configuration
- Operations
- Commands
- Exit codes
- Support
- Links
- License
Features
The CLI has list, describe, call, and repl commands.
Read the documentation index.
Requirements
Use Node.js 26 or later.
Setup
Install mcpli with npm:
npm install --global @eliware/mcpli
Usage
Set MCP_URL and optional MCP_TOKEN values. Use --url and --token for one command.
Read the user guide and release notes.
mcpli list
mcpli call task-search '{"includes":{"pending":true}}'
Development
Run npm ci. Then run npm test.
Read the repository specifications.
Testing
Run npm test to check the repository.
Troubleshooting
Read the troubleshooting guide.
Security
Keep tokens private. Send credentials only to the MCP server that you select.
Configuration
Set MCP_URL, MCP_PORT, and MCP_TOKEN, or set --url, --token, and --transport.
Read configuration details.
Operations
The client closes after each command. Read the user guide for connection details.
Commands
Use list, describe <tool>, call <tool> [json-arguments], or repl.
Read the command guide for options and results.
Exit codes
| Code | Meaning |
|---|---|
0 |
The command completed. |
1 |
The command failed. |
Support
For help, questions, or to chat with the author and community, visit:
Links
License
mcpli MCP questions
What commands are available in mcpli?
The CLI supports list, describe, call, and repl commands.
What are the system requirements for mcpli?
You must use Node.js version 26 or later.