# FAF: The IANA-Registered Format Powering AI Context
**15,000+ npm downloads | MIT License | MCP Protocol Native**
---
## The Problem We Solved
Every AI conversation starts the same way: "Let me explain my project..."
Developers waste hours re-explaining their codebase to AI assistants. Context gets lost between sessions. Teams duplicate effort. AI works blind.
**FAF fixes this.**
---
## What is FAF?
**FAF (Foundational AI-context Format)** is the first IANA-registered format specifically designed for AI context delivery.
```
MIME Type: application/vnd.faf+yaml
Status: IANA Registered
License: MIT (Free & Open Source)
```
One file. Complete project understanding. Works with any AI.
---
## By The Numbers
| Metric | Value |
|--------|-------|
| **Total Downloads** | 15,000+ |
| **npm Packages** | claude-faf-mcp, faf-cli, faf-wasm |
| **MCP Tools** | 51 native tools |
| **Performance** | <5ms scoring |
| **License** | MIT |
---
## Universal Compatibility
FAF works everywhere:
```
Claude Desktop → .faf → MCP Protocol
Claude Code → .faf → MCP Protocol
xAI Grok → .faf → Native/Embed
Gemini CLI → .faf → CLI tested/approved
OpenAI Codex → .faf → CLI tested/approved
Any LLM/IDE → .faf → Instant Understanding
```
**One format. Every AI.**
---
## The Mk3 Tier System
AI-Readiness scoring that actually means something:
| Score | Tier | What It Means |
|-------|------|---------------|
| 100% | 🏆 Trophy | Perfect AI context |
| 99%+ | 🥇 Gold | Exceptional |
| 95%+ | 🥈 Silver | Excellent |
| 85%+ | 🥉 Bronze | Production ready |
| 70%+ | 🟢 Green | Solid foundation |
| 55%+ | 🟡 Yellow | Needs improvement |
| <55% | 🔴 Red | AI working blind |
At 55%, you're flipping a coin with AI assistance.
---
## Get Started in 30 Seconds
```bash
npm install -g claude-faf-mcp
```
Add to Claude Desktop config:
```json
{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "claude-faf-mcp"]}}}
```
Done. Your projects now have persistent AI context.
---
## The Ecosystem
- **[claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)** - MCP Server (51 tools)
- **[faf-cli](https://npmjs.com/package/faf-cli)** - Command-line tooling
- **[faf-wasm](https://npmjs.com/package/faf-wasm)** - WASM SDK (<5ms)
- **[Chrome Extension](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)** - Browser integration
---
## Why IANA Registration Matters
IANA registration means FAF is:
- **Official** - Recognized internet standard
- **Permanent** - Won't disappear or change arbitrarily
- **Universal** - Any tool can implement support
- **Professional** - Enterprise-ready from day one
`application/vnd.faf+yaml` is the MIME type for AI context.
---
## Open Source. MIT Licensed. Forever Free.
FAF is built for the community:
- Free for personal use
- Free for commercial use
- Free to modify and distribute
- No vendor lock-in
**[GitHub](https://github.com/Wolfe-Jam/claude-faf-mcp)** | **[Discord](https://discord.com/invite/56fPBUJKfk)** | **[npm](https://npmjs.com/package/claude-faf-mcp)**
---
## The Future of AI Context
Every project deserves AI that understands it from the first message.
FAF makes that possible.
**Install today. Context forever.**
```bash
npm install -g claude-faf-mcp
```
---
*"It's so logical if it didn't exist, AI would have built it itself" — Claude*
---
**faf.one** | MIT License | IANA Registered | 15k+ Downloads
