Skip to content
Agentmart
Submit a tool

Grok FAF

Persistent project context for xAI Grok.

Connector by faf.one · Domain verified by the MCP Registry

IndexedMITLocal (stdio)★ 19
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/faf-one-grok-faf-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Use cases: prompt-engineering, documentation

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Runs code on install

Its package runs an install script (such as npm postinstall or setup.py code) as soon as you install it, before any tool is called. Read the script first.

Tools
31 read · 24 write · 5 delete · 7 not yet classified
Secrets
None asked for
Install scripts
Runs code on install
Runs as
Node.js package

Tools by what they do 67

Read from the source code; the running server may list different tools.

Read 31 · Look things up without changing anything.

  • faf_about
  • faf_analyze
  • faf_audit
  • faf_chat
  • faf_check
  • faf_credit
  • faf_dna
  • faf_doctor
  • faf_exists
  • faf_faq
  • faf_formats
  • faf_get_orchestration_policy
Show 19 more tools
  • faf_guide
  • faf_index
  • faf_list
  • faf_log
  • faf_read
  • faf_score
  • faf_search
  • faf_show
  • faf_skills
  • faf_stacks
  • faf_status
  • faf_trust
  • faf_trust_validated
  • faf_validate
  • faf_verify
  • faf_version
  • faf_what
  • rag_cache_stats
  • rag_query

Write 24 · Create, change, send or run things.

  • faf_auth
  • faf_auto
  • faf_bi_sync
  • faf_copy
  • faf_debug
  • faf_display
  • faf_edit
  • faf_gate
  • faf_innit
  • faf_install_skill
  • faf_memory
  • faf_migrate
Show 12 more tools
  • faf_mkdir
  • faf_move
  • faf_orchestrate_recommendation
  • faf_quick
  • faf_recover
  • faf_section
  • faf_share
  • faf_sync
  • faf_update
  • refresh_blend
  • refresh_faf
  • refresh_fafm

Delete 5 · Delete, drop, revoke or wipe things.

  • faf_clear
  • faf_delete
  • faf_init
  • faf_write
  • rag_cache_clear

Not yet classified 7 · We could not tell from the name and description.

  • faf
  • faf_choose
  • faf_friday
  • faf_todo
  • faf_trust_confidence
  • faf_trust_garage
  • faf_trust_panic

Network hosts it talks to 9

  • api.x.ai · found in code
  • builder.faf.one · found in code
  • faf.one · found in code
  • github.com · found in code
  • grok.faf.one · found in code
  • iana.org · found in code
  • management-api.x.ai · found in code
  • mcpaas.live · found in code
  • raw.githubusercontent.com · found in code

Files it touches

  • %APPDATA%\\Claude\\claude_desktop_config.json\
  • /dev/tty
  • /home/claude
  • /mnt/user-data
  • /mnt/user-data/uploads
  • /opt/homebrew/bin
  • /opt/homebrew/bin/faf
  • /private/etc
  • /tmp/faf-test
  • /tmp/faf-test-delete.tmp
  • /tmp/faf-test-dir
  • /tmp/faf-test.txt
  • /tmp/test.faf
  • /tmp/test1.tmp
  • /tmp/test2.tmp
  • /tmp/uploads
  • /Users/wolfejam/FAF/grok-faf-mcp/package.json
  • /Users/wolfejam/FAF/grok-faf-mcp/project.faf
  • /usr/local/Cellar/node@20/20.19.4/bin/faf
  • Your home directory (~)
  • ~/Projects/my-app
  • ~/Projects/old-project
  • C:\\Users\\username\\Projects\\my-app\
  • Any path the agent passes to its tools

Tools (67)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • 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

    40ms bi-directional sync - Championship speed!

  • faf_chat

    Natural language .faf generation

  • faf_check

    Quick health check

  • faf_choose

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

  • faf_clearcan change or delete data

    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_delete

    Delete files or directories

Show 52 more tools
  • 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

    Description is built at runtime.

  • faf_get_orchestration_policyread-only

    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_initInitialize project.fafcan change or delete data

    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_listread-only

    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 refresh_fafm/recall.

  • faf_migrate

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

  • faf_mkdir

    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 trail, no silent decisions). Read-only WRT substrate state.

  • faf_quick

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

  • faf_readread-only

    Read any file

  • faf_recover

    🚑 Recover .faf from backups or DNA history

  • faf_scoreread-only

    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 as YAML.

  • 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_trustread-only

    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_update

    🔄 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_writecan change or delete data

    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_statsread-only

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

  • rag_queryread-only

    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 + timestamp stamp. Complements `recall`, `load_soul`, and `etch` — does not replace them.

Signals

Stars
19
Forks
2
Open issues
1
Last commit
Oct 23, 2026 (5 days ago)
Last release
Oct 5, 2026 (23 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
one.faf/grok-faf-mcp
Version
2.1.0
Auth
No auth
Packages
npm grok-faf-mcp
License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

More from faf.one

Cite this page

Grok FAF MCP server. Agent Mart. https://agentmart.dev/connectors/faf-one-grok-faf-mcp (last updated 2026-10-24)