MCP.Market

Grok FAF MCP server

by faf.one·one.faf/grok-faf-mcp·v2.2.2·19 stars

Persistent project context for xAI Grok. IANA-registered .faf format.

B75/100grade B
What users say
No reviews yet
Be the first
Safety scan
B75/100

full report

Adoption
Established

19 stars1.1k downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • faf

    Persistent project context for any AI. IANA-registered format.

  • faf_about

    About FAF - stop FAFfing about!

  • faf_analyze

    Multi-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_sync

    Old name, kept callable; use faf_sync. One way: writes CLAUDE.md from project.faf. Never writes project.faf.

  • faf_chat

    Natural language .faf generation

  • faf_check

    Quick health check

  • faf_choose

    🏎️ Interactive project chooser - GitHub Desktop style! Choose & FAF!

  • faf_clear

    Clear caches and state

  • faf_copy

    Copy files or directories

  • faf_credit

    Technical Credit vs Technical Debt mindset

  • faf_debug

    Debug grok-faf-mcp environment - show working directory, permissions, and FAF CLI status

  • faf_deletewrite action

    Delete 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_edit

    Interactive editor with validation

  • faf_exists

    Check if file or directory exists

  • faf_faq

    Interactive help system

  • faf_formats

    🐱 TURBO-CAT format discovery (153 validated formats)

  • faf_friday

    Friday features — Chrome Extension detection, fuzzy matching

  • faf_gate

    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

  • faf_get_orchestration_policy

    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.

  • faf_guide

    FAF MCP usage guide for Claude Desktop - Projects convention, path resolution, and UX patterns

  • faf_index

    A-Z reference catalog of your project

  • faf_init

    Initialize 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_list

    List directory contents

  • faf_log

    📜 Show DNA evolution history and changes

  • faf_memory

    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

  • faf_migrate

    🔄 Migrate .faf to project.faf (format v2.5.0)

  • faf_mkdirwrite action

    Create directories

  • faf_move

    Move or rename files

  • faf_orchestrate_recommendation

    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

  • faf_quick

    ⚡ Quick .faf creation - one-liner for instant context. Creates in ~/Projects/ (or ~/projects/ if exists).

  • faf_read

    Read any file

  • faf_recover

    🚑 Recover .faf from backups or DNA history

  • faf_score

    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.

  • faf_search

    Search filesystem for files by name (TURBO-CAT powered). Solves the "dropped file path" problem - find where a file lives.

  • faf_section

    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

  • faf_share

    Secure 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_stacks

    STACKTISTICS technology discovery

  • faf_status

    Comprehensive project status with Championship Medal System

  • faf_sync

    Synchronize .faf with CLAUDE.md

  • faf_todo

    Gamified improvement tracking system

  • faf_trust

    Trust validation with 4 modes

  • faf_trust_confidence

    Trust with confidence mode - steady state

  • faf_trust_garage

    Trust garage mode - under the hood

  • faf_trust_panic

    Trust panic mode - emergency validation

  • faf_trust_validated

    Trust validated mode - championship seal

  • faf_updatewrite action

    🔄 Update .faf file with latest project information

  • faf_validate

    Validate .faf file structure and completeness

  • faf_verify

    Verify with Claude, ChatGPT, Gemini

  • faf_version

    Show FAF version with MK2 engine and TURBO-CAT status

  • faf_what

    Quick explanation of .faf format

  • faf_writewrite action

    Write any file

  • rag_cache_clear

    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.

  • rag_cache_stats

    Get LAZY-RAG cache statistics - hits, misses, hit rate, cache size

  • rag_query

    Ask a question with RAG-enhanced context from xAI Collections. Uses LAZY-RAG cache for 100,000x speedup on repeated queries.

  • refresh_blend

    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.

  • refresh_faf

    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.

  • refresh_fafm

    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

Public scan report

scanner v0.1.10 · 2026-11-02 · same rubric, same numbers if you re-run it

2 medium
  • 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 presentinstall.script
  • mediumnpm install lifecycle script presentinstall.script
    package.json: … "prepublishOnly": "npm run build", "postinstall": "node scripts/postinstall.js", "deb…
Overall 75/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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-mcp

Hosted 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/info

Returns 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.

More from faf.one →