# FACTS

> FACTS turns any codebase into two artifacts from one analysis pass: an AI-agent-readable map and a CXO-readable dashboard — plus a live MCP surface for AI coding agents.

## Fetch the analysis (works in any chat, no install)

- [/data/summary.json](/data/summary.json) — start here: a few-KB digest (project, stack, health grade, top risks, entry points, counts).
- [/data/factstack.json](/data/factstack.json) — the complete analysis (~2 MB JSON): dependency graph, routes, risks, docs, history.
- [/factstack.pack](/factstack.pack) — the same data as a compact line-oriented pack (~80% smaller than the JSON).

## Drive it from a coding agent (CLI + MCP)

- The `@factstack/cli` CLI and `@factstack/mcp-server` MCP server are **not on npm yet**. When published: `npx -y @factstack/cli` and `npx -y @factstack/mcp-server` (17 tools + 4 resources).
- Today, run them from a clone of the repo: `npx tsx apps/cli/src/cli.ts` and `npx tsx apps/mcp-server/src/server.ts`.
- **First-contact tool order**: `read_memory` → `analyze` → `query_graph` → `list_risks` → `list_credentials` → `list_vulnerabilities`.

## More

- [/llms-full.txt](/llms-full.txt) — full tool + resource reference.
- [/.well-known/mcp.json](/.well-known/mcp.json) — machine-readable MCP manifest.
- [Dashboard](/) — interactive browser UI (requires JavaScript; use the fetch endpoints above for data).