# Tool Disco

> a tool discovery-oriented mcp server chain

- **Type:** MCP server
- **Install:** `agentstack add mcp-egoughnour-tool-disco`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [egoughnour](https://agentstack.voostack.com/s/egoughnour)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [egoughnour](https://github.com/egoughnour)
- **Source:** https://github.com/egoughnour/tool-disco

## Install

```sh
agentstack add mcp-egoughnour-tool-disco
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# tool-disco

   
   
   
A tool discovery-oriented MCP (Model Context Protocol) server that matches tools to natural language goals. It integrates with Azure DevOps to discover tools documented in wikis and uses code-graph-rag for code analysis.

## Features

- **Natural Language Tool Discovery**: Describe what you want to accomplish, and tool-disco finds matching tools
- **Azure DevOps Integration**: Scans organization wikis for tool documentation with front matter metadata
- **Code Graph Integration**: Ingests repositories via [code-graph-rag-mcp](https://github.com/er77/code-graph-rag-mcp) for code analysis
- **Tool Composition**: Automatically generates multi-tool workflows
- **Proxy Testing**: Tests tool candidates using lightweight proxies, scripts, and simple models

## Installation

```bash
npm install
npm run build
```

## Usage

### As an MCP Server

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "tool-disco": {
      "command": "node",
      "args": ["/path/to/tool-disco/dist/index.js"]
    }
  }
}
```

### Available Tools

#### `discover_tools`
Discover tools matching a natural language goal.

```json
{
  "goal": "I need to process CSV files and generate reports",
  "context": "Working with sales data",
  "constraints": ["Must handle large files", "Output as PDF"]
}
```

#### `scan_azure_devops`
Scan an Azure DevOps organization for repositories with wikis and extract tool metadata.

```json
{
  "organization": "https://dev.azure.com/myorg",
  "pat": "your-personal-access-token",
  "project": "optional-project-name"
}
```

#### `ingest_repo`
Ingest a repository into the code graph for tool discovery.

```json
{
  "repoUrl": "https://github.com/org/repo",
  "repoName": "my-repo"
}
```

#### `test_composition`
Test a tool composition against the discovery goal.

```json
{
  "compositionId": "composed-tool1-tool2",
  "inputs": { "file": "data.csv" }
}
```

#### `list_candidates`
List all registered tool candidates.

#### `get_discovery_stats`
Get statistics about discovered tools and ingested repositories.

## Wiki Front Matter Format

Document tools in Azure DevOps wikis using YAML front matter:

```markdown
---
toolName: data_processor
description: Processes data files and extracts insights
tags: data,processing,etl
timeout: 5000
implementation: scripts/processor.js
inputs:
  file:
    type: string
    description: Path to the input file
---

# Data Processor

Documentation for the data processor tool...
```

## Architecture

```mermaid
   graph TB
       subgraph "Tool Disco MCP Server"
           ADO[Azure DevOps Integration]
           CG[Code Graph Integration]
           TD[Tool Discovery]
           PT[Proxy Tester]
           ADO --> TD
           CG --> TD
           TD --> PT
       end
   ```

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Type check
npm run lint
```

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [egoughnour](https://github.com/egoughnour)
- **Source:** [egoughnour/tool-disco](https://github.com/egoughnour/tool-disco)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-egoughnour-tool-disco
- Seller: https://agentstack.voostack.com/s/egoughnour
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.