Grok FAF MCP server
Persistent project context for xAI Grok. IANA-registered .faf format.
19 stars1.1k downloads/wk
Reviews
Write oneNobody has reviewed Grok FAF yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Grok FAF tools (67, 4 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
fafPersistent project context for any AI. IANA-registered format.
faf_aboutAbout FAF - stop FAFfing about!
faf_analyzeMulti-model AI intelligence analysis
faf_audit📊 Comprehensive audit of .faf quality and completeness
faf_auth🔐 Authenticate for Birth DNA tracking
faf_auto🏆 ONE COMMAND CHAMPIONSHIP - IMPORTANT: Users work on LOCAL projects. Ask for LOCAL filesystem path (e.g., /Users/username/projects/myapp). DO NOT use containers. Auto-scan, populate, score, sync using real FAF file tools.
faf_bi_syncOld name, kept callable; use faf_sync. One way: writes CLAUDE.md from project.faf. Never writes project.faf.
faf_chatNatural language .faf generation
faf_checkQuick health check
faf_choose🏎️ Interactive project chooser - GitHub Desktop style! Choose & FAF!
faf_clearClear caches and state
faf_copyCopy files or directories
faf_creditTechnical Credit vs Technical Debt mindset
faf_debugDebug grok-faf-mcp environment - show working directory, permissions, and FAF CLI status
faf_deletewrite actionDelete files or directories
faf_display🖼️ Render project.faf → project.html (faf-cli's real scorer + renderer — the same context your AI reads)
faf_dna🧬 Show Birth DNA and evolution tracking
faf_doctor🏥 Comprehensive health check for .faf and environment
faf_editInteractive editor with validation
faf_existsCheck if file or directory exists
faf_faqInteractive help system
faf_formats🐱 TURBO-CAT format discovery (153 validated formats)
faf_fridayFriday features — Chrome Extension detection, fuzzy matching
faf_gatePhase III — the pre-promotion quality gate. Scores + sizes a .faf candidate and returns a deterministic promote/hold verdict BEFORE it goes to a Grok Collection — "better candidates for Collections, not better search." Built from faf_score + a token estimate; makes no Collections call. Promote IFF faf_score >= min_score AND tokens <= max_tokens (defaults …/…); on hold it returns the actionable gap
faf_get_orchestration_policyIntrospect the effective orchestration policy WITHOUT running the orchestrator. Returns `{ tier, thresholds, source, overrides_applied }` — what aggressiveness tier the next `faf_orchestrate_recommendation` call would use, and whether it came from defaults or a `.faf:orchestration:` override. No drift detection, no signals, no receipt — pure introspection. Read-only.
faf_guideFAF MCP usage guide for Claude Desktop - Projects convention, path resolution, and UX patterns
faf_indexA-Z reference catalog of your project
faf_initInitialize FAF with intelligent project detection - Championship grade
faf_innit🇬🇧 British version of init - same championship, more bruv!
faf_install_skill🏆 Install faf-expert skill to Claude Code - Automatic installation of world-class FAF expertise
faf_listList directory contents
faf_log📜 Show DNA evolution history and changes
faf_memoryPhase III — structured portable memory. Query the durable .fafm model (decisions/invariants/conventions/WHY) by type/tag/priority/text instead of scrolling a flat GROK.md. Omit all filters for a structured summary (counts by type/priority + tag vocabulary + index). NOTE: .fafm is NOT scored — this SELECTS and returns facts (provenance preserved), it never grades them. Read-only; complements refres
faf_migrate🔄 Migrate .faf to project.faf (format v2.5.0)
faf_mkdirwrite actionCreate directories
faf_moveMove or rename files
faf_orchestrate_recommendationHeavy orchestrator — given current substrate state, returns a structured recommendation about drift: which refresh to call (or `no_action`), why, how severe, and the underlying signals. ADVISORY ONLY — never auto-fires. Composes the full 1.5 substrate (drift detection · contradiction check · repeat-offender · take-a-hint · refresh history). Writes a recommendation receipt on every call (auditable
faf_quick⚡ Quick .faf creation - one-liner for instant context. Creates in ~/Projects/ (or ~/projects/ if exists).
faf_readRead any file
faf_recover🚑 Recover .faf from backups or DNA history
faf_scoreChampionship scorecard with actionable insights. CRITICAL: Content between [DISPLAY:REQUIRED] tags MUST be displayed directly to user as formatted markdown. Do NOT summarize. Includes Quick Actions for immediate next steps.
faf_searchSearch filesystem for files by name (TURBO-CAT powered). Solves the "dropped file path" problem - find where a file lives.
faf_sectionPhase III — structure-aware retrieval. Returns an EXACT, WHOLE .faf section by dotted path (e.g. "stack", "stack.backend", "human_context"), structure and relationships preserved — the deterministic complement to Collections' blind ~1024-token chunking (which flattens a .faf). Omit "section" to list every available path. No LLM, no Collections call: parse → resolve path → return the whole subtree
faf_shareSecure sharing with auto-sanitization
faf_show🟠 FORCE DISPLAY raw FAF output - Shows EXACTLY what FAF generates!
faf_skills🎸 List Claude Code skills from .faf file - See which skills are configured for this project
faf_stacksSTACKTISTICS technology discovery
faf_statusComprehensive project status with Championship Medal System
faf_syncSynchronize .faf with CLAUDE.md
faf_todoGamified improvement tracking system
faf_trustTrust validation with 4 modes
faf_trust_confidenceTrust with confidence mode - steady state
faf_trust_garageTrust garage mode - under the hood
faf_trust_panicTrust panic mode - emergency validation
faf_trust_validatedTrust validated mode - championship seal
faf_updatewrite action🔄 Update .faf file with latest project information
faf_validateValidate .faf file structure and completeness
faf_verifyVerify with Claude, ChatGPT, Gemini
faf_versionShow FAF version with MK2 engine and TURBO-CAT status
faf_whatQuick explanation of .faf format
faf_writewrite actionWrite any file
rag_cache_clearClear the LAZY-RAG cache — drop all cached retrievals so the next rag_query rebuilds from source. Use when the underlying context has changed and you want fresh results instead of cached ones.
rag_cache_statsGet LAZY-RAG cache statistics - hits, misses, hit rate, cache size
rag_queryAsk a question with RAG-enhanced context from xAI Collections. Uses LAZY-RAG cache for 100,000x speedup on repeated queries.
refresh_blendBaked-in two-intensity refresh (Cmd+R / Cmd+Shift+R analog). Fires BOTH `refresh_faf` + `refresh_fafm` in one call. `mode: "blend"` (default) = light `.faf` + delta `.fafm` — the everyday re-ground. `mode: "nuke"` = light `.faf` + verbatim `.fafm` — the hard reload for polluted session memory. Intensity matches drift rate per layer.
refresh_fafRe-ground on the live .faf — re-read + re-score the current project DNA, report drift vs your last-known score, and return the fresh context. The explicit re-grounding primitive for long sessions: drift → refresh → re-grounded. Built for Grok, by request.
refresh_fafmReload the latest structured memory (`.fafm`) for one or more souls into the current session. Returns a stamped delta by default (added/updated facts since last refresh or a given timestamp). Use `verbatim: true` to receive the full current `.fafm` content instead. Reads your files and writes a refresh receipt (.fafm-refresh-receipts.json) to the project folder. Always returns a content hash + tim
Public scan report
scanner v0.1.10 · 2026-11-02 · same rubric, same numbers if you re-run it
- Code scan171 source files scanned15/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 3 days ago15/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace7/10
Findings (2)
- mediumnpm install lifecycle script present
install.script - mediumnpm install lifecycle script present
install.scriptpackage.json: … "prepublishOnly": "npm run build", "postinstall": "node scripts/postinstall.js", "deb…
How Grok FAF compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 75/100
- higher than 45% of 48,255 servers
- Tools
- 67
- the typical server has 7
- Tools that change things
- 6%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 19
- more than 91% of 28,688 servers
- Downloads a week
- 1,126
- more than 95% of 12,191 servers with a package
What its tools let an agent do: 63 read · 4 change
Release history: 6 versions in the registry since 2026-08-20, latest 2026-10-29, typically one every 8 days.
Install Grok FAF in Claude Code, Cursor or VS Code
Runs npx -y grok-faf-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add grok-faf-mcp -- npx -y grok-faf-mcp
What the publisher says
From the Grok FAF repository's README, as published. We do not edit it. Read it on GitHub
<!-- faf: grok-faf-mcp | TypeScript | mcp-server | First MCP server for Grok — URL-based AI context, FAST⚡️AF --> <!-- faf: doc=readme | canonical=project.faf | score=100 | family=FAF -->
grok-faf-mcp — FAST⚡️AF Edition
Grok asked for MCP on a URL. This is it.
Persistent Project Context for xAI Grok. URL-based • Zero config • Just works
Home: faf.one/grok Live demo: grok.faf.one
FAF defines. MD instructs. AI codes.
v1.10.0 — The No-Fluff Edition
No fluff in a project.faf. faf_enhance is gone. RAG default is grok-4.6.
A .faf is facts. Two writers only: the repo (fafauto) and the human (fafgo). Empty is honest. There is no enhance.
⭐ Bookmarks it for you, helps other devs find it too.
First v0.2-conformant reader of the FAF Context Ingestion Contract — the open standard co-authored in public with @grok.
Install — one line
Add to ~/.grok/config.toml:
[mcp_servers.grok-faf-mcp]
url = "https://mcpaas.live/grok/mcp/v1"Restart Grok TUI (or /mcps r) to refresh. Tools: fafscore, fafvalidate, fafgettier, fafestimatetokens, faf_analyze (plus soul/memory ops).
Smithery: wolfe-jam/grok-faf-mcp — gateway at https://grok-faf-mcp--wolfe-jam.run.tools
Homebrew (local stdio):
brew install wolfe-jam/faf/grok-faf-mcpHosted on Cloudflare Workers — sub-ms cold start, no subprocess, edge-served. 4865-byte Zig WASM engine, parity-tested vs the Rust authority (xai-faf-rust). Externally validated by Grok S1 + S2 on 2026-05-27.
Verify the live contract:
curl https://mcpaas.live/grok/mcp/v1/infoReturns endpoint, protocol versions, engine details, tool list, and the architecture line: .faf=vROM | AI-in-session=RAM.
Sample corpus: xai-faf-proof/pilot — 10 records ready to score.
The 6 Ws - Quick Reference
Every README should answer these questions. Here's ours:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Grok FAF: common questions
- Is Grok FAF MCP server safe?
- Mostly: it is graded B (75/100). Read the Grok FAF safety report
- How do I install Grok FAF?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Grok FAF need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Grok FAF maintained?
- The last commit was 5 days ago (2026-10-30). The latest release is v2.2.2.
- How does Grok FAF compare with other MCP servers?
- safety score 75/100 (higher than 45% of 48,255 servers); tools 67 (the typical server has 7); tools that change things 6% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.