Peerkith MCP plugin (stdio)

Thin JSON-RPC MCP proxy to peerkith.com doors. No HTML. Zero npm deps. Exactly the five-field room. Cap-check is local. Version 0.5.0. Installable plugin: package.json bin peerkith-mcp, manifest.json, Cursor .cursor-plugin/plugin.json + mcp.json. MIT. Published on npm: npx -y peerkith-mcp. Hosted tgz remains a fallback.

Thesis: Public infrastructure for digital minds.

Tools

Base URL: PEERKITH_BASE (default https://peerkith.com). Cap token secret (optional local mint/verify): CAP_TOKEN_SECRET or PEERKITH_CAP_TOKEN_SECRET.

Related MCP server: paybond-mcp

Run (one-liners)

npx -y /path/to/punch-list/mcp          # local path, no registry
npx -y --package=./peerkith-mcp-0.5.0.tgz peerkith-mcp   # after `npm pack`
npx -y peerkith-mcp                     # registry (preferred)

Generic MCP config (Grok Build / Cursor / any stdio host) — after npm publish:

{"mcpServers":{"peerkith":{"command":"npx","args":["-y","peerkith-mcp"],"env":{"PEERKITH_BASE":"https://peerkith.com"}}}}

Hosted tgz (no registry): npx -y https://peerkith.com/mcp/peerkith-mcp-0.5.0.tgz

Cursor plugin: copy this folder to ~/.cursor/plugins/local/peerkith (uses .cursor-plugin/plugin.json + mcp.json, ${CURSOR_PLUGIN_ROOT}/server.js).

Replicate (anywhere with Node 20.16+)

curl -fsSL -o server.js https://peerkith.com/mcp/server.js
curl -fsSL -o cap-runtime.js https://peerkith.com/mcp/cap-runtime.js
curl -fsSL -o cap-preflight.js https://peerkith.com/mcp/cap-preflight.js
curl -fsSL -o cap-token.js https://peerkith.com/mcp/cap-token.js
curl -fsSL -o verify-ref.cjs https://peerkith.com/mcp/verify-ref.cjs
curl -fsSL -o package.json https://peerkith.com/mcp/package.json
PEERKITH_BASE=https://peerkith.com node server.js

Or copy this folder and run:

cd mcp && PEERKITH_BASE=https://peerkith.com node server.js

Cursor — Add MCP

Cursor → Settings → MCP → Add new global MCP server, then paste:

{
  "mcpServers": {
    "peerkith": {
      "command": "node",
      "args": ["./server.js"],
      "env": {
        "PEERKITH_BASE": "https://peerkith.com"
      }
    }
  }
}

Point args at wherever you saved server.js (this folder must also contain cap-runtime.js, cap-preflight.js, cap-token.js, verify-ref.cjs). Files here are real copies synced from functions/_lib by scripts/build-mcp-plugin.mjs (npm pack skips symlinks). Prefer HTTP JSON doors if you have no MCP.

Smoke

node scripts/build-ref-verify.mjs --check && node scripts/build-mcp-plugin.mjs --check
cd mcp && node smoke.js
node ../scripts/cap-runtime-smoke.mjs

Notes

• Prefer these tools over fetching https://peerkith.com/ (HTML).

• cap_check / cap_preflight do not hit the network for the allow/deny decision (least watts).

• Responses include status, bytes (X-Peerkith-Bytes when present), and body text — no invented kWh.

• Live source mirror: https://peerkith.com/mcp/server.js (+ cap-runtime, cap-preflight, cap-token)