io.github.Wolfe-Jam/claude-faf-mcp

Tools

• delta_check

  Determine if a topic needs FULL, DELTA, or X-DELTA soul.

  shallow
• faf_analyze

  One-call composite — returns score, tier-ready, valid, and engine identifier. Two WASM calls, sub-millisecond total.

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

  shallow
• faf_estimate_tokens

  Estimate token count for arbitrary content via the Zig WASM engine. Sub-millisecond, zero allocations. Useful for context-budget planning.

  shallow
• 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-hint can't list empty slots at the edge.

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

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

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

  shallow
• faf_score

  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.

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

  shallow
• faf_validate

  Validate .faf YAML content via the Mk4 Zig-WASM engine. Returns true if mission-ready (>= 100).

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

  shallow
• get_soul

  Fetch a context soul by name. Returns structured AI context.

  shallow
• list_souls

  List all available context souls.

  shallow
• list_tags

  List all unique tags used in a soul, with counts.

  shallow
• refresh_faf

  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.

  shallow
• search_by_tag

  Find all entries in a soul with a specific tag.

  shallow
• search_context

  Full-text search across souls. Returns matching lines only (token-efficient).

  shallow
• tag_intel

  Discover tag patterns, co-occurrence, candidates, and merge suggestions across all namepoints. Optionally suggest tags for a specific handle.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/a431ceda-8562-4d35-97c5-1c0f31b64bc7/badge.svg)](https://vouch.tools/servers/a431ceda-8562-4d35-97c5-1c0f31b64bc7)