Summary
This is a persistent context manager for IDEs and editors outside Claude Desktop. It maintains a single project.faf file and syncs it bidirectionally with format-specific files like .cursorrules for Cursor, AGENTS.md for Codex, and GEMINI.md for Gemini. The 25 MCP tools handle initialization, scoring (0-100% AI readiness), enhancement, and cross-platform sync operations. You can run it locally via stdio, self-host on Vercel, or point to the hosted version at mcpaas.live. The cloud tools let you publish, fetch, and share context globally. It also includes faf_git for generating context from any GitHub repo URL without cloning. Built on the FAF ecosystem with 62,000+ downloads and ships with 309 tests across 9 suites.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
33 tools
faf_aboutLearn what .faf format is
Learn what .faf format is
No parameter schema in public metadata yet.
faf_whatQuick explanation of .faf format
Quick explanation of .faf format
No parameter schema in public metadata yet.
faf_statusCheck if project has project.faf1 params
Check if project has project.faf
Parameters* required
pathstringfaf_scoreCalculate AI-readiness score (0-100%)1 params
Calculate AI-readiness score (0-100%)
Parameters* required
pathstringfaf_initCreate project.faf for a project1 params
Create project.faf for a project
Parameters* required
pathstringfaf_trustValidate project.faf integrity1 params
Validate project.faf integrity
Parameters* required
pathstringfaf_syncSync .faf with CLAUDE.md1 params
Sync .faf with CLAUDE.md
Parameters* required
pathstringfaf_enhanceEnhance .faf with AI optimization1 params
Enhance .faf with AI optimization
Parameters* required
pathstringfaf_bi_syncBi-directional sync to CLAUDE.md, AGENTS.md, .cursorrules, GEMINI.md1 params
Bi-directional sync to CLAUDE.md, AGENTS.md, .cursorrules, GEMINI.md
Parameters* required
pathstringfaf_clearClear caches and reset state
Clear caches and reset state
No parameter schema in public metadata yet.
faf_debugDebug MCP environment info
Debug MCP environment info
No parameter schema in public metadata yet.
faf_readRead file content1 params
Read file content
Parameters* required
pathstringfaf_writeWrite file content2 params
Write file content
Parameters* required
pathstringcontentstringfaf_listList and discover .faf projects1 params
List and discover .faf projects
Parameters* required
pathstringfaf_chatNatural language .faf generation via 6W questions1 params
Natural language .faf generation via 6W questions
Parameters* required
messagestringfaf_fridayFun features and fuzzy matching
Fun features and fuzzy matching
No parameter schema in public metadata yet.
faf_guideFAF MCP usage guide
FAF MCP usage guide
No parameter schema in public metadata yet.
faf_readmeExtract context from README.md1 params
Extract context from README.md
Parameters* required
pathstringfaf_human_addAdd human context (6Ws)3 params
Add human context (6Ws)
Parameters* required
pathstringfieldstringvaluestringfaf_checkQuality inspection for .faf fields1 params
Quality inspection for .faf fields
Parameters* required
pathstringfaf_contextSet or view active project context1 params
Set or view active project context
Parameters* required
pathstringfaf_goGuided interview to Gold Code (100%)1 params
Guided interview to Gold Code (100%)
Parameters* required
pathstringfaf_autoZero to AI context in one command1 params
Zero to AI context in one command
Parameters* required
pathstringfaf_dnaShow project DNA evolution journey1 params
Show project DNA evolution journey
Parameters* required
pathstringfaf_formatsDiscover all formats in your project1 params
Discover all formats in your project
Parameters* required
pathstringfaf_quickLightning-fast .faf creation1 params
Lightning-fast .faf creation
Parameters* required
inputstringfaf_doctorDiagnose and fix .faf issues1 params
Diagnose and fix .faf issues
Parameters* required
pathstringfaf_agentsSync AGENTS.md (OpenAI/Codex)1 params
Sync AGENTS.md (OpenAI/Codex)
Parameters* required
pathstringfaf_cursorSync .cursorrules (Cursor IDE)1 params
Sync .cursorrules (Cursor IDE)
Parameters* required
pathstringfaf_geminiSync GEMINI.md (Google Gemini)1 params
Sync GEMINI.md (Google Gemini)
Parameters* required
pathstringfaf_conductorSync Conductor directory1 params
Sync Conductor directory
Parameters* required
pathstringfaf_gitGenerate .faf from GitHub repo URL1 params
Generate .faf from GitHub repo URL
Parameters* required
urlstringfaf_tri_syncSync project.faf to Claude MEMORY.md (Pro)1 params
Sync project.faf to Claude MEMORY.md (Pro)
Parameters* required
pathstring
faf-mcp
Persistent Project Context for Cursor, IDEs and VS Code. Define once. Sync everywhere.
Home: wolfe-jam.github.io/faf-mcp · Hosted MCP endpoint: https://ide.faf.one/mcp/v1 (Streamable HTTP)
The MCP you didn't realise you needed, or wanted but didn't know who to ask, is here. Building on 62,000+ downloads across the FAF ecosystem, we bring you faf-mcp to cure your syncing pain and fuel your chosen AI with optimized context, on-demand.
What's New in 2.3.0 — The Curated Edition
The tools you actually need, up front. faf-mcp now leads with 15 essential tools by default — a clean, focused surface instead of a wall of options. Need everything? Set FAF_TOOLS=all for the full 29 (every tool stays callable by name either way). And every Core tool's description was rewritten so your AI picks the right one, first time.
Define once. Sync everywhere.
You maintain .cursorrules. Your teammate uses AGENTS.md. Someone on the team just switched to Gemini. Every AI tool wants its own context file — and they all say the same thing in different formats.
faf-mcp is the dedicated MCP server for Cursor, Windsurf, Cline, VS Code, and every non-Claude platform. One .faf file in your repo, synced to every format your team needs.
project.faf
│
┌────────┬───────┴───────┬────────────┐
▼ ▼ ▼ ▼
CLAUDE.md AGENTS.md .cursorrules GEMINI.md
(Claude) (Codex) (Cursor) (Gemini)
Quick Start
bunx faf-mcp
Add to your MCP config:
{"mcpServers": {"faf": {"command": "bunx", "args": ["faf-mcp"]}}}
| Platform | Config File |
|---|---|
| Cursor | ~/.cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Cline | Cline MCP settings |
| VS Code | MCP extension config |
| Claude Desktop | Use claude-faf-mcp |
Three Ways to Deploy
| Door | Method | Best For |
|---|---|---|
| Hosted | mcpaas.live | Zero-install, point any MCP client to the URL |
| Self-Deploy | Deploy to Vercel | Your own instance, full control |
| Local | bunx faf-mcp | IDE integration via stdio transport |
Hosted (mcpaas.live)
Point your MCP client to https://ide.faf.one/mcp/v1 — no install, no config, no maintenance. Served from 300+ Cloudflare edges with sub-ms cold starts via 2.7KB Zig-WASM engine.
Self-Deploy (Vercel)
Deploy your own MCP server on Vercel in one click. Once deployed, your server exposes:
/health— Health check/info— Server metadata + tool list/mcp/v1— MCP Streamable HTTP transport
Local (npm)
npx faf-mcp
Interop Tools
| Tool | Platform | Action |
|---|---|---|
faf_agents | OpenAI Codex | Import/export/sync AGENTS.md |
faf_cursor | Cursor IDE | Import/export/sync .cursorrules |
faf_gemini | Google Gemini | Import/export/sync GEMINI.md |
faf_conductor | Conductor | Import/export directory structure |
faf_git | GitHub | Generate .faf from any repo URL |
# Sync to all formats at once
faf bi-sync --all
# Generate .faf from any GitHub repo
faf_git { url: "https://github.com/facebook/react" }
Core tier: 15 essential tools shown by default; set FAF_TOOLS=all for the full 29 (every tool stays callable by name either way) · with CLI fallback · 9 test suites · 7 bundled parsers
Cloud Sync
Share your FAF context globally via mcpaas.live:
| Tool | Purpose |
|---|---|
faf_cloud_publish | Upload to cloud, get shareable URL |
faf_cloud_fetch | Pull context from cloud |
faf_cloud_list | List available souls |
faf_cloud_search | Search across souls |
faf_cloud_share | Generate share links |
Example Workflow:
# Upload your project.faf
faf_cloud_publish { soul_name: "my-project" }
→ https://mcpaas.live/souls/my-project
# Anyone can fetch it
faf_cloud_fetch { soul_name: "my-project" }
→ Context merged into local project.faf
Zero-install sharing - Recipients need no MCP setup. Served from 300+ Cloudflare edges with <1ms cold starts via 2.7KB Zig-WASM engine.
Eternal Bi-Sync
Your .faf file and your platform context files stay synchronized in milliseconds.
project.faf ←── 8ms ──→ .cursorrules / AGENTS.md / CLAUDE.md / GEMINI.md
Single source of truth
- Update either side → both stay aligned
--allflag syncs to all four formats at once- Zero manual maintenance
- Works across teams, branches, sessions
AI assistants forget. They drift. Every new session, AI starts guessing again. Bi-sync means context never goes stale.
Tier System: From Blind to Optimized
| Tier | Score | Status |
|---|---|---|
| 🏆 TROPHY | 100% | AI never has to guess |
| ★ GOLD | 99%+ | 1 slot from Trophy |
| ◆ SILVER | 95%+ | Close — keep going |
| ◇ BRONZE | 85%+ | Interim — keep going |
| ● GREEN | 70%+ | Interim — keep going |
| ● YELLOW | 55%+ | AI flipping coins |
| ○ RED | <55% | AI working blind |
| ♡ WHITE | 0% | No context at all |
At 55%, AI is guessing half the time. At 100%, AI is optimized.
use>faf | Prompt Pattern
Start every prompt with "Use FAF" to invoke MCP tools:
Use FAF to initialize my project
Use FAF to score my AI-readiness
Use FAF to sync my context
Use FAF to enhance my project
Works on all platforms — stops web search, forces tool usage.
29 MCP Tools
| Tool | Purpose |
|---|---|
faf_init | Initialize project.faf |
faf_score | Check AI-readiness (0-100%) |
faf_sync | Sync context across platforms |
faf_bi_sync | Bi-directional .faf ↔ CLAUDE.md |
faf_read | Parse and validate FAF files |
faf_write | Create/update FAF with validation |
| Interop Tools | |
faf_agents | Import/export/sync AGENTS.md |
faf_cursor | Import/export/sync .cursorrules |
faf_gemini | Import/export/sync GEMINI.md |
faf_conductor | Import/export directory structure |
faf_git | Generate .faf from GitHub repo URL |
| Cloud Tools | |
faf_cloud_publish | Upload to mcpaas.live |
faf_cloud_fetch | Pull from cloud |
faf_cloud_list | List souls |
faf_cloud_search | Search souls |
faf_cloud_share | Generate share links |
Plus CLI fallback (via faf-cli):
faf readme- Extract 6 Ws from README (+25-35% boost)faf human-add- Non-interactive YAML merge (6Ws Builder)faf git- GitHub repo analysis without cloning- And 40+ more commands...
Ecosystem
- claude-faf-mcp — Claude Desktop (33 tools)
- faf-cli — Terminal CLI
- faf-wasm — WASM SDK (<5ms scoring)
- faf.one — Official website
If faf-mcp has been useful, consider starring the repo — it helps others find it.
License
MIT License — Free and open source
Zero drift. Eternal sync. AI optimized. 🏆
"It's so logical if it didn't exist, AI would have built it itself" — Claude
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →