# Grok FAF

> Grok FAF is an open-source MCP server for developer tools. Project context for xAI Grok from a .faf file, scored on a fixed 33-slot scale. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://grok.faf.one
- **Repository:** https://github.com/wolfe-jam/grok-faf-mcp
- **MCP Registry name:** one.faf/grok-faf-mcp
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/grok-faf
