Skip to content
MCP server

.FAF Context

Writes AGENTS.md, CLAUDE.md and .cursorrules from one project.faf file, locally

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, vscode, self-hosted
Runs
Locally
Version
4.2.0
Listing updated
3 days ago

About .FAF Context

.FAF Context is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

FAF keeps a project's context in a single YAML file, project.faf, and generates each tool's own file from it: AGENTS.md, .cursorrules, GEMINI.md and CLAUDE.md. Each is scored so you can see where the context is thin. This server runs locally over stdio on the same faf-cli the terminal uses.

Version 4.2.0 changed who fills in the human slots: faf_go shows each suggested goal or answer with its source, such as the README or package.json, and only what you confirm is written. faf_init and faf_auto leave them empty and report how many suggestions wait, so a new file scores honestly low. faf_write refuses to overwrite existing context files without overwrite: true and never touches the .faf-dna birth certificate.

The project is MIT-licensed and the media type is registered with IANA.

Install

Run in a terminal

claude mcp add faf-mcp -- npx -y faf-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "faf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "faf-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "faf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "faf-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "faf-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "faf-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "faf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "faf-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "faf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "faf-mcp"
      ]
    }
  }
}

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

faf_go
Offers sourced suggestions for goal and answers; writes only confirmed ones.
faf_init
Creates a new project.faf.
faf_auto
Automatic setup leaving human slots empty.
faf_readme
Suggests README content without writing.
faf_sync
Updates name and stack from package.json.
faf_claude
Writes CLAUDE.md and chained files.
faf_write
Writes files with overwrite guards.
faf_dna
Handles the birth certificate.
faf_git
Writes the goal from the GitHub description.
faf_doctor
Explains why context is incomplete.
faf_score
Shows what is missing.

What it does

One source file
project.faf drives every tool's context file.
Confirm before writing
Suggested goals are shown with sources; only confirmed ones are saved.
Context scoring
Scores show what is missing.
Overwrite guards
Existing files need explicit overwrite.
Local stdio
Runs on your machine via npm.

Good for

  • Keep CLAUDE.md and .cursorrules in sync
  • Bootstrap context for a new repo
  • Find gaps in project context
  • Give an editor's AI a project summary

Pricing

Open source

Prices change. Check faf.one before you buy.

.FAF Context FAQ

Which files does it generate?

AGENTS.md, .cursorrules, GEMINI.md and CLAUDE.md.

Does the AI write my project goal?

Not since 4.2.0; suggestions are shown and only your confirmed answers are written.

How do I install it?

npm package faf-mcp, stdio.

Licence?

MIT.

Is .FAF Context free?

Yes. .FAF Context is open source, so you can use and self-host it for free.

How do I add .FAF Context to Claude Code?

Run this command in your terminal: claude mcp add faf-mcp -- npx -y faf-mcp

What are the best alternatives to .FAF Context?

The closest alternatives to .FAF Context are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to .FAF Context

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools