simonw/mcp-explorer

CLI tool for exploring an MCP server

About mcp-explorer

List the tools exposed by a streamable HTTP MCP server:

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:

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

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

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:

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

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

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

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 --json to print the tool's structuredContent as JSON. If the result has no structured content, this falls back to printing the first text content block:

Use --raw for the complete MCP CallToolResult as JSON:

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/simonw--mcp-explorer.html)

Related MCP servers