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

io.github.Wolfe-Jam/claude-faf-mcp · v5.9.0 · developer-tools

io.github.Wolfe-Jam/claude-faf-mcp is healthy: it completed an MCP handshake in 2110 ms and exposes 20 tools.

Persistent project context for Claude. IANA-registered .faf format.

Endpoint: https://mcpaas.live/claude/mcp/v1 (streamable-http)

Repository · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count20
Latency2110 ms
Last checked (UTC)2026-10-16T06:20:16.645Z

Health history

Checked (UTC)StatusLatencyError
2026-10-16T06:20:16.645ZHealthy2110
2026-10-15T02:35:44.659ZHealthy5089

Tools (20)

get_soulFetch a context soul by name. Returns structured AI context.
list_soulsList all available context souls.
delta_checkDetermine if a topic needs FULL, DELTA, or X-DELTA soul.
list_tagsList all unique tags used in a soul, with counts.
search_by_tagFind all entries in a soul with a specific tag.
search_contextFull-text search across souls. Returns matching lines only (token-efficient).
tag_intelDiscover tag patterns, co-occurrence, candidates, and merge suggestions across all namepoints. Optionally suggest tags for a specific handle.
generate_faf_from_githubGenerate 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_scoreScore .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_validateValidate .faf YAML content: true if mission-ready (always-33 score of 100).
faf_get_tierResolve the FAF tier for a given numeric score. Returns the tier symbol (Trophy/Gold/Silver/Bronze/etc.) per the canonical tier-table.
faf_estimate_tokensEstimate token count for arbitrary content via the Zig WASM engine. Sub-millisecond, zero allocations. Useful for context-budget planning.
faf_analyzeOne-call composite — returns score, tier-ready, valid, and engine identifier. Two WASM calls, sub-millisecond total.
refresh_fafRe-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_recommendationTakes 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_gatePhase 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_sectionPhase 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_memoryPhase 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_searchPhase 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_cardPrint a business card for an agent from its own name, description and colour. 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.