MCP server that extracts complete knowledge from any codebase — architecture, patterns, dependencies, API surface
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"ferret-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Ferret MCP [](https://pypi.org/project/ferret-mcp/) [](https://pepy.tech/project/ferret-mcp) [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](https://github.com/fabdendev/ferret-mcp/actions/workflows/tests.yml) An [MCP](https://modelcontextprotocol.io/) server that extracts complete knowledge from any codebase — architecture, patterns, dependencies, API surface. Combines static analysis with AI-powered deep interpretation. Works with any MCP client: [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Claude Desktop](https://claude.ai), [Cursor](https://cursor.sh), and more. **Give it a repo, get a senior engineer's analysis in 30 seconds for ~$0.09.** ## Quickstart ### Install & run with uvx (no clone needed) ```bash uvx ferret-mcp ``` ### Or install with pip ```bash pip install ferret-mcp ``` ## MCP Client Setup ### Claude Code ```bash claude mcp add ferret -- uvx ferret-mcp ``` To enable AI-powered tools (`deep`, `ask`), set your API key: ```bash claude mcp add ferret -e FERRET_LLM_API_KEY=sk-ant-... -- uvx ferret-mcp ``` ### Claude Desktop / Cursor / Windsurf / any MCP client Add to your MCP config file (`claude_desktop_config.json`, `.cursor/mcp.json`, etc.): ```json { "mcpServers": { "ferret": { "command": "uvx", "args": ["ferret-mcp"], "env": { "FERRET_LLM_API_KEY": "sk-ant-..." } } } } ``` ### Local development ```bash git clone https://github.com/fabdendev/ferret-mcp.git cd ferret-mcp cp .env.example .env # Add your API key uv sync uv run ferret-mcp ``` ## Tools ### Static Analysis (free, no LLM required) | Tool |…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.