Repository avatar
AI Tools
v1.0.0
active

grok-faf-mcp

io.github.Wolfe-Jam/grok-faf-mcp

First MCP server for Grok/xAI. URL-based access. 17 tools for .faf project context.

Documentation

grok-faf-mcp | FAST⚑️AF

FAF

Grok asked for MCP on a URL. This is it.

First MCP server built for Grok

URL-based β€’ Zero config β€’ Just works

NPM Downloads License: MIT Vercel


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:

WhenWithout FAFWith FAF
Day 120 min setupInstant
Month 1AI forgetsAI remembers
Year 1Re-explain everythingContext inherited
Year 3+Knowledge lostDNA 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)

ToolPurpose
faf_initInitialize project.faf
faf_scoreAI-readiness (0-100%)
faf_quickLightning-fast creation (3ms)
faf_enhanceIntelligent enhancement
faf_syncBi-directional sync
faf_readParse and validate
faf_writeCreate/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

EndpointURL
Roothttps://grok-faf-mcp.vercel.app/
SSEhttps://grok-faf-mcp.vercel.app/sse
Healthhttps://grok-faf-mcp.vercel.app/health
Infohttps://grok-faf-mcp.vercel.app/info

πŸ“¦ Ecosystem


πŸ“„ License

MIT License β€” Free and open source


Built for Grok. Built for Speed. Built Right.

FAST⚑️AF β€’ First to Ship β€’ Zero Friction

Zero drift. Eternal sync. AI optimized. πŸ†