MCP Catalogs
← Home

sub-agents-mcp

by shinpr·★ 83·Score 46

Define task-specific AI sub-agents in Markdown for use with any MCP-compatible tool.

developer-toolsai-llmproductivity
15
Forks
0
Open issues
this month
Last commit
2d ago
Indexed

Overview

This MCP server brings Claude Code-style sub-agent workflows to any MCP-compatible environment. Users define specialized agents in markdown files with clear tasks and completion criteria, which can then be invoked through various backends including Cursor CLI, Claude Code, Gemini CLI, or Codex. The server enables reusable, shareable AI agents that maintain context across sessions and work across different IDEs and tools.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Code review and quality analysis using specialized agents
you:Test generation for code modules with custom test-writer agents
you:Documentation generation with purpose-built doc-writer agents
you:How do I create a new agent?
you:Can I use custom models with sub-agents?

When to choose this

Choose this when you want to reuse Claude Code-style sub-agents across different AI tools or share specialized agent definitions with team members regardless of their preferred IDE.

When NOT to choose this

Avoid if you need only simple agent definitions or if you prefer a more integrated solution without requiring separate MCP configuration.

Tools this server exposes

1 tool extracted from the README
  • execute_sub_agent

    Execute a specialized sub-agent defined in a markdown file to perform a specific task.

Comparable tools

sub-agents-skillsclaude-code-workflowscursor-agent

Installation

Installation

  1. Install an execution engine (cursor-agent, claude, gemini, or codex CLI)
  2. Configure MCP in your IDE:

- Cursor: ~/.cursor/mcp.json - Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sub-agents": {
      "command": "npx",
      "args": ["-y", "sub-agents-mcp"],
      "env": {
        "AGENTS_DIR": "/absolute/path/to/your-agents-folder",
        "AGENT_TYPE": "cursor"  // or "claude", "gemini", or "codex"
      }
    }
  }
}
  1. Create agent markdown files in your agents folder

FAQ

How do I create a new agent?
Create a markdown file in your agents directory with a structure including Agent Name, Task, and Done When sections.
Can I use custom models with sub-agents?
Agent execution depends on your chosen backend (Cursor CLI, Claude Code, Gemini CLI, or Codex), each with its own model selection options.

On Hacker News

Recent discussion from the developer community.

Compare sub-agents-mcp with

sub-agents-mcp vs ultimate_mcp_serversub-agents-mcp vs mcp-server-chartsub-agents-mcp vs everythingsub-agents-mcp vs filesystemsub-agents-mcp vs time
GitHub →

Last updated · Auto-generated from public README + GitHub signals.