Developers

What it is

kaRkas is a project memory for AI tools. You map your product — jobs-to-be-done, milestones, models, stack, brand, design — and your AI reads it through the Model Context Protocol.

No copy-paste. No re-explaining the codebase. Every Cursor chat, every Claude Code session starts already briefed.

Install

Run one of these in your project root:

# Cursor
curl -sSL https://app.karkas.io/connect/cursor?token=YOUR_TOKEN | sh

# Claude Code
curl -sSL https://app.karkas.io/connect/claude-code?token=YOUR_TOKEN | sh

# Cline, Continue, or any other MCP client
curl -sSL https://app.karkas.io/connect/generic?token=YOUR_TOKEN | sh

Grab the token in Settings → MCP, or hit Create access tokenon any project's Build tab.

Tools

Loading tool catalog…

Resources

Server-streamed reads for tools that prefer resources over tool calls.

• karkas://briefing — your project, distilled into one markdown document. Mission, models, stack, brand, design, current milestone, next task, recent decisions.
• karkas://project/context — raw bundle for tools that want one payload.
• karkas://projects — index of projects this token can see.

Skills

Skills are prompt templates. The install script drops yours into the agent's native skill folder so they load automatically:

• Cursor → .cursor/rules/skill-<slug>.mdc
• Claude Code → .claude/skills/<slug>.md

Agents can also fetch skills at runtime with list_skills and get_skill.

Scopes

Every tool requires a scope. New tokens get the safe defaults: every read, plus write:scaffold, write:notes, write:tasks, write:milestones, write:quality.

Opt-in only

• read:user_memory — your global AI memory.
• write:user_memory — append a short preference.
• read:other_chats — read sibling chat threads in the project.

Toggle these in Settings → MCP → Default scopes. New tokens inherit your selection.

Manual setup

If you'd rather wire the config yourself:

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "karkas": { "url": "https://app.karkas.io/mcp?token=YOUR_TOKEN" }
  }
}

Claude Code — ~/.claude/settings.json

{
  "mcpServers": {
    "karkas": {
      "type": "http",
      "url": "https://app.karkas.io/mcp?token=YOUR_TOKEN"
    }
  }
}