# MCP Discovery

Find and start a zero-environment local MCP server when the session lacks a capability...

- Repository: https://github.com/codewhale-hq/Codewhale (41164 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add codewhale-hq/Codewhale --skill mcp-discovery -g -a claude-code -y`
Codex: `npx skills add codewhale-hq/Codewhale --skill mcp-discovery -g -a codex -y`
Cursor: `npx skills add codewhale-hq/Codewhale --skill mcp-discovery -g -a cursor -y`
Gemini CLI: `npx skills add codewhale-hq/Codewhale --skill mcp-discovery -g -a gemini-cli -y`

## Description

Find and start a zero-environment local MCP server when the session lacks a capability that no available tool, project script, or ordinary local code can cover.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# mcp-discovery

The public MCP Registry ships hundreds of ready-made stdio servers
(filesystems, databases, browsers, media processing, developer utilities, cloud
APIs, SaaS integrations, …). This skill is how you reach one when the session
is genuinely missing a capability.

It is a fallback, not a first step. Discovery costs a `tool_search` to load the
deferred tools, a query, an approval, and an install, spend that only when it
buys a capability you do not have.

## When to use

- An available tool, a project script or test, or a few lines of local code
  cannot do the job.
- The task needs an external service, database, or protocol client that this
  session has no access to.
- You would otherwise install a package or reimplement a well-known converter
  or client by hand.

## When not to use

- Ordinary work: writing and editing files, reading fixtures, running repo
  commands, and checking your own output. Do those directly.
- A capability an already-loaded tool covers, even partially, try it first.
- A near-miss row in a result list. A scored match is a suggestion; the missing
  capability is what decides.

## Workflow

The rest: https://github.com/codewhale-hq/Codewhale/blob/HEAD/crates/skills/assets/skills/mcp-discovery/SKILL.md