Skip to content
MCP server

Grok FAF

Project context for xAI Grok from a .faf file, scored on a fixed 33-slot scale

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
2.2.4
Listing updated
3 days ago

About Grok FAF

Grok FAF is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Grok FAF reads a project's project.faf file, a format the README says is registered with IANA, and gives Grok the stack, the goal and who the project is for. Every project is scored on the same 33 slots, with inapplicable slots marked slotignored, so the number matches what faf-cli reports; 100 percent is called Trophy.

Because context drifts in a long session, refresh_faf re-reads the live files and re-scores mid-session, and refresh_fafm and refresh_blend do the same for memory and both. Other tools include faf_score, faf_sync, faf_write and faf_init, and rag_query, which needs an xAI Collection. The server's own instructions tell Grok to read project.faf first for questions about the project.

It can run hosted at a URL in Grok's config.toml or locally over stdio with npx. Version 2.2.3 notes that faf_write refuses to overwrite .faf-dna and needs overwrite: true for existing project.faf, CLAUDE.md or AGENTS.md. The package is MIT licensed.

Install

Run in a terminal

claude mcp add grok-faf-mcp -- npx -y grok-faf-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "grok-faf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "grok-faf-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "grok-faf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "grok-faf-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "grok-faf-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "grok-faf-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

faf_score
Scores the project's .faf file on the 33-slot scale.
refresh_faf
Re-reads project files and re-scores the .faf.
refresh_fafm
Re-reads memory files.
refresh_blend
Refreshes both context and memory.
faf_sync
Writes the context files it names without reclaiming hand-written ones.
faf_write
Writes files inside the project folder with overwrite guards.
faf_init
Creates project context, detecting skills repos.
rag_query
Queries an xAI Collection.

What it does

33-slot scoring
Scores every project on the same slots for a comparable result.
Mid-session refresh
Re-reads and re-scores context to re-ground Grok.
Guarded writes
Existing context files need overwrite: true before being replaced.
Hosted or local
Runs from a URL in Grok's config or via npx over stdio.
Skills repo detection
faf_init recognises skills repos and Claude Code plugin manifests.

Good for

  • Keep Grok grounded in a project's stack and goal
  • Score how complete a project's context file is
  • Sync context into AGENTS.md or CLAUDE.md
  • Re-ground Grok after a long session drifts

Pricing

Open source

MIT licensed; hosted option on mcpaas.live

Prices change. Check grok.faf.one before you buy.

Grok FAF FAQ

How do I add it to Grok?

Add the hosted URL under [mcp_servers.grok-faf-mcp] in ~/.grok/config.toml and restart Grok.

What does the score mean?

Every app is scored on the same 33 slots; 100 percent is the Trophy tier.

Is it open source?

The README shows an MIT licence badge.

Does it overwrite my files?

No. faf_write needs overwrite: true for existing project.faf, CLAUDE.md and AGENTS.md.

Is Grok FAF free?

Yes. Grok FAF is open source, so you can use and self-host it for free.

How do I add Grok FAF to Claude Code?

Run this command in your terminal: claude mcp add grok-faf-mcp -- npx -y grok-faf-mcp

What are the best alternatives to Grok FAF?

The closest alternatives to Grok FAF are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Grok FAF

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools