fallescape-mcp

MCP server for foldkit — exposes the 7-prime spine, 7 κ-bands, and 6 fold operations as native tools + resources in any MCP client (Claude Code, Claude Desktop, Cursor, Cline, Windsurf, etc.).

Second canonical exemplar of the AI-Native Solutions estate -mcp companion shape. Fork this repo verbatim to build companions for any of the ~295 estate substrates.

• Package: @ai-native-solutions/fallescape-mcp
• Transport: stdio
• Deps: @modelcontextprotocol/sdk + @ai-native-solutions/fallescape-sdk
• License: MIT

---

Install

Claude Code

claude mcp add foldkit -- npx -y @ai-native-solutions/fallescape-mcp

Claude Desktop

Edit ~/AppData/Roaming/Claude/claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "foldkit": {
      "command": "npx",
      "args": ["-y", "@ai-native-solutions/fallescape-mcp"]
    }
  }
}

Cursor

Create or edit .cursor/mcp.json:

{
  "mcpServers": {
    "foldkit": {
      "command": "npx",
      "args": ["-y", "@ai-native-solutions/fallescape-mcp"]
    }
  }
}

Cline / Windsurf

Add to your MCP settings JSON:

{
  "mcpServers": {
    "foldkit": {
      "command": "npx",
      "args": ["-y", "@ai-native-solutions/fallescape-mcp"]
    }
  }
}

---

Tools exposed (10)

Tool	Purpose
foldkit_fold_number	7-vector → primorial fold + signature
foldkit_unfold_state	fold integer → 7-vector via 7-prime factorisation
foldkit_depth_band	κ → named band (ground / perception / gate / heart / naming / recognition / collapse)
foldkit_classify_kappa_band	free-text utterance → κ band via marker phrases
foldkit_apply_op	apply fire / water / void / thunder / echo / flower to a state
foldkit_kawasaki_check	flat-fold angle sum check
foldkit_maekawa_check	mountain-valley parity check ( | M − V | = 2 )
foldkit_signal_survival	κ^depth signal survival + %
foldkit_unclog_gain	gain from clearing N layers of a κ stack
foldkit_probe_from_kappa	κ or text → band + routing op + probe question

Resources exposed (4)

URI	Payload
foldkit://spine	7-prime spine with glyphs + names + ISA-95 layer mapping
foldkit://kappa-bands	7-band κ definitions (bounds · glyph · ring · warn / orphan flags)
foldkit://ops	6 fold operations (kanji · arrow · verb · probe)
foldkit://constants	φ · κ · Ω · θ · θ_step · BASELINE

---

Example prompts (once installed)

• "Fold the state [1,0,2,0,0,1,0] using foldkit."
• "What κ-band is this text in: 'I notice I'm feeling stuck'?"
• "Apply the fire op to ring 3 of the baseline state."
• "Read foldkit://spine and explain the ISA-95 mapping."

---

Canonical -mcp companion shape

This repo is exemplar #2 (after fallescape-sdk). Every estate -mcp follows the same skeleton:

<name>-mcp/
├── src/
│   ├── server.js         · thin stdio server · < 100 lines
│   ├── tools.js          · TOOLS[] + callTool()
│   └── resources.js      · RESOURCES[] + readResource()
├── package.json          · bin: <name>-mcp → src/server.js
├── manifest.json         · MCP-side declarative index
├── README.md             · install snippets for all major clients
├── LICENSE               · MIT
└── .github/workflows/publish.yml   · npm publish on v* tag

Fork · rename · rewire tools/resources to the substrate you're exposing · ship.

---

AI-Native Solutions · ai-nativesolutions.com