Dojo Genesis MCP Server

The methodology layer for Claude Code. It encodes 99 first-party working methods across 10 behavioral plugins as active cognitive scaffolds: instead of giving Claude more data, it gives Claude structured methods for software development decisions.

We have not yet measured whether these scaffolds improve Claude's decisions, so this README makes no claim that they do.

---

Quick Install

Claude Code

Add to your project's .claude/settings.json:

{
  "mcpServers": {
    "dojo": {
      "command": "/path/to/dojo-mcp-server",
      "env": {
        "DOJO_SKILLS_PATH": "/path/to/CoworkPluginsByDojoGenesis",
        "DOJO_ADR_PATH": "./decisions"
      }
    }
  }
}

Or using Docker:

{
  "mcpServers": {
    "dojo": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/dojogenesis/mcp-server:latest"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "dojo": {
      "command": "/path/to/dojo-mcp-server",
      "env": {
        "DOJO_SKILLS_PATH": "/path/to/CoworkPluginsByDojoGenesis",
        "DOJO_ADR_PATH": "./decisions"
      }
    }
  }
}

---

What's Included

Tools (28)

Group	Tools
Methodology	dojo_scout, dojo_invoke_skill, dojo_search_skills, dojo_list_skills, dojo_apply_seed, dojo_reflect
Decisions	dojo_log_decision (writes ADR markdown to DOJO_ADR_PATH)
Gateway memory	dojo_memory_list, dojo_memory_store, dojo_memory_search (gateway session memory)
Memory Hub	dojo_search_memory, dojo_get_memory, dojo_recent_memories — read-only Postgres mirror of the institutional memory (DOJO_MEMORY_DB_URL)
Unified fetch	dojo_fetch — one tool to search AND fetch across memory hub + skills + ADRs + seeds (typed ids: memory:slug, skill:name, adr:file.md, seed:name)
Seeds	dojo_seed_list, dojo_seed_create, dojo_seed_search
Agents²	dojo_agent_list, dojo_agent_dispatch², dojo_agent_chat²
Dispatch²	dojo_dispatch² — prompt → LLM through the gateway
Project	dojo_project_status, dojo_project_track, dojo_project_decision
Disposition	dojo_disposition_list, dojo_disposition_set
Craft	dojo_converge, dojo_health

² Dispatch-class — spends LLM provider budget through the gateway. In HTTP mode these require a dispatch-enabled API key and are rate limited per key; dojo_scout's LLM path degrades to its offline scaffold for non-dispatch keys.

Skills (99 from CoworkPlugins, 43 bundled)

Skills are complete, battle-tested methodology workflows loaded from SKILL.md files at startup. When DOJO_SKILLS_PATH is set, all 99 first-party CoworkPlugins skills are available. Without it, 43 key skills across 8 plugins are embedded in the binary via go:embed.

Bundled plugins and skills:

Plugin	Skills
agent-orchestration	agent-teaching, decision-propagation, handoff-protocol, workflow-router, workspace-navigation
continuous-learning	debugging, project-exploration, research-modes, research-synthesis, retrospective, web-research-external
skill-forge	mcp-cloudflare-builder, mcp-server-builder, process-extraction, skill-audit, skill-creation, skill-maintenance
specification-driven-development	context-ingestion, frontend-from-backend, implementation-prompt, parallel-tracks, pre-implementation-checklist, release-specification
strategic-thinking	iterative-scouting, multi-surface-strategy, product-positioning, strategic-scout
system-health	documentation-audit, health-audit, semantic-clusters, status-writing
wisdom-garden	compression-ritual, memory-garden, seed-extraction, seed-library

Seed Patches (20)

Seeds are reusable thinking patterns drawn from across the Dojo ecosystem.

Dojo Genesis (Core)

Seed	Description
three_tiered_governance	Three-tiered governance framework: Strategic, Tactical, Operational.
harness_trace	Nested JSON trace log for complete agent session traceability.
context_iceberg	4-tier context management system (hot/warm/cold/pruned).
agent_connect	Routing-first agent architecture with a single supervisor.
go_live_bundles	Lightweight deployment packages pairing artifacts with approval evidence.
cost_guard	Budget for the full 5-10x context iceberg multiplier.
safety_switch	Users must remain in control -- no autopilot on sensitive operations.
implicit_perspective_extraction	Extract implicit perspectives from user queries without enumeration.
mode_based_complexity_gating	Route to local or cloud models based on mode complexity.
shared_infrastructure	Build once, reuse everywhere -- central implementations.

This is the beginning of the README. Read the rest at the original. Read the full README ↗