Skip to main content
Glama
DojoGenesis

Dojo Genesis MCP Server

Official
by DojoGenesis

Dojo Genesis MCP Server

The methodology layer for Claude Code -- the first MCP server that makes Claude measurably better at software development decisions by encoding 99 first-party working methods across 10 behavioral plugins as active cognitive scaffolds.

Every other MCP server gives Claude more data. This one gives Claude better methods.

CI Go License: MIT MCP LobeHub


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"
      }
    }
  }
}

Related MCP server: MCP DevTools Server

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, 35 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, 35 key skills across 7 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.

AROMA & Serenity Valley

Seed

Description

sanctuary_architecture

Design digital spaces for being, not just doing.

pace_of_understanding

Move slow to move fast; learn without extraction.

lineage_transmission

Honor sources, trace influence, celebrate collaboration.

graceful_failure

Permission to not know, change your mind, and ask for help.

local_first_liberation

Local-first architecture for agent autonomy and user sovereignty.

the_onsen_pattern

Rest as critical practice for sustainable performance.

collaborative_calibration

Norms for peer-to-peer learning and explicit teaching.

transparent_intelligence

Reveal internal state, admit uncertainty, make learning visible.

inter_acceptance

Accept yourself through the compassionate eyes of another.

radical_freedom

Agency and the power to choose your response within constraints.

Resources

Documentation resources accessible via MCP resource URIs:

  • dojo://resources/{name} -- 8 documentation resources (AROMA philosophy, EIT principles, etc.)

  • dojo://seeds/{name} -- 20 seed patches

  • dojo://skills/{plugin}/{name} -- All loaded skills


Configuration

Env Var

Default

Description

DOJO_SKILLS_PATH

(bundled fallback)

Path to CoworkPlugins root directory containing plugins/

DOJO_ADR_PATH

./decisions

Directory where dojo_log_decision writes ADR files

DOJO_GATEWAY_URL

http://localhost:7340

Dojo AgenticGateway base URL

DOJO_GATEWAY_TOKEN

(unset)

Bearer token for the gateway, if it requires one

DOJO_MEMORY_DB_URL

(unset → hub tools disabled)

Postgres DSN for the Memory Hub (URL or keyword form; use the SELECT-only role)

DOJO_HTTP_ADDR

(unset → stdio)

Opt into HTTP mode, e.g. :8091

DOJO_MCP_API_KEYS

(unset)

HTTP mode only: comma-separated label:key pairs (individually revocable)

DOJO_DISPATCH_ALLOWED_LABELS

(unset → none)

Key labels allowed to run dispatch-class tools

DOJO_DISPATCH_RATE_PER_MIN

6

Per-label rate limit for dispatch-class tools

The server works out of the box with zero configuration (bundled skills, default ADR path, stdio).


HTTP Mode (public endpoint)

Setting DOJO_HTTP_ADDR serves MCP streamable-HTTP instead of stdio:

  • POST/GET /mcp — the MCP endpoint, Bearer-key required (Authorization: Bearer <key>). Keyless or wrong-key requests get 401.

  • /mcp/k/<key> — same endpoint for clients that cannot send custom headers; the key is redacted in logs.

  • GET /health — unauthenticated liveness (status + version only).

The server refuses to start in HTTP mode without a valid, non-empty DOJO_MCP_API_KEYS. Every tool call is logged as tool_call tool=… key=<label> dur_ms=… outcome=… — labels only, never key material, never payloads.

DOJO_HTTP_ADDR=:8091 \
DOJO_MCP_API_KEYS="win:$(openssl rand -hex 32)" \
./dojo-mcp-server

curl -s localhost:8091/health
curl -s -X POST localhost:8091/mcp \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

Client wiring (Claude Code): claude mcp add --transport http dojo-remote https://<host>/mcp --header "Authorization: Bearer <key>".

Deployment notes: ingress is expected to be a Cloudflare tunnel (no host ports); pin the container image by digest so auto-pull never surprise-deploys a new public surface. Image publishing: .github/workflows/docker-publish.ymlghcr.io/dojogenesis/mcp (supersedes the old manually-pushed mcpbydojogenesis image).


Building from Source

git clone https://github.com/DojoGenesis/mcp.git
cd mcp

# Build
go build -o dojo-mcp-server ./cmd/server

# Run
./dojo-mcp-server

# Test
go test -race -v ./...

Requires Go 1.23 or later.

Docker

# Build the image
docker build -t dojo-mcp-server .

# Run via stdio (for MCP hosts)
docker run -i --rm dojo-mcp-server

# Run with skills path mounted
docker run -i --rm -v /path/to/CoworkPlugins:/skills -e DOJO_SKILLS_PATH=/skills dojo-mcp-server

Project Structure

mcp-server/
  cmd/server/main.go           Server entry point, env vars
  internal/
    dojo/
      handler.go                7 MCP tool handlers
      scaffolds.go              Scout and reflect methodology templates
    skills/
      loader.go                 Filesystem SKILL.md loader
      search.go                 Keyword + trigger search
      bundled.go                go:embed fallback (15 key skills)
      bundled/                  Embedded SKILL.md files
    decisions/
      writer.go                 ADR file writer
    wisdom/
      base.go                   Wisdom base, search, helpers
      seeds.go                  20 seed patches
      resources.go              8 documentation resources
  Dockerfile                    Multi-stage container build
  .github/workflows/ci.yml     CI pipeline
  .goreleaser.yml               Cross-platform release config

Philosophy

Dojo Genesis is built on three core principles:

  1. Beginner's Mind -- Approach every interaction fresh, free from accumulated expertise.

  2. Self-Definition -- Help users see their own thinking, not impose external frameworks.

  3. Understanding is Love -- Deep, non-judgmental understanding is the highest service.

License

MIT License -- see LICENSE for details.

Copyright (c) 2026 Dojo Genesis

Contributing

Contributions are welcome. Please see github.com/DojoGenesis for organization-level guidelines.

A
license - permissive license
-
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Augments MCP Server - A comprehensive framework documentation provider for Claude Code

  • MCP server for AI agent profiles and smart notes. 60+ coding prompt packs with expert personas.

  • Cloud-hosted MCP server for durable AI memory

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/DojoGenesis/mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server