{"name":"one.faf/faf-mcp","slug":"faf-mcp","title":".FAF Context","description":".FAF Context — persistent project context for Cursor, VS Code and every MCP-compatible IDE.","url":"https://mcp.market/server/faf-mcp","rating":null,"grade":"A","score":91,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":42,"stars":7,"forks":2,"downloads_week":1474,"last_push_at":"2026-09-16T04:01:18.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/Wolfe-Jam/faf-mcp","website":"https://faf.one","version":"3.0.2","remotes":[],"packages":[{"registryType":"npm","identifier":"faf-mcp","version":"3.0.2","runtimeHint":"npx","transport":{"type":"stdio"}}],"tools":[{"name":"faf_about","description":"Explain what the .faf format is — the IANA-registered, portable context file (application/vnd.faf+yaml) that gives any AI instant project understanding. Returns a plain-language overview of the format and its purpose. Use this when you or the user are new to FAF and want the concept before running other tools.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_agents","description":"Import AGENTS.md (the OpenAI/Codex convention) into project.faf, or write it from project.faf. Returns the merged or written result for the chosen action. Use this to keep a Codex/OpenAI-style AGENTS.md and your .faf in agreement from one source.","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_auto","description":"Run the setup pipeline in one call — init or merge, stack detection, CLAUDE.md, and score — taking a project from no context to a scored project.faf plus CLAUDE.md; faf_go closes the human slots. Returns the final AI-readiness score and what was created. Use this as the fast path on a fresh project; use the individual tools when you need finer control.","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_check","description":"Inspect the human_context fields and rate each empty/generic/good. Returns the ratings; with protect it records the good fields in _protected_fields as an advisory list (other tools do not enforce it), with unlock it clears that list. Use this to gauge context quality.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_claude","description":"Write CLAUDE.md from project.faf (one direction: .faf → CLAUDE.md) and, with the format flags or all, also AGENTS.md, .cursorrules and GEMINI.md. Content outside the faf-managed block is preserved. Returns the files written. Use this to keep every AI tool's context file current from one source. (Named faf_bi_sync before 3.0.1; that name still works.)","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_clear","description":"Remove ~/.faf-cli-cache/technical-credit.json, the cache file left by faf-mcp versions before 3.0. Other files in ~/.faf-cli-cache are left in place.","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_conductor","description":"Import/Export between conductor/ directory (Google Conductor) and project.faf - AI interop!","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_context","description":"Set or show the active project path that later faf_ project tools resolve against (faf_read and faf_write resolve relative paths against the server's working directory instead). Returns the current context path. Call this once at the start of a session so the project tools target the right project.","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_cursor","description":"Import .cursorrules (the Cursor IDE convention) into project.faf, or write it from project.faf. Returns the merged or written result for the chosen action. Use this to keep Cursor rules and your .faf in agreement from one source.","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_debug","description":"Debug faf-mcp environment - show working directory, write permissions, the bundled faf-cli version, and whether a project.faf is present","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_dna","description":"Show and record your FAF DNA journey — the score evolution of this project.faf from birth to today (e.g. 22% → 85% → 100%). Creates .faf-dna on the first call and appends a milestone when the score changes.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_doctor","description":"Diagnose a project.faf setup — report missing files, the real score with populated/active slot counts, and common configuration issues, each with a fix. Returns a checklist. Use this when your score is low and you need to know why.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_formats","description":"Scan the project for tech-stack signals across 150+ manifest types (package.json, Cargo.toml, pyproject.toml, go.mod, and more). Returns the detected formats, the stack signature and faf-cli's slot-fill hints. Use this to see what stack detection finds.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_gemini","description":"Import GEMINI.md (the Google Gemini CLI convention) into project.faf, or write it from project.faf. Returns the merged or written result for the chosen action. Use this to keep a Gemini context file and your .faf in agreement from one source.","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_git","description":"Author a project.faf from any public GitHub repository URL — fetches the repo and extracts its stack and context. Returns the authored .faf. Use this to bootstrap context for a project you have the URL for but not cloned locally.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_go","description":"Drive a project.faf to 100% through a guided interview — returns the next questions for the missing human-context and goal fields, then applies the answers passed back. Returns the updated score after each round. Use this to close the gap to a complete context when auto-detection cannot fill the human slots.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_guide","description":"FAF MCP usage guide for your MCP host - Projects convention, path resolution, and UX patterns","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_human_add","description":"Add a human_context field (who/what/why/where/when/how) - Non-interactive for MCP","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_init","description":"Create a project.faf for a project, making it instantly AI-readable. Returns the new file location and starting score. Accepts a path or bare project name (e.g. ~/Projects/my-app, my-app) and omitting it uses the current directory.","write_action":true,"price_micros":0,"input_schema":null},{"name":"faf_list","description":"List directories and discover projects with project.faf files - Essential for FAF discovery workflow","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_quick","description":"Lightning-fast .faf creation - One-liner format: \"name, description, language, framework, hosting\"","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_read","description":"Read content from any file on the local filesystem","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_readme","description":"Extract 6 Ws (Who/What/Why/Where/When/How) from README.md into human_context - Smart pattern matching","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_score","description":"Calculate a project.faf AI-readiness score (0-100%) from the populated context slots. Returns the percentage and tier, and with details a slot-by-slot breakdown with improvement suggestions. Use this to measure how complete the AI context is and what to fill next.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_status","description":"Check if your project has project.faf (project DNA for AI) - Shows AI-readability status","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_sync","description":"Reconcile project.faf with what the repo manifests say now (package.json name, description, framework dependencies). Dry-run by default: reports the fields that would change. Pass apply:true to write them into project.faf. Does not touch CLAUDE.md — use faf_claude for CLAUDE.md, AGENTS.md, .cursorrules and GEMINI.md.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_trust","description":"Validate a project.faf's required fields (faf_version, project.name) and about.* block with faf-cli's validator, and report its real score.","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_what","description":"What is .faf format? Quick explanation of project DNA for AI","write_action":false,"price_micros":0,"input_schema":null},{"name":"faf_write","description":"Write content to any file on the local filesystem","write_action":true,"price_micros":0,"input_schema":null}],"scan":{"score":91,"grade":"A","scanned_at":"2026-09-19T20:27:49.969Z","report":{"scannerVersion":"0.1.5","scannedAt":"2026-09-19T20:27:49.937Z","components":{"code":{"score":25,"max":25,"notes":["73 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":12,"max":15,"notes":["local package, no credentials required"]},"maintenance":{"score":15,"max":15,"notes":["last push 4 days ago"]},"identity":{"score":7,"max":10,"notes":["namespace and repository owner differ","GitHub account older than a year","website matches verified namespace"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"faf-mcp","version":"3.0.2","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":4,"publishedAt":"2026-09-10T20:57:58.195Z","repositoryUrl":"git+https://github.com/Wolfe-Jam/faf-mcp.git","weeklyDownloads":1474}],"repo":{"found":true,"owner":"Wolfe-Jam","repo":"faf-mcp","archived":false,"pushedAt":"2026-09-16T04:01:18Z","stars":7,"forks":2,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/189686721?v=4","ownerCreatedAt":"2024-11-26T02:22:29Z","license":"MIT"},"icon":{"url":"https://raw.githubusercontent.com/Wolfe-Jam/faf-mcp/main/assets/icons/faf-icon-48.png","source":"registry","width":48,"height":48},"presence":{"stars":7,"forks":2,"downloadsWeek":1474,"license":"MIT","lastPushAt":"2026-09-16T04:01:18.000Z","score":42}}}},"grade_history":[],"reviews":[]}