CAP MCP: Model Context Protocol server for codebase awareness
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":"cap-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.
 [](https://github.com/psf/black) [](LICENSE) [](https://python.org) [](https://nodejs.org) [](https://code.visualstudio.com/) # CAP - Codebase Awareness Protocol > Give AI coding agents the context they need - architecture, dependencies, and API - so they stop guessing and start respecting your codebase. --- ## Philosophy AI coding agents are powerful, but they are blind. They see files, not architecture. They read imports, not intent. Without explicit context, they silently violate boundaries, import forbidden packages, and ignore the structure you spent months building. **CAP fixes this.** You describe your codebase once in three small YAML files. CAP serves that knowledge to any AI agent through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/), the open standard for connecting AI to tools. The result: agents that understand your layers, respect your dependency rules, and use your public API - without you repeating yourself in every prompt. ### Three principles 1. **Declarative over discovery** - You know your codebase better than static analysis. Write it down once, in plain YAML. 2. **Protocol over prompts** - Structured MCP tool responses beat pasted context every time. 3. **Zero lock-in** - YAML files live in your repo. No SaaS, no accounts, no telemetry. --- ## Getting Started ### VS Code Extension (recommended) The fastest path. The extension handles Python, installs CAP, runs the MCP server, and connects it to your AI agent - all automatically. **1. Install the extension** Search for **"CAP - Codebase Awareness Protocol"**…
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.