IANA-Registered Format for AI Context · application/vnd.faf+yaml Universal version of claude-faf-mcp — Anthropic-approved MCP server, now compatible with all platforms. AI assistants forget. They misunderstand. They drift. Every new session, every new file, every new developer — AI starts guessing again. Your codebase context leaks away. Yesterday's perfect assistant becomes today's confused inter
Add this skill
npx mdskills install Wolfe-Jam/faf-mcpComprehensive MCP server providing AI context management through structured .faf files with scoring and sync
1<div style="display: flex; align-items: center; gap: 12px;">2 <img src="https://www.faf.one/orange-smiley.svg" alt="FAF" width="40" />3 <div>4 <h1 style="margin: 0; color: #FF8C00;">faf-mcp</h1>5 <p style="margin: 4px 0 0 0;"><strong>IANA-Registered Format for AI Context</strong> · <code>application/vnd.faf+yaml</code></p>6 </div>7</div>89> **.FAF optimizes AI for your codebase.** At 100% (Gold Code), AI stops guessing and starts knowing. Universal MCP server for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible platforms.1011**Universal version of [claude-faf-mcp](https://github.com/Wolfe-Jam/claude-faf-mcp)** — Anthropic-approved MCP server, now compatible with all platforms.1213[](https://github.com/Wolfe-Jam/faf-mcp/actions/workflows/ci.yml)14[](https://www.npmjs.com/package/faf-mcp)15[](https://www.npmjs.com/package/faf-mcp)16[](https://faf.one)17[](https://opensource.org/licenses/MIT)1819---2021## The Problem: Context-Drift2223AI assistants forget. They misunderstand. They drift.2425Every new session, every new file, every new developer — AI starts guessing again. Your codebase context leaks away. Yesterday's perfect assistant becomes today's confused intern.2627**.FAF fixes this permanently.**2829---3031## The Solution: Gold Code3233```34━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━35🏆 FAF AI-READINESS SCORE: 100/100 — GOLD CODE36━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━3738At 100%, AI is optimized. No more guessing.39Peak AI performance activated.4041├─ Project DNA locked in ├─ Zero context-drift42├─ Architecture understood ├─ Eternal bi-sync active43├─ Domain model captured ├─ Team alignment permanent44└─ Every session starts smart └─ AI works WITH you, not around you4546━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━47```4849---5051## 💎 Lifecycle Value5253Setup savings get you started. Lifecycle optimization keeps you ahead.5455| When | Without FAF | With FAF |56|------|-------------|----------|57| **Day 1** | 20 min setup per dev | 0 min — instant context |58| **Month 1** | AI forgets between sessions | AI remembers everything |59| **Year 1** | New devs re-explain everything | New devs inherit full context |60| **Year 3+** | Institutional knowledge lost | Project DNA preserved forever |6162**Setup savings: 20 minutes. Lifecycle savings: Infinite.**6364---6566## ⚡ Quick Start6768**1. Install:**6970```bash71npm install -g faf-mcp72```7374**2. Add to your MCP config:**7576```json77{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "faf-mcp"]}}}78```7980### Platform-Specific Setup8182| Platform | Config File |83|----------|-------------|84| **Cursor** | `~/.cursor/mcp.json` |85| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` |86| **Cline** | Cline MCP settings |87| **VS Code** | MCP extension config |88| **Claude Desktop** | Use [claude-faf-mcp](https://github.com/Wolfe-Jam/claude-faf-mcp) |8990---9192## ☁️ Cloud Sync (NEW in v1.3.0)9394Share your FAF context globally via [mcpaas.live](https://mcpaas.live):9596| Tool | Purpose |97|------|---------|98| `faf_cloud_publish` | Upload to cloud, get shareable URL |99| `faf_cloud_fetch` | Pull context from cloud |100| `faf_cloud_list` | List available souls |101| `faf_cloud_search` | Search across souls |102| `faf_cloud_share` | Generate share links |103104**Example Workflow:**105```bash106# Upload your project.faf107faf_cloud_publish { soul_name: "my-project" }108→ https://mcpaas.live/souls/my-project109110# Anyone can fetch it111faf_cloud_fetch { soul_name: "my-project" }112→ Context merged into local project.faf113```114115**Zero-install sharing** - Recipients need no MCP setup. Served from 300+ Cloudflare edges with <1ms cold starts via 2.7KB Zig-WASM engine.116117---118119## 🔄 Eternal Bi-Sync120121The magic: `.faf` ↔ `CLAUDE.md` stay synchronized in milliseconds.122123```124project.faf ←──── 8ms ────→ CLAUDE.md125 │ │126 └── Single source of truth ──┘127```128129- Update either file → both stay aligned130- Zero manual maintenance131- Works across teams, branches, sessions132- **Context never goes stale**133134---135136## Tier System: From Blind to Optimized137138| Tier | Score | Status |139|------|-------|--------|140| 🏆 **Trophy** | 100% | **AI Optimized** — Gold Code |141| 🥇 **Gold** | 99%+ | Near-perfect context |142| 🥈 **Silver** | 95%+ | Excellent |143| 🥉 **Bronze** | 85%+ | Production ready |144| 🟢 **Green** | 70%+ | Solid foundation |145| 🟡 **Yellow** | 55%+ | AI flipping coins |146| 🔴 **Red** | <55% | AI working blind |147| 🤍 **White** | 0% | No context at all |148149**At 55%, AI is guessing half the time.** At 100%, AI is optimized.150151---152153## 💬 use>faf | Prompt Pattern154155**Start every prompt with "Use FAF"** to invoke MCP tools:156157```158Use FAF to initialize my project159Use FAF to score my AI-readiness160Use FAF to sync my context161Use FAF to enhance my project162```163164Works on all platforms — stops web search, forces tool usage.165166---167168## 🛠️ 22 Native MCP Tools169170| Tool | Purpose |171|------|---------|172| `faf_init` | Initialize project.faf |173| `faf_score` | Check AI-readiness (0-100%) |174| `faf_sync` | Sync context across platforms |175| `faf_bi_sync` | Bi-directional .faf ↔ CLAUDE.md |176| `faf_enhance` | Intelligent enhancement |177| `faf_read` | Parse and validate FAF files |178| `faf_write` | Create/update FAF with validation |179| **☁️ Cloud Tools** | **(NEW in v1.3.0)** |180| `faf_cloud_publish` | Upload to mcpaas.live |181| `faf_cloud_fetch` | Pull from cloud |182| `faf_cloud_list` | List souls |183| `faf_cloud_search` | Search souls |184| `faf_cloud_share` | Generate share links |185186**Plus CLI fallback with 40+ commands** (via faf-cli v4.3.0):187- `faf readme` - Extract 6 Ws from README (+25-35% boost)188- `faf human-add` - Non-interactive YAML merge (6Ws Builder)189- `faf git` - GitHub repo analysis without cloning190- And 40+ more commands...191192---193194## 🎯 The .FAF Position195196```197 Platform Context Protocol198 ──────── ─────── ────────199 Cursor → .faf → MCP200 Windsurf → .faf → MCP201 Cline → .faf → MCP202 VS Code → .faf → MCP203 Claude → .faf → MCP204 Any IDE → .faf → MCP205```206207**.FAF is the foundational layer.** Universal context format. IANA-registered. Works everywhere.208209---210211## 📦 Ecosystem212213- **[claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)** — Claude Desktop (52 tools)214- **[faf-cli](https://npmjs.com/package/faf-cli)** — Terminal CLI (18k+ downloads)215- **[faf-wasm](https://www.npmjs.com/package/faf-wasm)** — WASM SDK (<5ms scoring)216- **[faf.one](https://faf.one)** — Official website217218---219220## 📄 License221222MIT License — Free and open source223224---225226**Zero drift. Eternal sync. AI optimized.** 🏆227228*"It's so logical if it didn't exist, AI would have built it itself" — Claude*229
Full transparency — inspect the skill content before installing.