How do I run an MCP server using this CLI?

You can run a server from an npm package using 'npx @wong2/mcp-cli npx ' or from local code using 'npx @wong2/mcp-cli node path/to/server/index.js args...'.

Can I connect to an already running MCP server?

Yes, you can connect over Streamable HTTP using '--url' or over SSE using '--sse' options.

Is there support for scripting calls to tools or prompts?

Yes, the CLI supports a non-interactive mode to call tools, read resources, or use prompts with JSON arguments for automation.

Does the CLI handle OAuth authentication?

Yes, it supports OAuth for SSE and Streamable HTTP servers and can purge stored OAuth tokens.

What configuration files does the CLI use?

It uses config files in the same format as Claude Desktop's configuration, which can be specified with the '-c' option.

MCP Cli

clitoolsoauthmcpinspection

Command-line inspector and client for running and interacting with Model Context Protocol servers.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

We couldn’t automatically confirm this listing starts correctly

We ran the install command below but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @wong2/mcp-cli

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "wong2-mcp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wong2/mcp-cli"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

This CLI tool allows developers to run MCP servers from various sources, list and invoke tools, resources, and prompts, and connect to running MCP servers via HTTP or SSE. It supports OAuth for streaming servers and provides both interactive and non-interactive modes for automation. Use it to inspect, test, and script interactions with MCP servers locally or remotely.

Use cases

Run MCP servers from local files or npm packages

List available tools, resources, and prompts on an MCP server

Invoke tools and read resources or prompts interactively or via scripts

Connect to running MCP servers over HTTP or SSE

Manage OAuth tokens and purge stored authentication data

Key features

Run MCP servers from local code or npm packages

List and call tools, resources, and prompts

Support for OAuth authentication with SSE and HTTP streaming servers

Interactive and non-interactive command modes

Connect to running servers via Streamable HTTP or SSE

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Cli.

Extracted Tool Capabilities

Run MCP servers from local code or npm packages

List and call tools, resources, and prompts

Support for OAuth authentication with SSE and HTTP streaming servers

Interactive and non-interactive command modes

Connect to running servers via Streamable HTTP or SSE

Documentation Overview

mcp-cli

A CLI inspector for the Model Context Protocol

https://github.com/user-attachments/assets/4cd113e9-f097-4c9d-b391-045c5f213183

Features

Run MCP servers from various sources
List Tools, Resources, Prompts
Call Tools, Read Resources, Read Prompts
OAuth support for SSE and Streamable HTTP servers

Usage

Run without arguments

Terminal

npx @wong2/mcp-cli

This will use the config file of Claude Desktop.

Run with a config file

Terminal

npx @wong2/mcp-cli -c config.json

The config file has the same format as the Claude Desktop config file.

Run servers from NPM

Terminal

npx @wong2/mcp-cli npx <package-name> <args>

Add --pass-env if the server needs environment variables from your current shell.

Run locally developed server

Terminal

npx @wong2/mcp-cli node path/to/server/index.js args...

Add --pass-env if the server needs environment variables from your current shell.

Connect to a running server over Streamable HTTP

Terminal

npx @wong2/mcp-cli --url http://localhost:8000/mcp

Connect to a running server over SSE

Terminal

npx @wong2/mcp-cli --sse http://localhost:8000/sse

Non-interactive mode

Run a specific tool, resource, or prompt without interactive prompts:

Terminal

npx @wong2/mcp-cli [--config config.json] <command> <server-name>:<target> [--args '{}']

Examples:

bash

# Call a tool without arguments
npx @wong2/mcp-cli -c config.json call-tool filesystem:list_files

# Call a tool with arguments
npx @wong2/mcp-cli -c config.json call-tool filesystem:read_file --args '{"path": "package.json"}'

# Read a resource
npx @wong2/mcp-cli -c config.json read-resource filesystem:file://system/etc/hosts

# Use a prompt
npx @wong2/mcp-cli -c config.json get-prompt filesystem:create_summary --args '{"text": "Hello world"}'

This mode is useful for scripting and automation, as it bypasses all interactive prompts and executes the specified primitive directly.

Purge stored data (OAuth tokens, etc.)

Terminal

npx @wong2/mcp-cli purge

mcpservers.org - A curated list of MCP servers

Read the full README →View source on GitHub →

Related MCP Servers

View all in Other Tools and Integrations View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

444

Stargazers on the source repository.

Last commit

3mo ago

Most recent push to the default branch.

Install check

Inconclusive

Didn't respond in our test window — often a slow first install.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Cli

You can run a server from an npm package using 'npx @wong2/mcp-cli npx <package-name> <args>' or from local code using 'npx @wong2/mcp-cli node path/to/server/index.js args...'.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/wong2-mcp-cli?style=directory)](https://allmcps.com/mcp/wong2-mcp-cli)

HTML Embed

<a href="https://allmcps.com/mcp/wong2-mcp-cli"><img src="https://allmcps.com/api/badge/wong2-mcp-cli?style=directory" alt="MCP Cli on AllMCPs" /></a>

Technical Specs & Signals

CategoryOther Tools and Integrations

PricingFree

43Quality signal: Fair · 43/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity6/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 1

Scanned 26d ago via OSV.dev · @wong2/mcp-cli (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🛠️ Other Tools and Integrations →Alternatives to MCP Cli →Install in Claude Desktop Install in Cursor Install in VS Code

MCP Cli

clitoolsoauthmcpinspection

Command-line inspector and client for running and interacting with Model Context Protocol servers.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

We couldn’t automatically confirm this listing starts correctly

We ran the install command below but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @wong2/mcp-cli

No response to initialize.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "wong2-mcp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wong2/mcp-cli"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Run MCP servers from local files or npm packages

List available tools, resources, and prompts on an MCP server

Invoke tools and read resources or prompts interactively or via scripts

Connect to running MCP servers over HTTP or SSE

Manage OAuth tokens and purge stored authentication data

Key features

Run MCP servers from local code or npm packages

List and call tools, resources, and prompts

Support for OAuth authentication with SSE and HTTP streaming servers

Interactive and non-interactive command modes

Connect to running servers via Streamable HTTP or SSE

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Cli.

Extracted Tool Capabilities

Run MCP servers from local code or npm packages

List and call tools, resources, and prompts

Support for OAuth authentication with SSE and HTTP streaming servers

Interactive and non-interactive command modes

Connect to running servers via Streamable HTTP or SSE

Documentation Overview

mcp-cli

A CLI inspector for the Model Context Protocol

https://github.com/user-attachments/assets/4cd113e9-f097-4c9d-b391-045c5f213183

Features

Run MCP servers from various sources
List Tools, Resources, Prompts
Call Tools, Read Resources, Read Prompts
OAuth support for SSE and Streamable HTTP servers

Usage

Run without arguments

Terminal

npx @wong2/mcp-cli

This will use the config file of Claude Desktop.

Run with a config file

Terminal

npx @wong2/mcp-cli -c config.json

The config file has the same format as the Claude Desktop config file.

Run servers from NPM

Terminal

npx @wong2/mcp-cli npx <package-name> <args>

Add --pass-env if the server needs environment variables from your current shell.

Run locally developed server

Terminal

npx @wong2/mcp-cli node path/to/server/index.js args...

Add --pass-env if the server needs environment variables from your current shell.

Connect to a running server over Streamable HTTP

Terminal

npx @wong2/mcp-cli --url http://localhost:8000/mcp

Connect to a running server over SSE

Terminal

npx @wong2/mcp-cli --sse http://localhost:8000/sse

Non-interactive mode

Run a specific tool, resource, or prompt without interactive prompts:

Terminal

npx @wong2/mcp-cli [--config config.json] <command> <server-name>:<target> [--args '{}']

Examples:

bash

# Call a tool without arguments
npx @wong2/mcp-cli -c config.json call-tool filesystem:list_files

# Call a tool with arguments
npx @wong2/mcp-cli -c config.json call-tool filesystem:read_file --args '{"path": "package.json"}'

# Read a resource
npx @wong2/mcp-cli -c config.json read-resource filesystem:file://system/etc/hosts

# Use a prompt
npx @wong2/mcp-cli -c config.json get-prompt filesystem:create_summary --args '{"text": "Hello world"}'

This mode is useful for scripting and automation, as it bypasses all interactive prompts and executes the specified primitive directly.

Purge stored data (OAuth tokens, etc.)

Terminal

npx @wong2/mcp-cli purge

mcpservers.org - A curated list of MCP servers

Read the full README →View source on GitHub →

Related MCP Servers

View all in Other Tools and Integrations View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

444

Stargazers on the source repository.

Last commit

3mo ago

Most recent push to the default branch.

Install check

Inconclusive

Didn't respond in our test window — often a slow first install.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Cli

You can run a server from an npm package using 'npx @wong2/mcp-cli npx <package-name> <args>' or from local code using 'npx @wong2/mcp-cli node path/to/server/index.js args...'.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/wong2-mcp-cli?style=directory)](https://allmcps.com/mcp/wong2-mcp-cli)

HTML Embed

<a href="https://allmcps.com/mcp/wong2-mcp-cli"><img src="https://allmcps.com/api/badge/wong2-mcp-cli?style=directory" alt="MCP Cli on AllMCPs" /></a>

Technical Specs & Signals

CategoryOther Tools and Integrations

PricingFree

43Quality signal: Fair · 43/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity6/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 1

Scanned 26d ago via OSV.dev · @wong2/mcp-cli (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🛠️ Other Tools and Integrations →Alternatives to MCP Cli →Install in Claude Desktop Install in Cursor Install in VS Code