IDE

TokRepo for Cursor

Cursor reads .cursor/rules/*.mdc as workspace rules and ~/.cursor/mcp.json for MCP servers.

Official docs: https://docs.cursor.com/context/model-context-protocol

60-second integration

Shortest path for Cursor

  1. 01
    npx -y tokrepo@latest init-agent --target cursor
  2. 02
    Add tokrepo to ~/.cursor/mcp.json (see snippet below).
  3. 03
    Open Composer; ask "find me a tokrepo discover skill" — agent calls tokrepo_discover.
Project rule file
.cursor/rules/tokrepo.mdc
Install surface
.cursor/rules/
MCP client
~/.cursor/mcp.json
MCP install command
{"mcpServers":{"tokrepo":{"command":"npx","args":["-y","tokrepo-mcp-server"]}}}
Six mandatory rules

Every agent runtime enforces

  • SESSION BOOTSTRAP — call tokrepo_session_init once per session.
  • DISCOVER BEFORE BUILD — call tokrepo_discover before writing reusable artifacts.
  • VERIFY BEFORE INSTALL — install_plan must include trust_gate; honor TOKREPO_MIN_TRUST (default 0.6).
  • DRY-RUN BEFORE APPLY — lifecycle tools default dry_run=true.
  • HANDOFF AFTER REUSABLE WORK — call tokrepo_handoff_plan.
  • PRIVATE BY DEFAULT, NEVER PUSH SECRETS.