Universal MCP server for project documentation with smart classification
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":"briefmark-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.
<p align="center"> <img src="assets/logo.png" width="64" height="64" alt="BriefMark logo"> </p> <h1 align="center">BriefMark</h1> <p align="center"> <strong>Universal MCP server for project documentation</strong><br> Human reads the same docs as LLM. LLM reads and updates them via MCP tools. </p> <p align="center"> <a href="https://pypi.org/project/briefmark-mcp/"> <img src="https://img.shields.io/pypi/v/briefmark-mcp.svg" alt="PyPI"> </a> <a href="https://github.com/VladYankovenko/BriefMark/blob/main/LICENSE"> <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"> </a> <img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="Python"> <img src="https://img.shields.io/badge/mcp-1.0+-green.svg" alt="MCP"> </p> --- ## Install ```bash pip install briefmark-mcp ``` Or with pipx (recommended for CLI tools): ```bash pipx install briefmark-mcp ``` Or clone and install in development mode: ```bash git clone https://github.com/VladYankovenko/BriefMark.git cd BriefMark pip install -e ".[dev]" ``` ## Quick Start ```bash # Go to your project cd ~/projects/my-app # Initialize documentation structure briefmark init # Start the MCP server briefmark serve ``` ## Features - **Single Source of Truth** — one `Docs/` folder for humans and AI - **Bidirectional** — LLM can read AND write documentation via MCP tools - **Universal** — works with any MCP-compatible agent (Cursor, Claude, Cline, Kimi) - **Lightweight** — no external DB, no ML models, everything in project files - **Auto-Discovery** — scans structure without config - **Frontmatter-native** — documents declare their own metadata - **Section-level precision** — read, edit, or delete one section without touching the rest - **Token-first** — every tool returns `estimated_tokens`; agent sees operation cost - **Contextual search** — search results include excerpts around the match + document outline ## Project Structure ``` my-project/ ├── .briefmark/ │ ├─…
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.