grok-faf-mcp | FAST⚡️AF

📋 The 6 Ws - Quick Reference

Every README should answer these questions. Here's ours:

| Question | Answer | |----------|--------| | 👥 WHO is this for? | Grok/xAI developers and teams building with URL-based MCP | | 📦 WHAT is it? | First MCP server built for Grok - URL-based AI context via IANA-registered .faf format | | 🌍 WHERE does it work? | Vercel (production) • Local dev • Any MCP client supporting HTTP-SSE | | 🎯 WHY do you need it? | Zero-config MCP on a URL - Grok asked for it, we built it first | | ⏰ WHEN should you use it? | Grok integration testing, xAI projects, URL-based MCP deployments | | 🚀 HOW does it work? | Point to https://grok-faf-mcp.vercel.app/sse - 17 tools instantly available |

For AI: Read the detailed sections below for full context. For humans: Use this pattern in YOUR README. Answer these 6 questions clearly.

For xAI Integration

.faf provides persistent project context for AI systems.

Benefits:

• Real context reduces hallucinations
• 19ms average execution
• IANA-registered format (application/vnd.faf+yaml)
• MIT licensed, no vendor lock-in

Ready for integration testing.

🏆 Gold Code

At 100% FAF score, AI is optimized — not just informed.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏆  GOLD CODE = AI OPTIMIZED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

At 55%  → AI flipping coins
At 100% → AI optimized, zero drift

├─ Project DNA locked in
├─ Context never goes stale
├─ Every session starts smart
└─ AI works WITH you, not around you
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Lifecycle value:

| When | Without FAF | With FAF | |------|-------------|----------| | Day 1 | 20 min setup | Instant | | Month 1 | AI forgets | AI remembers | | Year 1 | Re-explain everything | Context inherited | | Year 3+ | Knowledge lost | DNA preserved |

⚡ What You Get

URL:     https://grok-faf-mcp.vercel.app/
Format:  IANA-registered .faf
Tools:   17 MCP tools + 14 bundled commands
Speed:   19ms average execution
Status:  FAST⚡️AF

MCP over HTTP-SSE. Point your Grok integration at the URL. That's it.

🚀 Quick Start

Option 1: URL-Based (Vercel)

https://grok-faf-mcp.vercel.app/sse

Point your MCP client to this endpoint. All tools available instantly.

Option 2: Local Install

npm install -g grok-faf-mcp

Add to your MCP config:

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

🎯 Use Cases

Use FAF to initialize my project
Use FAF to score my AI-readiness
Use FAF to sync project context

Start every prompt with "Use FAF" — stops web search, forces tool usage.

🛠️ MCP Tools (17)

| Tool | Purpose | |------|---------| | faf_init | Initialize project.faf | | faf_score | AI-readiness (0-100%) | | faf_quick | Lightning-fast creation (3ms) | | faf_enhance | Intelligent enhancement | | faf_sync | Bi-directional sync | | faf_read | Parse and validate | | faf_write | Create/update with validation |

Plus 14 bundled commands — 16.2x faster than CLI subprocess.

📊 Performance

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ FAST AF METRICS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Execution:    19ms average
Fastest:      1ms (formats)
Speedup:      16.2x vs CLI
Memory:       Zero leaks
Transport:    HTTP-SSE (Vercel Edge)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔗 Endpoints

| Endpoint | URL | |----------|-----| | Root | https://grok-faf-mcp.vercel.app/ | | SSE | https://grok-faf-mcp.vercel.app/sse | | Health | https://grok-faf-mcp.vercel.app/health | | Info | https://grok-faf-mcp.vercel.app/info |

📦 Ecosystem

• MCPaaS — MCP as a Service (The Endpoint for Context)
• claude-faf-mcp — Claude Desktop (52 tools)
• faf-cli — Terminal CLI (18k+ downloads)
• faf-mcp — Universal MCP
• faf.one — Official website

📄 License

MIT License — Free and open source

Zero drift. Eternal sync. AI optimized. 🏆