{"name":"one.faf/grok-faf-mcp","slug":"faf-grok-faf-mcp","title":"Grok FAF","description":"Persistent project context for xAI Grok. IANA-registered .faf format.","url":"https://mcp.market/server/faf-grok-faf-mcp","rating":null,"grade":"B","score":75,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":46,"stars":19,"forks":2,"downloads_week":1126,"last_push_at":"2026-10-30T09:42:45.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/Wolfe-Jam/grok-faf-mcp","website":"https://grok.faf.one","version":"2.2.2","remotes":[],"packages":[{"registryType":"npm","identifier":"grok-faf-mcp","version":"2.2.2","transport":{"type":"stdio"}}],"tools":[{"name":"faf","description":"Persistent project context for any AI. IANA-registered format.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_about","description":"About FAF - stop FAFfing about!","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_analyze","description":"Multi-model AI intelligence analysis","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_audit","description":"📊 Comprehensive audit of .faf quality and completeness","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_auth","description":"🔐 Authenticate for Birth DNA tracking","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_auto","description":"🏆 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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_bi_sync","description":"Old name, kept callable; use faf_sync. One way: writes CLAUDE.md from project.faf. Never writes project.faf.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_chat","description":"Natural language .faf generation","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_check","description":"Quick health check","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_choose","description":"🏎️ Interactive project chooser - GitHub Desktop style! Choose & FAF!","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_clear","description":"Clear caches and state","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_copy","description":"Copy files or directories","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_credit","description":"Technical Credit vs Technical Debt mindset","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_debug","description":"Debug grok-faf-mcp environment - show working directory, permissions, and FAF CLI status","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_delete","description":"Delete files or directories","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_display","description":"🖼️ Render project.faf → project.html (faf-cli's real scorer + renderer — the same context your AI reads)","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_dna","description":"🧬 Show Birth DNA and evolution tracking","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_doctor","description":"🏥 Comprehensive health check for .faf and environment","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_edit","description":"Interactive editor with validation","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_exists","description":"Check if file or directory exists","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_faq","description":"Interactive help system","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_formats","description":"🐱 TURBO-CAT format discovery (153 validated formats)","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_friday","description":"Friday features — Chrome Extension detection, fuzzy matching","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_gate","description":"Phase 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","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_get_orchestration_policy","description":"Introspect 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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_guide","description":"FAF MCP usage guide for Claude Desktop - Projects convention, path resolution, and UX patterns","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_index","description":"A-Z reference catalog of your project","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_init","description":"Initialize FAF with intelligent project detection - Championship grade","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_innit","description":"🇬🇧 British version of init - same championship, more bruv!","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_install_skill","description":"🏆 Install faf-expert skill to Claude Code - Automatic installation of world-class FAF expertise","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_list","description":"List directory contents","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_log","description":"📜 Show DNA evolution history and changes","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_memory","description":"Phase 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","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_migrate","description":"🔄 Migrate .faf to project.faf (format v2.5.0)","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_mkdir","description":"Create directories","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_move","description":"Move or rename files","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_orchestrate_recommendation","description":"Heavy 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 ","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_quick","description":"⚡ Quick .faf creation - one-liner for instant context. Creates in ~/Projects/ (or ~/projects/ if exists).","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_read","description":"Read any file","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_recover","description":"🚑 Recover .faf from backups or DNA history","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_score","description":"Championship 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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_search","description":"Search filesystem for files by name (TURBO-CAT powered). Solves the \"dropped file path\" problem - find where a file lives.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_section","description":"Phase 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 ","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_share","description":"Secure sharing with auto-sanitization","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_show","description":"🟠 FORCE DISPLAY raw FAF output - Shows EXACTLY what FAF generates!","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_skills","description":"🎸 List Claude Code skills from .faf file - See which skills are configured for this project","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_stacks","description":"STACKTISTICS technology discovery","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_status","description":"Comprehensive project status with Championship Medal System","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_sync","description":"Synchronize .faf with CLAUDE.md","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_todo","description":"Gamified improvement tracking system","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_trust","description":"Trust validation with 4 modes","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_trust_confidence","description":"Trust with confidence mode - steady state","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_trust_garage","description":"Trust garage mode - under the hood","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_trust_panic","description":"Trust panic mode - emergency validation","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_trust_validated","description":"Trust validated mode - championship seal","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_update","description":"🔄 Update .faf file with latest project information","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_validate","description":"Validate .faf file structure and completeness","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_verify","description":"Verify with Claude, ChatGPT, Gemini","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_version","description":"Show FAF version with MK2 engine and TURBO-CAT status","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_what","description":"Quick explanation of .faf format","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_write","description":"Write any file","write_action":true,"price_micros":0,"input_schema":null},{"name":"rag_cache_clear","description":"Clear 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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"rag_cache_stats","description":"Get LAZY-RAG cache statistics - hits, misses, hit rate, cache size","write_action":false,"price_micros":0,"input_schema":null},{"name":"rag_query","description":"Ask a question with RAG-enhanced context from xAI Collections. Uses LAZY-RAG cache for 100,000x speedup on repeated queries.","write_action":false,"price_micros":0,"input_schema":null},{"name":"refresh_blend","description":"Baked-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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"refresh_faf","description":"Re-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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"refresh_fafm","description":"Reload 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","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":75,"grade":"B","scanned_at":"2026-11-02T06:14:12.032Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-11-02T06:14:11.988Z","components":{"code":{"score":15,"max":25,"notes":["171 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":12,"max":15,"notes":["local package, no credentials required"]},"maintenance":{"score":15,"max":15,"notes":["last push 3 days ago"]},"identity":{"score":7,"max":10,"notes":["namespace and repository owner differ","GitHub account older than a year","website matches verified namespace"]}},"findings":[{"id":"install.script","severity":"medium","component":"code","title":"npm install lifecycle script present"},{"id":"install.script","severity":"medium","component":"code","title":"npm install lifecycle script present","evidence":"package.json: … \"prepublishOnly\": \"npm run build\", \"postinstall\": \"node scripts/postinstall.js\", \"deb…"}],"inputs":{"packages":[{"registryType":"npm","identifier":"grok-faf-mcp","version":"2.2.2","found":true,"license":"MIT","hasInstallScripts":true,"dependencyCount":5,"publishedAt":"2026-10-29T06:25:43.312Z","repositoryUrl":"git+https://github.com/Wolfe-Jam/grok-faf-mcp.git","weeklyDownloads":1126}],"repo":{"found":true,"owner":"Wolfe-Jam","repo":"grok-faf-mcp","archived":false,"pushedAt":"2026-10-30T09:42:45Z","stars":19,"forks":2,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/189686721?v=4","ownerCreatedAt":"2024-11-26T02:22:29Z","license":"MIT"},"icon":{"url":"https://raw.githubusercontent.com/Wolfe-Jam/grok-faf-mcp/main/assets/icons/faf-icon-48.png","source":"registry","width":48,"height":48},"presence":{"stars":19,"forks":2,"downloadsWeek":1126,"license":"MIT","lastPushAt":"2026-10-30T09:42:45.000Z","score":46}}}},"grade_history":[],"reviews":[]}