# Subagents MCP for Cursor

> [!IMPORTANT]
> **This repository is archived.** It was created to add subagents support to Cursor before Cursor had a native subagents pattern. Now that Cursor has built-in subagents, this project is no longer needed.

This MCP server brings **subagents** to Cursor. It allows you to delegate complex, multi-step tasks to specialized agents.

[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=subagents&config=eyJjb21tYW5kIjoibnB4IC15IEBkYTF6L3N1YmFnZW50cyAtLWN3ZCAke3dvcmtzcGFjZUZvbGRlcn0ifQ%3D%3D)

## Features

- **Subagents in Cursor**: Enables agentic workflows directly within Cursor.
- **Default Subagents**: Includes two powerful agents inspired by Claude Code:
  - **General Purpose**: For researching complex questions and executing multi-step tasks.
  - **Explore**: Specialized for quickly finding files and understanding codebase architecture.
- **Automatic Discovery**: Automatically detects and uses your existing Claude subagents from `.claude/agents/`.

> [!WARNING]
> Subagents will have access to all available tools. The `cursor-agent` CLI does not currently support configuring available tools, so the `tool` field in Claude subagent Markdown files will be ignored.

## Prerequisites

- **Cursor CLI**: You must have the [Cursor CLI](https://cursor.com/cli) installed.
- **Node.js**: Version 22.0.0 or higher.

## Usage

Add the following to your `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "subagents": {
      "command": "npx -y @da1z/subagents --cwd ${workspaceFolder}"
    }
  }
}
```

_Note: The `--cwd` argument is required._

## Capabilities

This MCP server provides a single tool to the agent:

- **task**: Launches a specialized subagent to handle a complex task. The agent can choose which subagent to use (e.g., "general-purpose", "explore") based on the task requirements.