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).

⚡ Quick Start

1. Install:

npm install -g faf-mcp

2. 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.

Platform-Specific Setup

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

🏁 AI-Readiness Scorecard

"README for the AI era" — Google Gemini

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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯 Want a Platform-Specific Package?

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.

💬 use>faf | Prompt Pattern

Start every prompt with "Use FAF" to invoke MCP tools directly:

All Platforms

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

Why "Use FAF" Works Everywhere

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

The Pattern

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

🎯 What is FAF?

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.

🛠️ Core Features

17 Native MCP Tools

• 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

CLI Fallback (40+ commands)

• 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

IANA-Registered Standard

• Official MIME type: application/vnd.faf+yaml
• W3C-compliant structured format
• Universal AI context protocol
• Cross-platform compatibility

Championship Performance

• 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

📚 Documentation

• Full Documentation - Complete guide
• Getting Started - Installation & setup
• MCP Tools Reference - All 17 native tools
• FAQ - Common questions
• CHANGELOG - Version history

🏆 Why FAF?

Championship Credentials

🏅 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

The FAF Advantage

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

📦 Ecosystem

• 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

📄 License

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