Satori MCP — Use Cases, Install & Live Demo

Why use it

Key features

Auto-activates after install — no special invocation phrase required
Five-question onboarding to establish context before giving advice
Specialized protocols: Dark Night Protocol, Jungian shadow work arc
Generates pattern letters, dream analysis, purpose-mapping exercises
Explicitly redirects to professional help when needs exceed conversational support

Live Demo

What it looks like in practice

satori-skill.replay ▶ ready

0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "satori-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/MetcalfSolutions/Satori",
        "~/.claude/skills/Satori"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "satori-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/MetcalfSolutions/Satori",
        "~/.claude/skills/Satori"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "satori-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/MetcalfSolutions/Satori",
        "~/.claude/skills/Satori"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "satori-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/MetcalfSolutions/Satori",
        "~/.claude/skills/Satori"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "satori-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/MetcalfSolutions/Satori",
        "~/.claude/skills/Satori"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json

{
  "context_servers": {
    "satori-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/MetcalfSolutions/Satori",
          "~/.claude/skills/Satori"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add satori-skill -- git clone https://github.com/MetcalfSolutions/Satori ~/.claude/skills/Satori

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use Satori

Work through a recurring behavioral pattern with Satori

👤 Anyone noticing a loop they can't seem to break ⏱ ~45 min beginner

When to use: You keep ending up in the same argument, the same burnout cycle, the same avoidance — and generic AI advice hasn't helped.

Prerequisites

Skill installed via Claude.ai Customize > Skills or cloned to ~/.claude/skills/Satori — Upload SatoriSkill-v5.zip on claude.ai, or git clone https://github.com/MetcalfSolutions/Satori ~/.claude/skills/Satori

Flow

Complete the onboarding

I want to work on something with you. Run the Satori intake.✓ Copied

→ Five-question sequence exploring your patterns and history — not instant advice
Describe the loop

Here's the pattern: <describe>. I notice it every few months.✓ Copied

→ Reframe drawing on relevant tradition (Stoic / IFS / etc.) plus a concrete exercise
Use a pattern letter

Write me a pattern letter I can re-read in a month.✓ Copied

→ Warm, specific letter tied to your actual situation, not generic

Outcome: A reframe plus a durable artifact (letter / exercise) you can return to.

Pitfalls

Treating Satori as therapy — The skill itself will redirect for clinical needs — trust that, don't route around it

Combine with: planning-with-files

Analyze a dream journal with Jungian lens

👤 Journalers curious about their dream content ⏱ ~30 min beginner

When to use: You've been writing dreams down and want more than 'it means you're stressed'.

Flow

Share three recent dreams

Using Satori — here are my three most recent dreams. Look for motifs.✓ Copied

→ Specific image-level analysis, not generic symbolism
Ask for a shadow-work prompt

Start the five-session shadow arc using what you saw.✓ Copied

→ Session 1 prompts tailored to your motifs

Outcome: A personalized shadow-work sequence you can run across weeks.

Combinations

Pair with other MCPs for X10 leverage

satori-skill + planning-with-files

Persist Satori session notes across days so the skill remembers your patterns

Use planning-with-files to keep findings.md updated with what we learn each Satori session.✓ Copied

satori-skill + filesystem

Save pattern letters and dream analyses into your own journal folder

Save today's pattern letter to ~/journal/2025-patterns/<date>.md.✓ Copied

Tools

What this MCP exposes

Tool	Inputs	When to call
intake_onboarding	free-text context	First real session — grounds later advice in your actual situation
dark_night_protocol	current distress description	High distress outside office hours — stabilize, don't optimize
shadow_work_arc	recurring pattern or motif	User wants depth work, not quick advice
pattern_letter	situation + what user wants to remember	End of a session — give the user something durable to re-read

Cost & Limits

What this costs to run

API quota: None
Tokens per call: Can be large — the skill references 211k+ characters of wisdom content when activated
Monetary: Free — skills are local files
Tip: If you hit context limits, summarize earlier sessions before starting a new arc.

Security

Permissions, secrets, blast radius

Credential storage: No credentials — pure prompts

Data egress: None — all conversation stays in your Claude session

Satori is not therapy. If you're in crisis, call a local crisis line — the skill itself will also redirect.

Troubleshooting

Common errors and fixes

Skill not invoked — Claude gives generic motivational advice

On claude.ai, verify Satori is toggled on in Skills. Locally, confirm ~/.claude/skills/Satori/SKILL.md exists.

Verify: ls ~/.claude/skills/Satori/SKILL.md

SKILL.md frontmatter wrong

Re-download the v5 zip — a partial unzip breaks the frontmatter.

Verify: head ~/.claude/skills/Satori/SKILL.md

Wrong trigger keywords — onboarding doesn't start

Ask explicitly: 'Run the Satori intake' or 'Use the Satori skill to work on X'.

Alternatives

Satori vs others

Alternative	When to use it instead	Tradeoff
Raw journaling with vanilla Claude	You don't need the wisdom tradition framing	Lighter context load, but Claude reverts to self-help clichés without the skill
Professional therapy	You're in clinical territory (trauma, active crisis, persistent distress)	A skill can't replace a trained human — Satori's own guardrails agree

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills