Gemini FAF MCP server

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

• faf_about

  FAF format info — IANA registration, version, ecosystem. Returns metadata about the FAF format, server version, and available MCP bridges. Use this when users ask what FAF is or how it connects to other AI platforms.

• faf_agents

  Export and write AGENTS.md from a .faf file (non-destructive). Authors a BETTER-shaped AGENTS.md (setup · tests · layout · conventions · three-tier guardrails · definition of done · security · commit) via faf-python-sdk's authoring tool — in parity with faf-cli's `faf export --agents`. Injects it into AGENTS.md as a faf-managed block, preserving any hand content. Re-running updates the block in pl

• faf_auto

  Auto-detect project stack and author/update a .faf file. Scans package.json, pyproject.toml, Cargo.toml, go.mod, and other manifest files for language, framework, database, API type, and build tools — then grounds the result in the repo's own files: docker-compose service images (Postgres, Redis, Elasticsearch...) map onto stack slots, and Makefile / justfile targets map onto test / build / lint c

• faf_context

  Get Gemini-optimized context from a .faf file. Returns the key sections an AI needs: project info, stack, instructions, and score. Use this to quickly understand a project without reading the full .faf structure.

• faf_discover

  Find .faf files in the project tree by walking up from start_dir. Searches the current directory and parent directories for project.faf. Use this before faf_read to locate the file automatically.

• faf_gemini
• faf_initwrite action

  Create a starter .faf file with project name, goal, and language. Writes a valid FAF YAML file with all required sections. Will not overwrite an existing file — use faf_discover first to check. The path is confined to the project root (cwd / FAF_ALLOWED_ROOTS).

• faf_migrate

  Migrate a .faf file to the current format version (3.0). Bumps `faf_version`, ensures the section roots exist (`project`, `stack`, `human_context`, `monorepo`), and re-serializes. Legacy slot names (`frontend`/`database`/…) still score via the registry's aliases — this only touches the version and structure, never your values. Parity with faf-cli's `faf migrate`. Pass dry_run=true to preview.

• faf_model

  Get a 100% Trophy-scored example .faf file for a specific project type. Returns a complete, realistic project.faf that fills all 21 scored slots. Use this as a reference when building or improving a .faf file — shows exactly what 100% looks like. Call without arguments to list all 15 available project types.

• faf_read

  Read project DNA from a .faf file. Returns the full parsed structure including project info, stack, preferences, and scoring data. Use this as the first step to understand any FAF-enabled project.

• faf_score

  Quick Mk4 score check — returns score (0-100%), tier, and slot counts. Uses the Mk4 Championship 21-slot scoring engine for universal parity. Use this for status checks; use faf_validate when you need error details.

• faf_stringify

  Convert parsed FAF data back to YAML string. Useful for displaying the raw .faf content or preparing it for editing. Reads the file, parses it, then re-serializes to clean YAML.

• faf_validate

  Validate a .faf file and return score, tier, and issues. Returns errors (must fix) and warnings (should fix) with specific messages. Use after faf_init or when checking if a .faf file meets quality standards.

• Code scan9 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

Gemini FAF: common questions

Is Gemini FAF MCP server safe?

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

How do I install Gemini FAF?

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

Does Gemini FAF need an API key?

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

Is Gemini FAF maintained?

The last commit was 4 days ago (2026-09-15). The latest release is v2.8.2.