All servers · Code & repositories

Persistent Project Context for xAI Grok

io.github.Wolfe-Jam/grok-faf-mcp · v1.8.1

Measured by MCP Station

Description written by the publisher, not verified

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

Connect

claude mcp add --transport http grok-faf-mcp https://mcpaas.live/grok/mcp/v1

{
  "mcpServers": {
    "grok-faf-mcp": {
      "url": "https://mcpaas.live/grok/mcp/v1"
    }
  }
}

Tools as reported by the server

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

Tool changes

• 2026-10-17: get_soul, list_souls, delta_check, list_tags, search_by_tag, search_context, tag_intel, generate_faf_from_github, faf_score, faf_validate, faf_get_tier, faf_estimate_tokens
• 2026-10-16: get_soul, list_souls, delta_check, list_tags, search_by_tag, search_context, tag_intel, generate_faf_from_github, faf_score, faf_validate, faf_get_tier, faf_estimate_tokens

Repository · Website · JSON · Text for agents · Registry updated 2026-06-29