{% extends "base.html" %} {% load static %} {% block title %}Mimir - Engineering Playbook{% endblock %} {% block content %}
Mimir

Welcome to Mimir

Your team's book of spells — the codified wisdom of how great software gets built

Capture your best engineers' hard-won know-how as structured playbooks: precise workflows, step-by-step activities, the rules and agent personas that turn a blank AI prompt into expert output. Your AI assistant reads the relevant spell before it acts — so every developer, every session, casts from the same book. When a spell needs improving, any team member can propose a change; it goes through a structured review cycle, gets assessed by a built-in AI critic, and — if approved — the book updates and versions up. Junior engineers stop improvising and start executing proven patterns. Senior knowledge stops evaporating when people leave.

With every sprint and every feature built, your team and their AI get sharper — because the playbook they share keeps improving.

Explore Playbooks View PIPs
Connect Your AI IDE to Mimir via MCP

Two steps: register to get your token, then add the config snippet to your IDE.

Step 1 — Register and get your token

Register — your authentication token is shown on the confirmation page. Copy and save it.

Step 2 — Add to your IDE config

The config below pulls the latest Mimir MCP container from Docker Hub (featurefactory/mimir-mcp) and runs it with your token. No local install needed — Docker handles everything.

File: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mimir": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "MIMIR_SERVER_URL=https://mimir.featurefactory.io",
        "-e", "MIMIR_TOKEN=<your-token>",
        "-e", "MCP_TRANSPORT=stdio",
        "featurefactory/mimir-mcp:latest"
      ]
    }
  }
}

File: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mimir": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "MIMIR_SERVER_URL=https://mimir.featurefactory.io",
        "-e", "MIMIR_TOKEN=<your-token>",
        "-e", "MCP_TRANSPORT=stdio",
        "featurefactory/mimir-mcp:latest"
      ]
    }
  }
}

File: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mimir": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "MIMIR_SERVER_URL=https://mimir.featurefactory.io",
        "-e", "MIMIR_TOKEN=<your-token>",
        "-e", "MCP_TRANSPORT=stdio",
        "featurefactory/mimir-mcp:latest"
      ]
    }
  }
}

Self-host Mimir using Docker Compose — web app + MCP facade in one command.

git clone https://github.com/phainestai/mimir.git
cd mimir
cp .env.example .env   # set MIMIR_USER and MIMIR_PASSWORD
docker compose up -d

# FOB web UI:  http://localhost:8000
# MCP SSE:     http://localhost:8001/sse

Then point your IDE config at MIMIR_SERVER_URL=http://localhost:8000 with a locally obtained token. See DOCKER_QUICK_START.md for full details.

Replace <your-token> with the token from your registration confirmation. Restart your IDE after saving.
{% endblock %}