Faf MCP
Universal MCP server for .faf — Cursor, Windsurf, VS Code, Cline, and all MCP-compatible platforms
Install / Use
/learn @Wolfe-Jam/Faf MCPQuality Score
Category
Development & EngineeringSupported Platforms
README
The MCP you didn't realise you needed, or wanted but didn't know who to ask, is here. Building on 36,000+ downloads across Claude and now Gemini, we bring you faf-mcp v2.0.0 to cure your syncing pain and fuel your chosen AI with optimized context, on-demand.
The only IANA-Registered Format for AI Context · application/vnd.faf+yaml
Define once. Sync everywhere.
You maintain .cursorrules. Your teammate uses AGENTS.md. Someone on the team just switched to Gemini. Every AI tool wants its own context file — and they all say the same thing in different formats.
faf-mcp is the dedicated MCP server for Cursor, Windsurf, Cline, VS Code, and every non-Claude platform. One .faf file in your repo, synced to every format your team needs.
project.faf
│
┌────────┬───────┴───────┬────────────┐
▼ ▼ ▼ ▼
CLAUDE.md AGENTS.md .cursorrules GEMINI.md
(Claude) (Codex) (Cursor) (Gemini)
Quick Start
npx faf-mcp
Add to your MCP config:
{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "faf-mcp"]}}}
| Platform | Config File |
|----------|-------------|
| Cursor | ~/.cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Cline | Cline MCP settings |
| VS Code | MCP extension config |
| Claude Desktop | Use claude-faf-mcp |
Three Ways to Deploy
| Door | Method | Best For |
|------|--------|----------|
| Hosted | mcpaas.live | Zero-install, point any MCP client to the URL |
| Self-Deploy | Deploy to Vercel | Your own instance, full control |
| Local | npx faf-mcp | IDE integration via stdio transport |
Hosted (mcpaas.live)
Point your MCP client to https://mcpaas.live/sse — no install, no config, no maintenance. Served from 300+ Cloudflare edges with sub-ms cold starts via 2.7KB Zig-WASM engine.
Self-Deploy (Vercel)
Deploy your own MCP server on Vercel in one click. Once deployed, your server exposes:
/health— Health check/info— Server metadata + tool list/sse— MCP Server-Sent Events transport
Local (npm)
npx faf-mcp
🔄 Interop Tools
| Tool | Platform | Action |
|------|----------|--------|
| faf_agents | OpenAI Codex | Import/export/sync AGENTS.md |
| faf_cursor | Cursor IDE | Import/export/sync .cursorrules |
| faf_gemini | Google Gemini | Import/export/sync GEMINI.md |
| faf_conductor | Conductor | Import/export directory structure |
| faf_git | GitHub | Generate .faf from any repo URL |
# Sync to all formats at once
faf bi-sync --all
# Generate .faf from any GitHub repo
faf_git { url: "https://github.com/facebook/react" }
61 tools (25 core + 36 advanced) · 309 tests (9 suites) · 7 bundled parsers
☁️ Cloud Sync
Share your FAF context globally via mcpaas.live:
| Tool | Purpose |
|------|---------|
| faf_cloud_publish | Upload to cloud, get shareable URL |
| faf_cloud_fetch | Pull context from cloud |
| faf_cloud_list | List available souls |
| faf_cloud_search | Search across souls |
| faf_cloud_share | Generate share links |
Example Workflow:
# Upload your project.faf
faf_cloud_publish { soul_name: "my-project" }
→ https://mcpaas.live/souls/my-project
# Anyone can fetch it
faf_cloud_fetch { soul_name: "my-project" }
→ Context merged into local project.faf
Zero-install sharing - Recipients need no MCP setup. Served from 300+ Cloudflare edges with <1ms cold starts via 2.7KB Zig-WASM engine.
🔄 Eternal Bi-Sync
Your .faf file and your platform context files stay synchronized in milliseconds.
project.faf ←── 8ms ──→ .cursorrules / AGENTS.md / CLAUDE.md / GEMINI.md
Single source of truth
- Update either side → both stay aligned
--allflag syncs to all four formats at once- Zero manual maintenance
- Works across teams, branches, sessions
AI assistants forget. They drift. Every new session, AI starts guessing again. Bi-sync means context never goes stale.
Tier System: From Blind to Optimized
| Tier | Score | Status | |------|-------|--------| | 🏆 Trophy | 100% | AI Optimized — Gold Code | | 🥇 Gold | 99%+ | Near-perfect context | | 🥈 Silver | 95%+ | Excellent | | 🥉 Bronze | 85%+ | Production ready | | 🟢 Green | 70%+ | Solid foundation | | 🟡 Yellow | 55%+ | AI flipping coins | | 🔴 Red | <55% | AI working blind | | 🤍 White | 0% | No context at all |
At 55%, AI is guessing half the time. At 100%, AI is optimized.
💬 use>faf | Prompt Pattern
Start every prompt with "Use FAF" to invoke MCP tools:
Use FAF to initialize my project
Use FAF to score my AI-readiness
Use FAF to sync my context
Use FAF to enhance my project
Works on all platforms — stops web search, forces tool usage.
🛠️ 25 Core MCP Tools
| Tool | Purpose |
|------|---------|
| faf_init | Initialize project.faf |
| faf_score | Check AI-readiness (0-100%) |
| faf_sync | Sync context across platforms |
| faf_bi_sync | Bi-directional .faf ↔ CLAUDE.md |
| faf_enhance | Intelligent enhancement |
| faf_read | Parse and validate FAF files |
| faf_write | Create/update FAF with validation |
| 🔄 Interop Tools | |
| faf_agents | Import/export/sync AGENTS.md |
| faf_cursor | Import/export/sync .cursorrules |
| faf_gemini | Import/export/sync GEMINI.md |
| faf_conductor | Import/export directory structure |
| faf_git | Generate .faf from GitHub repo URL |
| ☁️ Cloud Tools | |
| faf_cloud_publish | Upload to mcpaas.live |
| faf_cloud_fetch | Pull from cloud |
| faf_cloud_list | List souls |
| faf_cloud_search | Search souls |
| faf_cloud_share | Generate share links |
Plus 36 advanced tools and CLI fallback (via faf-cli v5.0.1):
faf readme- Extract 6 Ws from README (+25-35% boost)faf human-add- Non-interactive YAML merge (6Ws Builder)faf git- GitHub repo analysis without cloning- And 40+ more commands...
📦 Ecosystem
- claude-faf-mcp — Claude Desktop (33 tools)
- faf-cli — Terminal CLI
- faf-wasm — WASM SDK (<5ms scoring)
- faf.one — Official website
📄 License
MIT License — Free and open source
Zero drift. Eternal sync. AI optimized. 🏆
"It's so logical if it didn't exist, AI would have built it itself" — Claude
