MCP Discovery

What is MCP Discovery?

MCP Discovery is a command-line tool written in Rust for discovering and documenting MCP Server capabilities. It displays MCP Server details such as tools, resources, and capabilities directly in the terminal or saves them to files in Markdown, HTML, plain text, JSON, or custom Handlebars templates.

How to use MCP Discovery?

Install the CLI via the project documentation, then run subcommands: print (default) to display capabilities, create to generate a new file, or update to insert capabilities into an existing file between markers. Provide the MCP Server command after --. Example: mcp-discovery -- npx -y @modelcontextprotocol/server-everything.

Key features of MCP Discovery

• Display MCP Server details (tools, resources, capabilities) in the terminal.
• Generate output files in Markdown, HTML, plain text, or JSON.
• Update existing files by inserting capabilities within markers.
• Choose from built-in templates (md, md-plain, html, txt) or supply custom Handlebars templates.
• Automate documentation workflows using the MCP Discovery GitHub Action.

Use cases of MCP Discovery

• Quickly inspect an MCP Server’s capabilities during development.
• Generate or refresh documentation files (README, capabilities pages) automatically.
• Embed up-to-date MCP Server information in CI/CD pipelines via GitHub Action.
• Create custom-styled reports using Handlebars templates for team or client deliverables.

FAQ from MCP Discovery

What runtime does MCP Discovery require?

MCP Discovery is a standalone CLI tool written in Rust; it does not require Node.js or other runtimes. However, the MCP Server you probe must be executable (e.g., via npx or a local binary).

How does MCP Discovery interact with an MCP Server?

It leverages the rust-mcp-sdk to communicate with the server over stdio by spawning the server command you provide.

Can I use custom output formatting?

Yes. You can supply a custom Handlebars template via the --template-file flag (from a file) or --template-string flag (inline string). For the update subcommand, you can also define an inline template inside the marker annotations in the target file.

Does MCP Discovery support authentication or transport options?

The README does not mention authentication or alternative transports; it focuses on stdio-based server interaction. For advanced transports, refer to the server’s own configuration.