🏎️ CLAUDE.md - faf-mcp Persistent Context & Intelligence

PROJECT STATE: GOOD 🚀

Current Position: USE>FAF™ - IANA-registered format (application/vnd.faf+yaml) • Universal AI context • MCP server for all platforms • Start with 'Use FAF' Tyre Compound: ULTRASOFT C5 (Maximum Performance)

🎨 CORE CONTEXT

Project Identity

• Name: faf-mcp
• Stack: CLI/TypeScript/TypeScript (tsc)/npm registry/Node.js
• Quality: F1-INSPIRED (Championship Performance)

Technical Architecture

• What Building: USE>FAF™ - IANA-registered format (application/vnd.faf+yaml) • Universal AI context • MCP server for all platforms • Start with 'Use FAF'
• Main Language: TypeScript

📊 Context Quality Status

• Overall Assessment: Good
• Last Updated: 2026-03-07

STATUS: BI-SYNC ACTIVE 🔗 - Synchronized with .faf context!

Last Sync: 2026-03-07T17:33:41.765Z Sync Engine: F1-Inspired Software Engineering 🏎️⚡️_championship_sync

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"]}}}

Three Ways to Deploy

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

# 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:

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
• --all flag 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

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

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