npm package: @iflow-mcp/wolfe-jam-grok-faf-mcp
Description: grok-faf-mcp | FAST⚡️AF • First MCP server for Grok • URL-based AI context • IANA-registered .faf format (application/vnd.faf+yaml)
Author: wolfejam
Latest version: 1.0.4

# grok-faf-mcp | FAST⚡️AF

<div align="center">
  <img src="https://www.faf.one/orange-smiley.svg" alt="FAF" width="80" />

  <h3>Grok asked for MCP on a URL. This is it.</h3>

  <p><strong>First MCP server built for Grok</strong></p>
  <p><code>URL-based • Zero config • Just works</code></p>

  [![CI](https://github.com/Wolfe-Jam/grok-faf-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Wolfe-Jam/grok-faf-mcp/actions/workflows/ci.yml)
  [![NPM Downloads](https://img.shields.io/npm/dt/grok-faf-mcp?label=downloads&color=00CCFF)](https://www.npmjs.com/package/grok-faf-mcp)
  [![npm version](https://img.shields.io/npm/v/grok-faf-mcp?color=00CCFF)](https://www.npmjs.com/package/grok-faf-mcp)
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  [![Vercel](https://img.shields.io/badge/Vercel-Live-black?logo=vercel)](https://grok-faf-mcp.vercel.app)
</div>

---

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

```bash
npm install -g grok-faf-mcp
```

**Add to your MCP config:**

```json
{
  "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](https://mcpaas.live)** — MCP as a Service (The Endpoint for Context)
- **[claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)** — Claude Desktop (52 tools)
- **[faf-cli](https://npmjs.com/package/faf-cli)** — Terminal CLI (18k+ downloads)
- **[faf-mcp](https://npmjs.com/package/faf-mcp)** — Universal MCP
- **[faf.one](https://faf.one)** — Official website

---

## 📄 License

MIT License — Free and open source

---

<div align="center">
  <p><strong>Built for Grok. Built for Speed. Built Right.</strong></p>
  <p>FAST⚡️AF • First to Ship • Zero Friction</p>
</div>

**Zero drift. Eternal sync. AI optimized.** 🏆