Claude Code FAF — Claude Code MCP server: project context over a URL
Keeps your project description in a .faf file and lets the agent score, check and analyse it. Installs with one npx line.
claude mcp add grok-faf-mcp -- npx -y grok-faf-mcpWhat Grok FAF does
The server stores project context in project.faf and exposes tools such as faf_score, faf_validate, faf_get_tier, faf_estimate_tokens and faf_analyze. Since v2.1 each tool carries an annotation saying whether it only reads, writes, or can overwrite — handy when your client decides what to confirm first.
Run it locally with npx over stdio, so any MCP client that supports stdio can use it. A hosted endpoint also exists at https://mcpaas.live/grok/mcp/v1. Only rag_query touches the network, through Anthropic Collections.
Node 22 or later is required. Several tools (refresh_faf, refresh_fafm, refresh_blend, faf_gate, faf_section, faf_memory) drop small receipt files into your project folder, so untracked files will show up — keep that in mind when the directory is under version control.
What it helps with
- keep one project description file the agent can read
- validate the
.faffile before committing - estimate how many tokens the project context costs
- see whether the project description is complete enough
- wipe stale context with a single tool call
Example prompts for the agent
- Score
project.fafand tell me what's missing. - Validate the
.faffile and list the problems. - How many tokens will this context file use?
How to install Grok FAF
Platform CLI
claude mcp add grok-faf-mcp -- npx -y grok-faf-mcpPlatform CLI
codex mcp add grok-faf -- npx -y grok-faf-mcpConfig file
{
"mcpServers": {
"grok-faf": {
"command": "npx",
"args": [
"-y",
"grok-faf-mcp"
]
}
}
}Config file
{
"servers": {
"grok-faf": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"grok-faf-mcp"
]
}
}
}Platform CLI
gemini mcp add grok-faf npx -y grok-faf-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Grok FAF
How do I install Claude FAF in Claude Code?
Run claude mcp add grok-faf-mcp -- npx -y grok-faf-mcp, then restart the client. The alias grok-faf works too.
What does Claude FAF do?
It gives the agent persistent project context stored in the .faf format: scoring, validation, token estimates and analysis. The format is registered with IANA as vnd.faf+yaml.
What do I need to run it?
Node 22 or newer. Network access is only needed by rag_query; the other tools run locally.
