TL;DR: The MCP you didn't realise you needed, or wanted but didn't know who to ask, is here. Building on 36,000+ downloads across Claude and now Gemini, we bring you faf-mcp v2.0.0 to cure your syncing pain and fuel your chosen AI with optimized context, on-demand.

The Problem

You maintain .cursorrules. Your teammate uses AGENTS.md. Someone just switched to Gemini. Every AI tool wants its own context file — and they all say the same thing in different formats.

That's context drift. It's silent, cumulative, and it means your AI is guessing instead of knowing.

The Fix

project.faf
| +--------+--------+--------+ v        v        v        v
CLAUDE.md AGENTS.md .cursorrules GEMINI.md

One .faf file. Every format your team needs. Updated either side, both stay aligned. Zero manual maintenance.

5 New Interop Tools

  • faf_agents — Import/export/sync AGENTS.md (OpenAI Codex)
  • faf_cursor — Import/export/sync .cursorrules (Cursor IDE)
  • faf_gemini — Import/export/sync GEMINI.md (Google Gemini CLI)
  • faf_conductor — Import/export Conductor directory structure
  • faf_git — Generate .faf from any public GitHub repo URL

Plus the --all flag for bi-sync:

faf bi-sync --all

Syncs your .faf to CLAUDE.md + AGENTS.md + .cursorrules + GEMINI.md in one shot.

Who Is This For?

faf-mcp is the dedicated MCP server for Cursor, Windsurf, Cline, VS Code, and every non-Claude platform. If you use Claude Desktop, you want claude-faf-mcp. If you use anything else — this is yours.

Cursor ~/.cursor/mcp.json
Windsurf ~/.codeium/windsurf/mcp_config.json
Cline Cline MCP settings
VS Code MCP extension config

Try It

npx faf-mcp

Add to your MCP config:

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

GitHub

Source and release notes.

v2.0.1 Release

npm

Install the latest version.

faf-mcp

The Numbers

  • v2.0.0 — Released March 7, 2026
  • 309/309 — Tests passing (9 suites)
  • 61 tools — 25 core + 36 advanced
  • 7 bundled parsers — Zero CLI dependency for interop
  • 100% — Trophy score ☑️
  • 36,000+ — Downloads across the FAF ecosystem

What Changed Under the Hood

v2.0.0 — The Interop MCP

  • 5 new MCP tools for cross-platform AI context
  • 7 bundled parsers (agents, cursorrules, gemini, conductor, github, faf-git, slot-counter)
  • WJTTC v2.0.0 Championship Suite — 73 Brake/Engine/Aero tests
  • MCP SDK ^1.27.1
  • Tier system fix: 100 = Trophy max

v2.0.1 — Polish

  • README rewritten for Cursor/Windsurf/Cline devs
  • Windows CRLF normalization in conductor-parser, gemini-parser, and tests
  • CI pipeline fixed: audit, tolerance for MCP Registry duplicates