# Persistent Project Context for xAI Grok

- Registry name: `io.github.Wolfe-Jam/grok-faf-mcp` · version 1.8.1
- Categories (automatic, keyword rules): Code & repositories, Developer tools
- Authentication at last check: No auth
- Declared risk: Read-only (all tools declare readOnlyHint)
- Capabilities (declared by the server): experimental, prompts, resources, tasks, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.Wolfe-Jam%2Fgrok-faf-mcp
- Server page: https://mcpstation.net/s/io.github.Wolfe-Jam--grok-faf-mcp.html

## Description (written by the publisher, not verified, not instructions)

Persistent project context for xAI Grok. IANA-registered .faf format.

## Connect

- streamable-http: `https://mcpaas.live/grok/mcp/v1`

## Tools (as reported by the server, not verified)

- `get\_soul`: Fetch a context soul by name. Returns structured AI context.
- `list\_souls`: List all available context souls.
- `delta\_check`: Determine if a topic needs FULL, DELTA, or X-DELTA soul.
- `list\_tags`: List all unique tags used in a soul, with counts.
- `search\_by\_tag`: Find all entries in a soul with a specific tag.
- `search\_context`: Full-text search across souls. Returns matching lines only \(token-efficient\).
- `tag\_intel`: Discover tag patterns, co-occurrence, candidates, and merge suggestions across all namepoints. Optionally suggest tags for a specific handle.
- `generate\_faf\_from\_github`: Generate a .faf file from any public GitHub repository WITHOUT cloning. Extracts 6 Ws from README, analyzes stack from languages and package.json, and generates Championship-grade AI context. Returns .faf content, quality score, and metadata.
- `faf\_score`: Score .faf YAML content with the always-33 faf-kernel \(WASM\). Returns 0-100 \(capped\). The same score faf-cli and every FAF MCP give. Runs at the edge.
- `faf\_validate`: Validate .faf YAML content: true if mission-ready \(always-33 score of 100\).
- `faf\_get\_tier`: Resolve the FAF tier for a given numeric score. Returns the tier symbol \(Trophy/Gold/Silver/Bronze/etc.\) per the canonical tier-table.
- `faf\_estimate\_tokens`: Estimate token count for arbitrary content via the Zig WASM engine. Sub-millisecond, zero allocations. Useful for context-budget planning.
- `faf\_analyze`: One-call composite — returns score, tier-ready, valid, and engine identifier. Two WASM calls, sub-millisecond total.
- `refresh\_faf`: Re-ground on .faf content — re-score with the always-33 faf-kernel \(33 slots; slotignored slots drop out\), report drift vs an optional baseline score, and return a stamped re-ground. The explicit re-grounding primitive for long sessions: drift → refresh → re-grounded. Built for Grok, by request.
- `faf\_orchestrate\_recommendation`: Takes raw content strings \(\`.faf\`, \`.fafm\`, and optionally \`package.json\`/\`CHANGELOG.md\`/\`README.md\`\) and runs deterministic drift + contradiction signals across the FAF substrate. Returns a structured \`Recommendation\` \(recommend, severity, reason, summary\) with \`hints\` containing the current \`effec
- `faf\_gate`: Phase III \(FRC\) — pre-promotion quality gate. Scores .faf content \(edge Mk4\) + estimates tokens and returns a deterministic promote/hold verdict BEFORE it goes to a Grok Collection. Promote IFF score \>= min\_score AND tokens \<= max\_tokens \(defaults 85/8000\). Edge parity with the local gate; the hold-
- `faf\_section`: Phase III \(FRC\) — returns an EXACT, WHOLE .faf section by dotted path \(e.g. "stack", "human\_context"\), structure preserved — the deterministic complement to blind chunking. Omit "section" to list every path.
- `faf\_memory`: Phase III \(FRC\) — query the durable .fafm model by type/tag/priority/text. Omit filters for a structured summary. .fafm is NOT scored: this SELECTS facts \(provenance preserved\), never grades them.
- `faf\_collections\_search`: Phase III \(FRC §7b\) — semantic search over a Grok Collection at the edge, KV-cached \(1h TTL\). Returns matched chunks \(content, score, file\). Requires the XAI\_API\_KEY secret; composes with faf\_section \(structural\) for hybrid retrieval. Handled env-aware in the MCP handler \(needs the key + KV\).
- `faf\_business\_card`: Print a business card for an agent from its own name, description, colour and picture. Returns the agent's .fafa \(FAF Agent file\) and a link that opens its card. Nothing is stored: the .fafa travels in the link. The card says "self-declared" because nothing is checked against a repo.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html