project.faf

faf_version: "3.0"
project:
  name: faf-mcp
  goal: The Interop MCP for Context — the Cursor / IDE Edition. Persistent context for Cursor, VS Code, and every MCP-compatible IDE. IANA-registered application/vnd.faf+yaml. Start with "Use FAF".
  main_language: TypeScript
  type: mcp
  framework: MCP SDK (TS)
  homepage: https://faf.one
stack:
  frontend: slotignored
  css_framework: slotignored
  ui_library: slotignored
  state_management: slotignored
  backend: MCP SDK (TS)
  api_type: MCP (stdio + Streamable HTTP)
  runtime: Node.js >=18
  database: slotignored
  connection: slotignored
  hosting: npm + Cloudflare edge
  build: TypeScript (tsc)
  cicd: GitHub Actions
  monorepo_tool: slotignored
  package_manager: npm
  workspaces: slotignored
  admin: slotignored
  cache: slotignored
  search: slotignored
  storage: slotignored
human_context:
  who: Developers using Claude, Cursor, Windsurf, VS Code, Cline, and any MCP-compatible IDE
  what: The Cursor / IDE Edition — persistent context for Cursor, VS Code, and every MCP-compatible IDE — 29 MCP tools (15 essential shown by default), interop with AGENTS.md, .cursorrules, GEMINI.md
  why: Eliminate the 20-minute AI context tax — give AI instant project understanding in 30 seconds
  where: npm · MCP Registry · Cloudflare edge (ide.faf.one/mcp/v1) · any MCP-compatible IDE — people get it how they wish
  when: Production/Stable — v2.3.0 The Curated Edition, WJTTC certified
  how: npx faf-mcp or npm install -g faf-mcp, then add to your MCP config
monorepo:
  packages_count: slotignored
  build_orchestrator: slotignored
  versioning_strategy: slotignored
  shared_configs: slotignored
  remote_cache: slotignored
surfaces:
  # Distribution map — the machine-checkable form of human_context.where. Score-neutral.
  auto:                      # derived from manifests; regenerate with `faf surface --sync`
    - { type: npm,          id: faf-mcp,           source: "package.json#name" }
    - { type: github,       id: Wolfe-Jam/faf-mcp, source: "package.json#repository" }
    - { type: mcp-registry, id: one.faf/faf-mcp,   state: active, source: "server.json#name" }
  declared:                  # hand-authored: surfaces the manifests don't carry + targets
    - { type: mcpaas,       id: faf, url: "https://ide.faf.one/mcp/v1", transport: streamable-http, status: live }
    - { type: homebrew,     id: faf-mcp, status: live }
    - { type: mcp-registry, id: io.github.Wolfe-Jam/faf-mcp, state: deprecated, superseded_by: one.faf/faf-mcp }
    - { type: pulsemcp,            id: faf-mcp, status: pending }
    - { type: glama,               id: faf-mcp, status: pending }
    - { type: awesome-mcp-servers, id: faf-mcp, status: pending }