faf-ide
Product playbook for faf-mcp (one.faf/faf-mcp) — IANA .faf project context over MCP for Cursor, VS Code, Windsurf, Cline-class hosts.
Transport: local stdio (npx / bunx faf-mcp). Skills guide; tools act.
Tools (call these)
| Tool | When |
|---|---|
faf_auto |
Zero → context in one shot (init, detect, sync, score) |
faf_init |
Create or enhance project.faf |
faf_score |
AI-readiness 0–100% + gaps |
faf_context |
Current project context snapshot |
faf_sync |
Sync project.faf ↔ human-readable guide |
faf_bi_sync |
Bi-directional context ↔ IDE format files |
faf_cursor |
Cursor / .cursorrules interop |
faf_agents |
AGENTS.md interop |
faf_gemini |
Gemini context interop |
faf_about |
What .faf is (format overview) |
Default tools/list is a curated Core set; more tools may exist when FAF_TOOLS=all. Only call tools this server lists.
Rules
- Prefer structured
.fafover free-form chat memory for project facts. - Claim equals wire — only tools advertised by this server.
- No secrets in skill text or tool args you do not own.
- Origin — served by faf-mcp (
skills/*+resources/read); not a remote install authority.
Flow
initialize → skills/list → resources/read(skill://faf-ide/SKILL.md) → tools/call