mcp-explorer 0.1

CLI tool for exploring MCP servers

mcp-explorer

CLI tool for exploring MCP servers

Installation

Install this tool using pip:

pip install mcp-explorer

Usage

List the tools exposed by a streamable HTTP MCP server:

mcp-explorer list https://agentic-mermaid.dev/mcp

The default output is deliberately compact: each tool is shown as a signature and a one-line description. Use -N or --no-truncate for full descriptions and detailed parameter metadata:

mcp-explorer list -N https://agentic-mermaid.dev/mcp

This forces the current MCP 2 stateless protocol by default. Use --legacy to force the older initialize-handshake protocol instead:

mcp-explorer --legacy list https://agentic-mermaid.dev/mcp

Use --json to output the complete tool definitions, including their input schemas:

mcp-explorer --json list https://agentic-mermaid.dev/mcp

Inspect a single tool in detail:

mcp-explorer inspect https://agentic-mermaid.dev/mcp render_svg

This displays the tool's complete description, nested input and output schemas, annotations, execution metadata, icons, and _meta. Use --json for the complete tool definition as a single JSON object:

mcp-explorer --json inspect https://agentic-mermaid.dev/mcp render_svg

Call a tool by passing its arguments as a JSON object:

mcp-explorer call \
  https://agentic-mermaid.dev/mcp \
  verify \
  '{"source":"graph TD; A-->B"}'

Alternatively, use repeatable -a/--argument NAME VALUE options:

mcp-explorer call \
  https://agentic-mermaid.dev/mcp \
  render_svg \
  -a source 'graph TD; A-->B' \
  -a options '{"padding":24}'

Use - to read the raw JSON object from standard input:

mcp-explorer call URL TOOL - < arguments.json

When raw JSON and -a are combined, individual arguments override matching top-level keys in the JSON object and later -a values win. Values are interpreted using the tool's input schema: strings remain literal, while numbers, booleans, arrays, objects, and null are parsed as JSON. The assembled arguments are validated against the input schema before the tool is called.

Use the shared --json option for the complete MCP CallToolResult:

mcp-explorer --json call URL TOOL -a name value

List every prompt exposed by a server:

mcp-explorer prompts URL
mcp-explorer prompts --json URL
mcp-explorer prompts --legacy URL

The human-readable output includes prompt arguments and whether each is required. JSON output contains the complete prompt definitions.

List every directly-addressable resource exposed by a server:

mcp-explorer resources URL
mcp-explorer resources --json URL
mcp-explorer resources --legacy URL

The human-readable output includes each resource URI, MIME type, size, and description when available. Both commands follow pagination until all results have been collected. The shared root-level --json and --legacy forms are also supported.

Use info to show the selected protocol, negotiation mechanism, supported versions, server identity, capabilities, and instructions:

mcp-explorer info https://agentic-mermaid.dev/mcp
mcp-explorer info --json https://agentic-mermaid.dev/mcp

Use doctor to check both stateless and legacy compatibility. The selected mode is checked first and determines the exit status:

mcp-explorer doctor https://agentic-mermaid.dev/mcp
mcp-explorer --legacy doctor https://agentic-mermaid.dev/mcp

The shared --json form is still accepted before any command. The --stateless/--legacy option is shared and must appear before the command name.

For help, run:

mcp-explorer --help

You can also use:

python -m mcp_explorer --help

Development

To contribute to this tool, first checkout the code. Run the tests like this:

cd mcp-explorer
uv run pytest

And the development version of the tool like this:

uv run mcp-explorer --help