claude-faf-mcp

Tell AI what you're building, who it's for, and why it matters. 30 seconds. 🐘 It never forgets.

FAF defines. MD instructs. AI codes.

🐘 tri-sync now free for all builders — .faf ↔ CLAUDE.md ↔ MEMORY.md in one command. Pro feature. Now free.

⚡ New: /faf prompt — type /faf in Claude Desktop. It checks your project, scores it, drives it to 100%, and syncs. Relentlessly. One command.

32 MCP tools. 1 prompt. IANA-registered format (application/vnd.faf+yaml). 2,346 test executions per push.

The 3Ws — 3 Answers. That's It.

Every great product started with 3 answers to the 3Ws — Who, What, Why:

| | WHO is it for? | WHAT does it do? | WHY build it? | |---|-----|------|-----| | Uber | People who need a ride | Tap a button, car arrives | Taxis were broken | | Airbnb | Travelers who can't afford hotels | Stay in someone's spare room | Millions of empty rooms exist | | Slack | Teams drowning in email | Organized group messaging | Decisions buried in threads | | Venmo | Friends splitting bills | Send money instantly | Someone always forgets to pay back |

Same pattern. Every product that works starts here. .faf captures it:

human_context:
  who: "people who need a ride across town"
  what: "tap a button, car arrives in minutes"
  why: "taxis are slow, expensive, and hard to find"

30 seconds. Claude builds your project.faf from this. Every session after, AI starts smart.

The 6Ws — For Optimized AI

3Ws gets you started. For fully optimized AI, complete the set — Where, When, How:

  where: "mobile app, iOS and Android"    # where does it live?
  when: "launch in 3 months"              # when is it shipping?
  how: "GPS matching, real-time pricing"  # how does it work?

3Ws initiates the project with AI. 6Ws optimizes AI to 100%. Same YAML, same file. More examples → faf.one/ideas

Quick Start

One-click install — Claude Desktop

⬇ Download claude-faf-mcp-5.5.1.mcpb

Double-click the downloaded file. Claude Desktop installs it automatically. No terminal. No JSON config. 32 tools live in 10 seconds.

Or — copy-paste to Claude

Install the FAF MCP server: npm install -g claude-faf-mcp, then add this to my claude_desktop_config.json: {"mcpServers": {"faf": {"command": "npx", "args": ["-y", "claude-faf-mcp"]}}} and restart Claude Desktop.

Or — manual npm install

npm install -g claude-faf-mcp

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "faf": { "command": "npx", "args": ["-y", "claude-faf-mcp"] }
  }
}

Restart Claude Desktop.

Then

Type /faf — Claude checks your project, scores it, drives it to 100%, and syncs. Done.

Or tell Claude your 3Ws: "I'm building [what] for [who] because [why]"

How It Works

You → 3 answers → project.faf → AI reads it → every session → forever

project.faf  ←── 8ms ──→  CLAUDE.md     (bi-sync, free)
project.faf  ←── 8ms ──→  MEMORY.md     (tri-sync, Pro 🐘)

Claude does the rest. Zero-effort, right first time, fast, accurate, done. Language, framework, package manager, build tools — all auto-detected from your existing files. The human context is the part only you can give.

Scoring: From Blind to Optimized

| Tier | Score | What it means | |------|-------|---------------| | 🏆 Trophy | 100% | Gold Code — AI is optimized | | 🥇 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 guesses half the time. At 100%, AI knows your project. Same compiler as faf-cli — same score everywhere.

32 MCP Tools

All tools run standalone — zero CLI dependencies, 19ms average execution.

Create & Detect | Tool | Purpose | |------|---------| | faf_init | Initialize project DNA | | faf_auto | Auto-detect stack and populate context | | faf_quick | Lightning-fast creation (3ms) | | faf_readme | Extract context from README (+25-35% boost) | | faf_formats | Discover all formats in your project | | faf_git | Extract context from any GitHub repo URL | | faf_human_add | Add human context (the 6Ws) |

Validate & Score | Tool | Purpose | |------|---------| | faf_score | AI-readiness score (0-100%) with breakdown | | faf_check | Validate .faf structure | | faf_doctor | Diagnose and fix common issues | | faf_go | Guided interview to Gold Code |

Sync & Persist | Tool | Purpose | |------|---------| | faf_sync | Sync .faf → CLAUDE.md | | faf_bi_sync | Bi-directional .faf ↔ CLAUDE.md | | faf_tri_sync | Tri-sync .faf ↔ CLAUDE.md ↔ MEMORY.md — Pro feature, free for developers 🐘 | | faf_enhance | Intelligent enhancement |

Export & Interop | Tool | Purpose | |------|---------| | faf_agents | Import/export AGENTS.md (OpenAI Codex) | | faf_cursor | Import/export .cursorrules (Cursor IDE) | | faf_gemini | Import/export GEMINI.md (Google Gemini) | | faf_conductor | Import/export Conductor directory |

Read & Write | Tool | Purpose | |------|---------| | faf_read | Read any file | | faf_write | Write any file | | faf_status | Project status overview | | faf_debug | Environment inspection | | faf_about | What is .faf? |

Full tool reference →

🐘 Nelly Never Forgets

bi-sync keeps .faf ↔ CLAUDE.md aligned.

tri-sync adds MEMORY.md — your AI remembers your project across every session.

bi-sync  = .faf ↔ CLAUDE.md              ← always in sync
tri-sync = .faf ↔ CLAUDE.md ↔ MEMORY.md  ← Nelly never forgets 🐘

Pro feature, free for developers. Teams & Enterprise: faf.one/pro (plans)

The .FAF Position

Model        Context          Protocol
─────        ───────          ────────
Claude    →   .faf        →    MCP
Gemini    →   .faf        →    MCP
Codex     →   .faf        →    MCP
Any LLM   →   .faf        →    MCP

IANA-registered (application/vnd.faf+yaml). Works with any AI. Define once, use everywhere.

Ecosystem

| Package | Platform | Registry | |---------|----------|----------| | claude-faf-mcp (this) | Claude | npm | | faf-cli | Universal CLI | npm + Homebrew | | gemini-faf-mcp | Google Gemini | PyPI | | grok-faf-mcp | xAI Grok | npm | | rust-faf-mcp | Rust | crates.io | | faf-wasm | Browser/Edge | npm | | Chrome Extension | Browser | Chrome Web Store |

Same project.faf. Same scoring. Same result. Different execution layer.

Quality

391 tests · 12 suites · 6 platforms (ubuntu/macos/windows × Node 18/20)

CI Dashboard →

Privacy

Everything runs locally. No data leaves your machine. No analytics, no telemetry, no tracking, no accounts. Privacy policy →

If claude-faf-mcp has been useful, consider starring the repo — it helps others find it.

License

MIT — Free and open source

FAF Family

| | | |---|---| | faf-cli | npx faf-cli init — create .faf for any project | | claude-faf-mcp | MCP server for Claude Desktop | | gemini-faf-mcp | MCP server for Gemini CLI | | grok-faf-mcp | MCP server for Grok | | faf-mcp | MCP server for Cursor, Windsurf, Cline, VS Code | | rust-faf-mcp | MCP server in Rust | | faf-skills | 17 Claude Code skills | | faf.one | Blog, downloads, docs | | IANA Registration | application/vnd.faf+yaml |

format | driven 🏎️⚡️ wolfejam.dev

Get the CLI

faf-cli — The original AI-Context CLI. A must-have for every builder.

npx faf-cli auto

Anthropic MCP #2759 · IANA Registered: application/vnd.faf+yaml · faf.one · npm