
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
Grok asked for MCP on a URL. This is it.
First MCP server built for Grok
URL-based β’ Zero config β’ Just works
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
- 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
Built for Grok. Built for Speed. Built Right.
FASTβ‘οΈAF β’ First to Ship β’ Zero Friction
Zero drift. Eternal sync. AI optimized. π
grok-faf-mcpnpm install grok-faf-mcp