Grok FAF
Project context for xAI Grok from a .faf file, scored on a fixed 33-slot scale
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"grok-faf-mcp": {
"command": "npx",
"args": [
"-y",
"grok-faf-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"grok-faf-mcp": {
"command": "npx",
"args": [
"-y",
"grok-faf-mcp"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools