Fallhub

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/fallhub-mcp
• Transport: stdio
• Deps: @modelcontextprotocol/sdk + @ai-native-solutions/fallhub-sdk
• License: MIT

Install

Claude Code

claude mcp add foldkit -- npx -y @ai-native-solutions/fallhub-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/fallhub-mcp"]
    }
  }
}

Cursor

Create or edit .cursor/mcp.json:

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

Cline / Windsurf

Add to your MCP settings JSON:

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

Tools exposed (10)

Resources exposed (4)

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 fallhub-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