grok-faf-mcp

Overview

grok-faf-mcp is an MCP server that provides persistent project context for xAI Grok through the FAST⚡️AF (.faf) format. It implements a zero-configuration MCP server that can be deployed via URL, allowing Grok to maintain project context across sessions. The server offers 21 core MCP tools for project initialization, context synchronization, file operations, and RAG-powered context retrieval.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• faf_init

  Create project.faf from your project

  Try:Initialize a new FAF projectTry:Create a project.faf file for my current project
• faf_auto

  Auto-detect stack and populate context

  Try:Auto-detect my project stackTry:Create and populate a project.faf automatically
• faf_score

  AI-readiness score (0-100%) with breakdown

  Try:Score my project's AI readinessTry:Get a breakdown of my project's FAF score
• faf_status

  Check current AI-readability

  Try:Check my project's FAF statusTry:Show the current AI-readability of my project
• faf_enhance

  Intelligent enhancement

  Try:Enhance my project.faf fileTry:Improve the AI-readiness of my project context
• faf_sync

  Sync .faf → CLAUDE.md

  Try:Sync my project.faf to CLAUDE.mdTry:Update my documentation with FAF context
• faf_bi_sync

  Bi-directional .faf ↔ platform context

  Try:Bi-directionally sync my project contextTry:Sync FAF with platform context both ways
• faf_trust

  Validate .faf integrity

  Try:Validate my project.faf fileTry:Check the integrity of my FAF context
• faf_read

  Read any file

  Try:Read the project.faf fileTry:Get the contents of a specific file in my project
• faf_write

  Write any file

  Try:Update the project.faf fileTry:Write new content to a file in my project
• faf_list

  Discover projects with .faf files

  Try:List all projects with FAF filesTry:Find all .faf files in the current directory
• rag_query

  RAG-powered context retrieval

  Try:Query my project context for informationTry:Retrieve specific details from my project documentation

Comparable tools

Installation

https://grok-faf-mcp.vercel.app/sse

vercel github.com/Wolfe-Jam/grok-faf-mcp

npx grok-faf-mcp

{
  "mcpServers": {
    "grok-faf": {
      "command": "npx",
      "args": ["-y", "grok-faf-mcp"]
    }
  }
}

FAQ

What is the .faf format?

The .faf (FAST⚡️AF) format is an IANA-registered YAML format for persistent project context that helps AI agents understand project structure, goals, and technology stack.

How do I create a .faf file for my project?

Use the `faf_auto` command which automatically detects your project structure and creates a project.faf file with context about your stack, goals, and technology choices.

Compare grok-faf-mcp with