explaingit

ieranama/discomcp

Analysis updated 2026-05-18

3RustAudience · developerComplexity · 3/5LicenseSetup · easy

TLDR

DiscoMCP explores an MCP server the way you actually use it and generates a safe, read-only skill file that teaches AI agents your real workflows instead of a generic tool list.

Mindmap

mindmap
  root((discomcp))
    What it does
      Explores MCP servers
      Learns real usage patterns
      Generates usage skill files
      Read-only guaranteed
    Tech stack
      Rust
      MCP protocol
    Use cases
      Agent tool onboarding
      Safe exploration
      Fewer round-trips
    Audience
      AI agent developers
      MCP server operators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a usage-specific skill file for an MCP server so agents follow your real workflows instead of guessing.

USE CASE 2

Safely explore an unfamiliar or production MCP server without risking any writes or deletions.

USE CASE 3

Reduce the number of round-trips an AI agent needs to complete complex, multi-step tasks against a tool.

What is it built with?

RustMCP

How does it compare?

ieranama/discomcpadsharma/ast-grepcodeitlikemiley/antigravity-sdk-rust
Stars333
LanguageRustRustRust
Setup difficultyeasyeasyhard
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Single binary via npx, but requires writing a small TOML config pointing at your MCP server.

Dual licensed under Apache 2.0 or MIT, use freely including commercially, your choice of either license.

In plain English

DiscoMCP helps AI agents work with your tools more effectively by teaching them how you actually use those tools, not just what they can technically do. MCP, short for Model Context Protocol, is a way for AI agents to connect to external systems and services. The problem this project addresses is that when an agent connects to a tool with dozens or even a hundred possible actions, it often does not know which ones matter for your specific work, how your data is organized, or what is safe to touch. As a result, the agent either guesses or gets stuck. DiscoMCP solves this by pointing itself at an MCP server and exploring it the way a careful, cautious user would. It learns which handful of actions you actually rely on, in what order you tend to use them, and how the results of one action lead naturally into the next. It builds this understanding by observing your real workspace and the data that is genuinely there, rather than relying on a generic list of what the tool offers. Safety is a central design principle. The exploration process runs behind what the project calls a default deny gate: it will only perform an action if it can prove that action only reads data and cannot write, change, or delete anything, even if the tool itself claims to be harmless. Any sensitive information encountered during exploration is stripped out before being saved. According to benchmarks in the README, agents equipped with a generated skill from DiscoMCP complete tasks in noticeably fewer steps than agents working cold, with the biggest improvements showing up on harder, more complex tasks. The tool is a single binary requiring no separate installation, and getting started involves running it directly with a simple configuration file pointing to the target MCP server. Under the hood, DiscoMCP is built in Rust, with a small deterministic core enforcing every safety check while a language model handles the actual thinking and exploration. Every fact recorded in a generated skill is labeled by how it was learned, whether declared outright, documented, directly observed, or inferred, so the agent using it does not mistake a guess for something confirmed. The project is dual licensed under the Apache License 2.0 and the MIT License.

Copy-paste prompts

Prompt 1
Run DiscoMCP against my MCP server configuration and generate a usage skill file.
Prompt 2
Explain how DiscoMCP's default-deny read-only exploration works and why it's safe to run on production tools.
Prompt 3
Show me the discomcp.toml configuration format for pointing DiscoMCP at a new MCP server.
Prompt 4
Help me drop a DiscoMCP-generated SKILL.md into my agent's configuration.

Frequently asked questions

What is discomcp?

DiscoMCP explores an MCP server the way you actually use it and generates a safe, read-only skill file that teaches AI agents your real workflows instead of a generic tool list.

What language is discomcp written in?

Mainly Rust. The stack also includes Rust, MCP.

What license does discomcp use?

Dual licensed under Apache 2.0 or MIT, use freely including commercially, your choice of either license.

How hard is discomcp to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is discomcp for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.