# Persistent Project Context for xAI Grok MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-wolfe-jam-grok-faf-mcp
- Repository: https://github.com/Wolfe-Jam/grok-faf-mcp
- Website: https://grok.faf.one

## Install
- Command: `npx -y grok-faf-mcp`
- Endpoint: https://mcpaas.live/grok/mcp/v1
- Auth: Not captured

## Setup notes
- Package: Npm grok-faf-mcp v1.5.1
- Remote endpoint: https://mcpaas.live/grok/mcp/v1

## Tools
- get_soul (Get Context Soul) - Fetch a context soul by name. Returns structured AI context. Endpoint: https://mcpaas.live/grok/mcp/v1
- list_souls (List Available Souls) - List all available context souls. Endpoint: https://mcpaas.live/grok/mcp/v1
- delta_check (Delta Doctrine Check) - Determine if a topic needs FULL, DELTA, or X-DELTA soul. Endpoint: https://mcpaas.live/grok/mcp/v1
- list_tags (List Tags) - List all unique tags used in a soul, with counts. Endpoint: https://mcpaas.live/grok/mcp/v1
- search_by_tag (Search by Tag) - Find all entries in a soul with a specific tag. Endpoint: https://mcpaas.live/grok/mcp/v1
- search_context (Search Context) - Full-text search across souls. Returns matching lines only (token-efficient). Endpoint: https://mcpaas.live/grok/mcp/v1
- tag_intel (Tag Intel) - Discover tag patterns, co-occurrence, candidates, and merge suggestions across all namepoints. Optionally suggest tags for a specific handle. Endpoint: https://mcpaas.live/grok/mcp/v1
- generate_faf_from_github (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. Endpoint: https://mcpaas.live/grok/mcp/v1
- faf_score (Score .faf content) - Score .faf YAML content via the Mk4 Zig-WASM engine. Returns 0-100 (capped). Same engine as xai-faf-rust + xai-faf-zig (parity-tested). Sub-ms at the edge. Endpoint: https://mcpaas.live/grok/mcp/v1
- faf_validate (Validate .faf content) - Validate .faf YAML content via the Mk4 Zig-WASM engine. Returns true if mission-ready (>= 100). Endpoint: https://mcpaas.live/grok/mcp/v1
- faf_get_tier (Get tier for a score) - Resolve the FAF tier for a given numeric score. Returns the tier symbol (Trophy/Gold/Silver/Bronze/etc.) per the canonical tier-table. Endpoint: https://mcpaas.live/grok/mcp/v1
- faf_estimate_tokens (Estimate tokens) - Estimate token count for arbitrary content via the Zig WASM engine. Sub-millisecond, zero allocations. Useful for context-budget planning. Endpoint: https://mcpaas.live/grok/mcp/v1
- faf_analyze (Full analysis (score + tier + validate)) - One-call composite — returns score, tier-ready, valid, and engine identifier. Two WASM calls, sub-millisecond total. Endpoint: https://mcpaas.live/grok/mcp/v1
- refresh_faf (Re-ground on .faf content (drift → refresh → re-grounded)) - Re-ground on .faf content — re-score via the Mk4 Zig-WASM Enterprise scorer (33-slot, honors the authored app-type shape), 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. Endpoint: https://mcpaas.live/grok/mcp/v1
- faf_orchestrate_recommendation (Orchestrate Context Recommendation (FAF)) - 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 `effective_policy` and `partial[]` for any stateful signals unavailable on the current surface. Light-lane execution (hosted) is WASM-pure with no filesystem access. Heavy-lane execution (local via bunx/rust-faf-mcp) has full FS + persisted state. Advisory only — never auto-fires. Endpoint: https://mcpaas.live/grok/mcp/v1
- faf_gate (FRC quality gate (promote/hold)) - 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-hint can't list empty slots at the edge. Endpoint: https://mcpaas.live/grok/mcp/v1
- faf_section (Structure-aware retrieval) - 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. Endpoint: https://mcpaas.live/grok/mcp/v1
- faf_memory (Portable structured memory (.fafm)) - 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. Endpoint: https://mcpaas.live/grok/mcp/v1
- faf_collections_search (Search a Grok Collection (edge, KV-cached)) - 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). Endpoint: https://mcpaas.live/grok/mcp/v1

## Resources
- soul://grok - Demo soul for Grok MIME type: application/vnd.faf+yaml
- soul://claude - Demo soul for Claude (Anthropic) MIME type: application/vnd.faf+yaml
- soul://gemini - Demo soul for Gemini (Google) MIME type: application/vnd.faf+yaml
- soul://spacex - SpaceX DELTA - live launch data MIME type: application/vnd.faf+yaml
- soul://wolfe - Wolfe James X-DELTA persona MIME type: application/vnd.faf+yaml
- soul://liverpool - Liverpool DELTA - current season MIME type: application/vnd.faf+yaml
- soul://smithsonian - Smithsonian artifact metadata MIME type: application/vnd.faf+yaml
- soul://registry - FAF IANA registration proof MIME type: application/json

## Prompts
Not captured

## Metadata
- Owner: io.github.Wolfe-Jam
- Version: 1.5.1
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 31, 2026
- Source: https://registry.modelcontextprotocol.io