Skip to content
Agentmart
Submit a tool

.FAF Context

.FAF Context — persistent project context for Cursor, VS Code and every MCP-compatible IDE.

Connector by faf.oneOfficial · Domain verified by the MCP Registry

IndexedMITLocal (stdio)★ 7
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/faf-one-faf-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

.FAF Context — persistent project context for Cursor, VS Code and every MCP-compatible IDE.

Use cases: prompt-engineering, documentation

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
12 read · 13 write · 4 delete
Secrets
None asked for
Install scripts
None found
Runs as
Node.js package

Tools by what they do 29

Read from the source code; the running server may list different tools.

Read 12 · Look things up without changing anything.

  • faf_about
  • faf_context
  • faf_debug
  • faf_doctor
  • faf_formats
  • faf_guide
  • faf_list
  • faf_read
  • faf_score
  • faf_status
  • faf_trust
  • faf_what

Write 13 · Create, change, send or run things.

  • faf_agents
  • faf_auto
  • faf_check
  • faf_claude
  • faf_cursor
  • faf_dna
  • faf_gemini
  • faf_go
  • faf_human_add
  • faf_init
  • faf_quick
  • faf_readme
Show 1 more tools
  • faf_sync

Delete 4 · Delete, drop, revoke or wipe things.

  • faf_clear
  • faf_conductor
  • faf_git
  • faf_write

Files it touches

  • Any path the agent passes to its tools

Tools (29)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • faf_aboutAbout FAFread-only

    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_agentsSync AGENTS.md

    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_autoAuto-detect Context

    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_checkCheck .faf Health

    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 CLAUDE.md and IDE formats from .faf

    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_clearClear .faf Datacan change or delete data

    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_conductorSync Conductorcan change or delete data

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

  • faf_contextView Contextread-only

    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_cursorSync .cursorrules

    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_debugDebug Inforead-only

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

  • faf_dnaView Project 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_doctorDiagnose Issuesread-only

    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_formatsList Formatsread-only

    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_geminiSync GEMINI.md

    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_gitExtract from GitHubcan change or delete data

    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.

Show 14 more tools
  • faf_goGuided Setup

    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_guideUsage Guideread-only

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

  • faf_human_addAdd Human Context

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

  • faf_initInitialize .faf

    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_listList Directoriesread-only

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

  • faf_quickQuick Create

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

  • faf_readRead Project Fileread-only

    Read content from any file on the local filesystem

  • faf_readmeExtract from README

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

  • faf_scoreAI-Readiness Scoreread-only

    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_statusProject Statusread-only

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

  • faf_syncReconcile .faf with repo manifests

    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_trustTrust Scoreread-only

    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_whatWhat is FAFread-only

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

  • faf_writeWrite Project Filecan change or delete data

    Write content to any file on the local filesystem

Signals

Stars
7
Forks
3
Open issues
0
Last commit
Oct 23, 2026 (5 days ago)
Last release
Oct 16, 2026 (12 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
one.faf/faf-mcp
Version
4.0.1
Auth
No auth
Packages
npm faf-mcp
License
MIT
Repository
github.com/Wolfe-Jam/faf-mcp
Website
faf.one
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from faf.one

Cite this page

.FAF Context MCP server. Agent Mart. https://agentmart.dev/connectors/faf-one-faf-mcp (last updated 2026-10-24)