.FAF Context MCP server

Read from the package source without running it. The installed server may list more.

• faf_about

  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.

• faf_agentswrite action

  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.

• faf_autowrite action

  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.

• faf_check

  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.

• faf_claudewrite action

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

• faf_clearwrite action

  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.

• faf_conductor

  Import/Export between conductor/ directory (Google Conductor) and project.faf - AI interop!

• faf_contextwrite action

  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.

• faf_cursorwrite action

  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.

• faf_debugwrite action

  Debug faf-mcp environment - show working directory, write permissions, the bundled faf-cli version, and whether a project.faf is present

• faf_dna

  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.

• faf_doctor

  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.

• faf_formats

  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.

• faf_geminiwrite action

  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.

• faf_git

  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.

• faf_go

  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.

• faf_guide

  FAF MCP usage guide for your MCP host - Projects convention, path resolution, and UX patterns

• faf_human_add

  Add a human_context field (who/what/why/where/when/how) - Non-interactive for MCP

• faf_initwrite action

  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.

• faf_list

  List directories and discover projects with project.faf files - Essential for FAF discovery workflow

• faf_quick

  Lightning-fast .faf creation - One-liner format: "name, description, language, framework, hosting"

• faf_read

  Read content from any file on the local filesystem

• faf_readme

  Extract 6 Ws (Who/What/Why/Where/When/How) from README.md into human_context - Smart pattern matching

• faf_score

  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.

• faf_status

  Check if your project has project.faf (project DNA for AI) - Shows AI-readability status

• faf_sync

  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.

• faf_trust

  Validate a project.faf's required fields (faf_version, project.name) and about.* block with faf-cli's validator, and report its real score.

• faf_what

  What is .faf format? Quick explanation of project DNA for AI

• faf_writewrite action

  Write content to any file on the local filesystem

• Code scan73 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancelast push 4 days ago15/15
• Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace7/10

.FAF Context: common questions

Is .FAF Context MCP server safe?

Yes, by our scan: it is graded A (91/100). Read the .FAF Context safety report

How do I install .FAF Context?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does .FAF Context need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is .FAF Context maintained?

The last commit was 4 days ago (2026-09-16). The latest release is v3.0.2.