Back to search
mcp-explorer
MCP serverGitHub
CLI tool for exploring an MCP server
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/simonw--mcp-explorer)HTML
<a href="/listings/simonw--mcp-explorer"><img src="/api/listings/simonw--mcp-explorer/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install this tool using `pip`:
pip install mcp-explorer
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 287 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # mcp-explorer
- [](https://pypi.org/project/mcp-explorer/)
- [](https://github.com/simonw/mcp-explorer/releases)
- [](https://github.com/simonw/mcp-explorer/actions/workflows/test.yml)
- [](https://github.com/simonw/mcp-explorer/blob/master/LICENSE)
- CLI tool for exploring MCP servers
- ## Installation
- Install this tool using `pip`:
- ```bash
- pip install mcp-explorer
- ```
- ## Usage
- List the tools exposed by a streamable HTTP MCP server:
- ```bash
- 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:
- ```bash
- 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:
- ```bash
- mcp-explorer list https://agentic-mermaid.dev/mcp --legacy
- ```
- Use `--json` to output the complete tool definitions, including their input schemas:
- ```bash
- mcp-explorer list https://agentic-mermaid.dev/mcp --json
- ```
- Inspect a single tool in detail:
- ```bash
- 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:
- ```bash
- mcp-explorer inspect https://agentic-mermaid.dev/mcp render_svg --json
- ```
- Call a tool by passing its arguments as a JSON object:
- ```bash
- mcp-explorer call \
- https://agentic-mermaid.dev/mcp \
- verify \
- '{"source":"graph TD; A-->B"}'
- ```
- Alternatively, use repeatable `-a/--argument NAME VALUE` options:
- ```bash
- 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:
- ```bash
- 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 `--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:
- ```bash
- mcp-explorer call \
- https://datasette.simonwillison.net/-/mcp \
- execute_sql \
- -a database simonwillisonblog \
- -a sql 'select count(*) from blog_entry' \
- --json
- ```
- Use `--raw` for the complete MCP `CallToolResult` as JSON:
- ```bash
- mcp-explorer call URL TOOL -a name value --raw
- ```
- List every prompt exposed by a server:
- ```bash
- mcp-explorer prompts URL
- mcp-explorer prompts URL --json
- mcp-explorer prompts URL --legacy
- ```
- 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:
- ```bash
- mcp-explorer resources URL
- mcp-explorer resources URL --json
- mcp-explorer resources URL --legacy
- ```
- 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.
- Use `info` to show the selected protocol, negotiation mechanism, supported versions, server identity, capabilities, and instructions:
- ```bash
- mcp-explorer info https://agentic-mermaid.dev/mcp
- mcp-explorer info https://agentic-mermaid.dev/mcp --json
- ```
- Use `doctor` to check both stateless and legacy compatibility. The selected mode is checked first and determines the exit status:
- ```bash
- mcp-explorer doctor https://agentic-mermaid.dev/mcp
- mcp-explorer doctor https://agentic-mermaid.dev/mcp --legacy
- ```
- Every command accepts `--json` and `--stateless/--legacy`. These options can appear anywhere after the command name. The `call` command also accepts `--raw`.
- For help, run:
- ```bash
- mcp-explorer --help
- ```
- You can also use:
- ```bash
- python -m mcp_explorer --help
- ```
- ## Development
- To contribute to this tool, first checkout the code. Run the tests like this:
- ```bash
- cd mcp-explorer
- uv run pytest
- ```
- And the development version of the tool like this:
- ```bash
- uv run mcp-explorer --help
- ```
- To update the `--help` reference in the README:
- ```bash
- uv run cog -r README.md
- ```
- ## Command reference
- <!-- [[[cog
- import cog
- from click.testing import CliRunner
- from mcp_explorer.cli import cli
- runner = CliRunner()
- sections = []
- for command in cli.commands:
- result = runner.invoke(cli, [command, "--help"])
- help = result.output.replace("Usage: cli", "Usage: mcp-explorer")
- sections.append(
- "### `mcp-explorer {} --help`\n\n```\n{}\n```".format(command, help)
- )
- cog.out("\n\n".join(sections))
- ]]] -->
- ### `mcp-explorer list --help`
- ```
- Usage: mcp-explorer list [OPTIONS] URL
- List the tools exposed by an MCP server at URL.
- Options:
- -N, --no-truncate Show full descriptions and detailed parameters.
- --json Output JSON.
- --stateless / --legacy Force stateless MCP 2 (default) or the legacy
- initialize handshake.
- --help Show this message and exit.
- ```
- ### `mcp-explorer prompts --help`
- ```
- Usage: mcp-explorer prompts [OPTIONS] URL
- List the prompts exposed by an MCP server at URL.
- Options:
- --json Output JSON.
- --stateless / --legacy Force stateless MCP 2 (default) or the legacy
- initialize handshake.
- --help Show this message and exit.
- ```
- ### `mcp-explorer resources --help`
- ```
- Usage: mcp-explorer resources [OPTIONS] URL
- List the resources exposed by an MCP server at URL.
- Options:
- --json Output JSON.
- --stateless / --legacy Force stateless MCP 2 (default) or the legacy
- initialize handshake.
- --help Show this message and exit.
- ```
- ### `mcp-explorer inspect --help`
- ```
- Usage: mcp-explorer inspect [OPTIONS] URL TOOL_NAME
- Inspect one tool exposed by an MCP server at URL.
- Options:
- --json Output JSON.
- --stateless / --legacy Force stateless MCP 2 (default) or the legacy
- initialize handshake.
- --help Show this message and exit.
- ```
- ### `mcp-explorer call --help`
- ```
- Usage: mcp-explorer call [OPTIONS] URL TOOL_NAME [ARGUMENTS_JSON]
- Call a tool with optional JSON and individual arguments.
- Options:
- -a, --argument NAME VALUE Set one tool argument; repeat for multiple
- arguments.
- --raw Output the complete MCP CallToolResult as JSON.
- --json Output JSON.
- --stateless / --legacy Force stateless MCP 2 (default) or the legacy
- initialize handshake.
- --help Show this message and exit.
- ```
- ### `mcp-explorer info --help`
- ```
- Usage: mcp-explorer info [OPTIONS] URL
- Show protocol and metadata for an MCP server at URL.
- Options:
- --json Output JSON.
- --stateless / --legacy Force stateless MCP 2 (default) or the legacy
- initialize handshake.
- --help Show this message and exit.
- ```
- ### `mcp-explorer doctor --help`
- ```
- Usage: mcp-explorer doctor [OPTIONS] URL
- Check stateless and legacy compatibility for an MCP server at URL.
- Options:
- --json Output JSON.
- --stateless / --legacy Force stateless MCP 2 (default) or the legacy
- initialize handshake.
- --help Show this message and exit.
- ```
- <!-- [[[end]]] -->
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.