ensemble-mcp docs
Presentation GitHub

AI Tool Compatibility Guide

Which AI tools work with ensemble-mcp, what gets installed where, and which MCP tools each tool can use.


Supported AI Tools

AI ToolMCP ServerAgentsSkillsAuto-Detect
OpenCodeYesYesYesYes
Claude CodeYesYesYesYes
GitHub Copilot (VS Code)YesNoNoYes
CursorYesNoYesYes
WindsurfYesNoNoYes
Devin CLIYesNoYesYes
Any MCP-compatible toolYes (manual)ManualManualNo
Note

All 6 supported tools use JSON config. The installer auto-detects them, creates backups, and registers in one command.


What Gets Installed

1. MCP Server Registration

The core integration — registers ensemble-mcp as an MCP server so the AI tool can call all 19 tools.

ToolGlobal Config FileLocal Config FileConfig Key
OpenCode~/.config/opencode/config.jsonconfig.jsonmcp.ensemble
Claude Code~/.claude/claude_desktop_config.json.claude.jsonmcpServers.ensemble
GitHub Copilot~/.vscode/mcp.json.vscode/mcp.jsonservers.ensemble
Cursor~/.cursor/mcp.json.cursor/mcp.jsonmcpServers.ensemble
Windsurf~/.windsurf/mcp.json.windsurf/mcp.jsonmcpServers.ensemble
Devin CLI~/.devin/mcp.json.devin/mcp.jsonmcpServers.ensemble

2. Agent Files (7 agents)

The multi-agent pipeline agents. Only some tools have agent directories:

Agent FilePurposeOpenCodeClaude Code
team-ensemble.mdCaptain / orchestratorYesYes
team-scope.mdArchitect / plannerYesYes
team-craft.mdEngineer / code writerYesYes
team-forge.mdBuilder / test runnerYesYes
team-lens.mdInspector / code reviewerYesYes
team-signal.mdShipper / git opsYesYes
team-trace.mdHunter / bug detectorYesYes

Agent file locations:

ToolGlobalLocal
OpenCode~/.config/opencode/agents/.opencode/agents/
Claude Code~/.claude/agents/.claude/agents/
Note

GitHub Copilot, Cursor, Windsurf, and Devin CLI don't have native agent directory support. You can still use ensemble-mcp tools directly — you just won't get the multi-agent pipeline.

3. Skill Files (1 bundled skill)

The ensemble-mcp-workflow skill teaches any AI agent when and how to call the 19 MCP tools.

ToolLocal Skill LocationSkill Format
OpenCode.opencode/skills/ensemble-mcp-workflow/SKILL.mdDirectory (<name>/SKILL.md)
Claude Code.claude/skills/ensemble-mcp-workflow.mdFlat (.md file)
Cursor.cursor/rules/ensemble-mcp-workflow.mdFlat (.md file)
Devin CLI.devin/ensemble-mcp-workflow.mdFlat (.md file)
Note

GitHub Copilot and Windsurf don't have native skill directories.


The 19 MCP Tools — What Each Tool Can Use

Every AI tool that has the MCP server registered gets access to all 19 tools. The MCP server is identical regardless of which tool connects. The difference is in how well each tool can leverage them.

Full Tool List

#ToolCategoryWhat It Does
1patterns_searchMemorySemantic search over stored patterns from past tasks
2patterns_storeMemorySave a new pattern (problem + approach + outcome)
3patterns_pruneMemoryClean up old/unused patterns
4drift_checkDriftCheck if code changes drifted from the original task
5model_recommendRoutingRecommend model tier (best/mid/cheapest) for agent + task
6skills_discoverSkillsScan skill directories, find relevant skills by query
7skills_suggestSkillsDetect recurring patterns, propose as reusable skills
8skills_generateSkillsAccept/dismiss/defer a skill suggestion
9session_saveSessionSave pipeline checkpoint (with optimistic versioning)
10session_loadSessionLoad latest or specific checkpoint
11session_searchSessionSearch past sessions by semantic similarity
12project_indexIndexerBuild/refresh the codebase index
13project_queryIndexerFind files by type, path pattern, or semantic query
14project_dependenciesIndexerGet import/dependency graph for a file
15project_snapshotIndexerGenerate compact project baseline summary
16context_compressCompressCompress verbose text to save tokens
17context_prepareCompressOrder prompt sections for optimal LLM cache hits
18healthUtilityServer health check (status, version, DB size)
19resetUtilityDelete all stored data (destructive)

Which Tools Matter Most Per AI Tool

OpenCode — Full Pipeline Support

OpenCode gets the richest experience because it supports agents, skills, and MCP:

Pipeline PhaseMCP Tools UsedWhy
Pre-pipelineproject_index, project_snapshot, patterns_search, skills_discover, model_recommendBuild context, find past solutions, choose model tier
Planningproject_query, project_dependencies, session_searchExplore codebase, find related sessions
Implementationsession_save, context_compressCheckpoint progress, reduce token usage
Post-implementationdrift_checkVerify changes match the task
Testing & reviewsession_saveUpdate checkpoint after tests pass
Completionpatterns_store, session_saveSave approach for future recall
Maintenancepatterns_prune, skills_suggest, skills_generateClean up, create reusable skills

Claude Code — Full Pipeline Support

Same pipeline as OpenCode — supports agents, skills, and MCP:

Pipeline PhaseMCP Tools Used
Pre-pipelineproject_index, project_snapshot, patterns_search, skills_discover, model_recommend
Planningproject_query, project_dependencies, session_search
Implementationsession_save, context_compress
Post-implementationdrift_check
Completionpatterns_store, session_save
Maintenancepatterns_prune, skills_suggest, skills_generate

GitHub Copilot — MCP Tools Only

No agents or skills, but all 19 MCP tools are callable. Best used as a standalone assistant:

Use CaseMCP Tools
Explore a codebaseproject_index, project_snapshot, project_query, project_dependencies
Remember past workpatterns_search, patterns_store, patterns_prune
Check driftdrift_check
Resume worksession_save, session_load, session_search
Compress contextcontext_compress, context_prepare
Server statushealth

Cursor — MCP Tools + Skills

Has skill support (via .cursor/rules/) so the workflow skill teaches it when to call tools:

Use CaseMCP Tools
Explore a codebaseproject_index, project_snapshot, project_query, project_dependencies
Remember past workpatterns_search, patterns_store
Check driftdrift_check
Resume worksession_save, session_load, session_search
Find/create skillsskills_discover, skills_suggest, skills_generate
Compress contextcontext_compress, context_prepare

Windsurf — MCP Tools Only

Same as Copilot — all 19 tools callable, no agents or skills:

Use CaseMCP Tools
Explore a codebaseproject_index, project_snapshot, project_query, project_dependencies
Remember past workpatterns_search, patterns_store, patterns_prune
Check driftdrift_check
Resume worksession_save, session_load, session_search
Compress contextcontext_compress, context_prepare

Devin CLI — MCP Tools + Skills

Has skill support (via .devin/) for the workflow skill:

Use CaseMCP Tools
Explore a codebaseproject_index, project_snapshot, project_query, project_dependencies
Remember past workpatterns_search, patterns_store
Check driftdrift_check
Resume worksession_save, session_load, session_search
Find/create skillsskills_discover, skills_suggest, skills_generate
Compress contextcontext_compress, context_prepare

Capability Tiers at a Glance

TierWhat You GetAI Tools
Full Pipeline7 agents + workflow skill + 19 MCP toolsOpenCode, Claude Code
Tools + SkillsWorkflow skill + 19 MCP tools (single-agent mode)Cursor, Devin CLI
Tools Only19 MCP tools (manual invocation)GitHub Copilot, Windsurf
Manual Setup19 MCP tools (register yourself)Any MCP-compatible tool

Multi-Agent Pipeline (Full Pipeline tier only)

When using OpenCode or Claude Code with the full agent set, the 7 agents use MCP tools at specific pipeline phases:

AgentRoleMCP Tools It Uses
team-ensemble (Captain)Orchestrates the pipelinepatterns_search, model_recommend, session_search, session_save, drift_check, patterns_store, skills_discover, project_index, project_snapshot
team-scope (Architect)Plans and exploresproject_query, project_dependencies, project_snapshot, skills_discover
team-craft (Engineer)Writes codeproject_dependencies, context_compress, session_save
team-forge (Builder)Formats, builds, testsdrift_check, session_save
team-lens (Inspector)Reviews codecontext_prepare, drift_check
team-signal (Shipper)Git commit/pushsession_save, patterns_store
team-trace (Hunter)Finds bugsproject_query, patterns_search

Quick Install Commands

# Auto-detect all tools and register everything
ensemble-mcp install

# Register only specific tools
ensemble-mcp install --tools cursor,opencode

# Project-local instead of global
ensemble-mcp install --local

# Preview what would happen (no changes)
ensemble-mcp install --dry-run

# Non-interactive (CI/CD)
ensemble-mcp install --yes

# Copy just agent files (no MCP registration)
ensemble-mcp add-agents

# Copy just skill files (no MCP registration)
ensemble-mcp add-skills

# Remove everything
ensemble-mcp uninstall --remove-agents --clean-data

Manual Registration (Any MCP Tool)

For any MCP-compatible tool not listed above:

{
  "ensemble": {
    "command": "uvx",
    "args": ["ensemble-mcp"]
  }
}

Or if installed via pip:

{
  "ensemble": {
    "command": "ensemble-mcp"
  }
}

The server uses stdio transport — reads MCP requests from stdin, writes responses to stdout. All 19 tools become available immediately after registration.


Next Steps