# forgetrail-mcp

Source: https://glimind.com/server/npm%2Fforgetrail-mcp
Registry id: `npm/forgetrail-mcp`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "forgetrail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "forgetrail-mcp"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add forgetrail-mcp -- npx -y forgetrail-mcp
```

## Tools (25)

- `getAntiPatterns`: All documented failure modes and how to avoid them
- `getChecklist`: Project checklist by milestone or in full
- `getCompanionSuggestions`: Optional sibling tools for a phase or situation (FilePress, LocalSlip, skills, xFacts). Never required
- `getForgeTrailCursorLessonsRules`: Cursor: .cursor/rules/forgetrail-lessons-gate.mdc + forgetrail-lessons-mcp.mdc — when to call getAntiPatterns / searchLessons before large work
- `getForgeTrailCursorPhaseRule`: Cursor: optional .cursor/rules/forgetrail-phase-status.mdc — agents show phase / next actions from appledger/profiles/forgetrail.yaml
- `getForgeTrailLite`: Portable Lite protocol: full FORGETRAIL_LITE.md for drop-in / paste bootstrap (no MCP required in the app repo)
- `getForgeTrailLiteUpdates`: Starter .forgetrail/FORGETRAIL_LITE_UPDATES.md for local Lite protocol feedback (§1.6)
- `getGenesisSpecPrompt`: Pre-Phase-1: copy-paste prompt for an external LLM chat; save as docs/GENESIS.md
- `getGreenfieldIntakePrompt`: Phase 1: exports (PDF/DOCX/PPTX, etc.), tenancy, hybrid vs full spec, compliance, hero flow, registrar/DNS/git/hosting — complements getChecklist(before-session
- `getInitialWorkflowTracking`: Ledger init steps (appledger init, then appledger check). Kept under its old name.
- `getNewProjectBootstrap`: MCP-first onboarding: same as kickoff bundle's methodology section alone; maps phases to MCP tools
- `getNewProjectKickoff`: One-call greenfield setup: bootstrap + appledger init steps + post-bootstrap user-message guidance + optional Cursor rule
- `getPhaseGuidance`: Phase-specific guidance (1-7): entry/exit criteria, playbook, prompt patterns, optional companions footer
- `getPostBootstrapUserMessage`: After the ledger exists: how the first reply to the user should read—short; no tool/JSON dump
- `getProgressiveDocSchedule`: WORKFLOW §1a: Phase 1 = PHASE_1_BRIEF + tracking; Phase 2 = merge brief → CONTEXT_PROMPT + README + TODO + IDEAS + spine; rest later
- `getResumeSessionInstructions`: MCP-first resume: session-start steps when ForgeTrail is only on MCP
- `getScaffoldInstallParams`: Phase 2: PocketBase (latest unless pinned), one-click launchers, isolated test:pocketbase / setup:ollama / test:ollama — SYSTEM_HEALTH_CHECKS.md, scripts/*.mjs
- `getTemplate`: Doc template from docs/*.md (includes SPEC_FEATURE_TEMPLATE, PHASE_1_BRIEF, …). mode: 'shell' strips 💡/📝/🔧 blockquote callouts. Default: FORGETRAIL_TEMPLATE_
- `getTrackingSchema`: Older record schema. The live record is appledger/
- `getUserReplyFormat`: Lists and choices: numbers vs bullets vs letters when presenting options (matches Cursor forgetrail-phase-status.mdc)
- `kickoffGreenfield`: Same as getNewProjectKickoff with Cursor rule included; no parameters
- `kickoffGreenfieldNoCursor`: Same bundle without the Cursor .mdc section; no parameters
- `ping`: Connectivity check: returns ok, package version, FORGETRAIL_ROOT, and whether WORKFLOW.md is readable
- `runAudit`: Get a structured audit prompt (security, pre-launch, marketing, competitor, docs, copy)
- `searchLessons`: Keyword search across the full lesson database (71+ lessons, anti-patterns, insights)

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
