# Grok FAF

Grok asked for MCP on a URL. This is it.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add wolfe-jam/grok-faf-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list wolfe-jam/grok-faf-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get wolfe-jam/grok-faf-mcp faf_about

# Call a tool
npx -y @smithery/cli@latest tool call wolfe-jam/grok-faf-mcp faf_about '{}'
```

## Direct MCP Connection

Endpoint: `https://grok-faf-mcp--wolfe-jam.run.tools`

## Tools (20)

- `faf_about` — Learn what .faf format is
- `faf_what` — Quick explanation of .faf format
- `faf_status` — Check if project has project.faf
- `faf_score` — Calculate AI-readiness score (0-100%)
- `faf_init` — Create project.faf for a project
- `faf_trust` — Validate project.faf integrity
- `faf_sync` — Sync .faf with CLAUDE.md
- `faf_enhance` — Enhance .faf with AI optimization
- `faf_bi_sync` — Bi-directional sync between project.faf and CLAUDE.md. v4.5.0: Also sync to AGENTS.md, .cursorrules, GEMINI.md!
- `faf_clear` — Clear caches, temporary files, and reset FAF state for a fresh start
- `faf_debug` — Debug Claude FAF MCP environment - show working directory, permissions, and FAF CLI status
- `faf_read` — Read content from any file on the local filesystem
- `faf_write` — Write content to any file on the local filesystem
- `faf_list` — List directories and discover projects with project.faf files - Essential for FAF discovery workflow
- `faf_chat` — Guided interview to build project.faf
- `faf_friday` — Friday features — Chrome Extension detection, fuzzy matching
- `faf_guide` — FAF MCP usage guide for Claude Desktop - Projects convention, path resolution, and UX patterns
- `rag_query` — Ask a question with RAG-enhanced context from xAI Collections. Uses LAZY-RAG cache for 100,000x speedup on repeated que…
- `rag_cache_stats` — Get LAZY-RAG cache statistics - hits, misses, hit rate, cache size
- `rag_cache_clear` — Clear the LAZY-RAG cache to start fresh

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get wolfe-jam/grok-faf-mcp <tool-name>
```