Universal MCP server for .FAF (Foundational AI-context Format) with 17 native tools + CLI fallback - Persistent project context for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible platforms (including Claude Desktop)
Universal version of claude-faf-mcp — Anthropic-approved MCP server, now compatible with all platforms. Built on the IANA-registered .FAF format (application/vnd.faf+yaml).
1. Install:
npm install -g faf-mcp2. Copy and paste this to your AI:
Install the FAF MCP server: npm install -g faf-mcp, then add this to my MCP config: {"mcpServers": {"faf": {"command": "npx", "args": ["-y", "faf-mcp"]}}} and restart.
Cursor IDE: Add to ~/.cursor/mcp.json (setup guide)
Windsurf Editor: Add to ~/.codeium/windsurf/mcp_config.json (Cascade docs)
Cline: Add to Cline's MCP settings
VS Code: Install MCP extension, then add server config
Claude Desktop: Use the dedicated claude-faf-mcp package for optimized Claude integration
"README for the AI era" — Google Gemini
project.faf is to AI context what package.json is to dependencies
Lives at the project root, between package.json and README.md
The closer you get to 100% the better AI can assist you.
At 55% you are building your project with half a blueprint and basically flipping a coin with AI. .FAF defines, and AI becomes optimized for Context with the project.faf file.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏎️ FAF AI-READINESS SCORE: 100/100 — PODIUM EDITION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 CORE INTELLIGENCE 🎯 CONTEXT DELIVERY
├─ Project DNA [██████] 100% ├─ MCP Protocol [██████] 100%
├─ Architecture Map [██████] 100% ├─ 17 Native Tools [██████] 100%
├─ Domain Model [██████] 100% ├─ IANA Format [██████] 100%
└─ Version Tracking [██████] 100% └─ Universal Context [██████] 100%
🚀 PERFORMANCE ⚡ STANDALONE OPERATION
├─ 16.2x CLI Speedup [██████] 100% ├─ Zero Dependencies [██████] 100%
├─ 19ms Avg Execution [██████] 100% ├─ Bundled Engine [██████] 100%
├─ 17/17 Tools Active [██████] 100% ├─ Direct Function [██████] 100%
└─ Zero Memory Leaks [██████] 100% └─ 14 Bundled Cmds [██████] 100%
🏆 project.faf score: podium
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
We're launching faf-mcp as the universal package. If you'd prefer a dedicated package for your platform (like cursor-faf-mcp or windsurf-faf-mcp with tailored setup instructions), request it here.
We'll publish platform-specific packages based on demand.
Start every prompt with "Use FAF" to invoke MCP tools directly:
Use FAF to initialize my project
Use FAF to sync my project.faf to all platforms
Use FAF to score my AI-readiness
Use FAF to enhance my project context
Use FAF to create platform sync files
Claude Desktop:
- ✅ Calls MCP tool instead of searching web
- ✅ No void container issues
- ✅ Direct tool invocation
Claude.ai (Web):
- ✅ Stops web search addiction immediately
- ✅ Forces MCP tool usage
- ✅ No more guessing
Cursor / Windsurf / Cline:
- ✅ MCP standard compliance
- ✅ Tool invocation (not manual file creation)
- ✅ Consistent behavior
Without "Use FAF":
- ❌ AI searches the web
- ❌ AI creates files manually
- ❌ Void containers
- ❌ Inconsistent results
With "Use FAF":
- ✅ MCP tool called correctly
- ✅ Championship output
- ✅ Every time
The .FAF Position in the MCP Ecosystem:
Platform Context Protocol
──────── ─────── ────────
Any IDE → IANA Format → Open Protocol
Cursor → .faf → MCP
Windsurf → .faf → MCP
Cline → .faf → MCP
VS Code → .faf → MCP
Claude → .faf → MCP
Gemini → .faf → MCP
.FAF is the foundational, universal base layer for any platform using the Model Context Protocol. It provides the standardized Context that makes MCP work for everyone.
- faf_init - Initialize project.faf with auto-detection
- faf_score - AI-readiness scoring engine
- faf_enhance - Intelligent enhancement with auto-detection
- faf_read - Parse and validate FAF files
- faf_write - Create/update FAF with validation
- faf_sync - Synchronize context across platforms
- faf_bi_sync - Bi-directional CLAUDE.md sync
- faf readme - Smart 6 Ws extraction from README.md
- faf human-add - Non-interactive human context entry
- faf git - GitHub repo extraction (Git CLI, no rate limits)
- Plus all other faf-cli commands
- Official MIME type:
application/vnd.faf+yaml - W3C-compliant structured format
- Universal AI context protocol
- Cross-platform compatibility
- 16.2x faster than CLI versions (direct function calls vs process spawning)
- 19ms average execution across all bundled commands
- Fastest: 1ms (formats command)
- Zero memory leaks with F1-grade engineering
- Full Documentation - Complete guide
- Getting Started - Installation & setup
- MCP Tools Reference - All 17 native tools
- FAQ - Common questions
- CHANGELOG - Version history
🏅 Creators of the Format - We designed .FAF (IANA-registered application/vnd.faf+yaml)
🏅 First & Only - Persistent Project Context MCP Server approved by Anthropic
🏅 Creators of Context-Mirroring - faf_bi_sync creates native files for all platforms
🏅 Google Chrome-Approved - Published Chrome Extension
🏅 15K+ npm Downloads - Proven adoption across the FAF ecosystem
"README for the AI era" — Google Gemini
Persistent Context - Your project's DNA lives in project.faf, readable by any AI or human
Universal Format - IANA-registered standard works across Claude, Gemini, Cursor, Windsurf, any MCP platform
Zero Setup Tax - One file (project.faf) eliminates AI context setup across your entire team
FREE FOREVER - MIT License, open source, no subscription
All Boats Rise Together - Improving projects, AI performance, code quality, speed to market for everyone
Championship Engineering - F1-inspired performance with strict TypeScript, zero runtime errors
- FAF Format Spec - Official IANA specification
- FAF CLI - Command-line tooling
- claude-faf-mcp - Claude Desktop-specific package
- Chrome Extension - Browser integration
- faf.one - Official website and documentation
- Discord Community - Join the discussion
MIT License - Free and open source
Built with F1-inspired engineering principles 🏎️⚡
"It's so logical if it didn't exist, AI would have built it itself" — Claude