Agency Swarm MCP

Agency Swarm MCP is a minimally-different fork of Task Master, maintained by VRSEN. For most users, follow the instructions below.

This is a minimal-difference fork of claude-task-master, maintained by VRSEN.

A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.

For agency-swarm projects, the planning and task breakdown protocol in agency_swarm.mdc always applies. All other rules in .cursor/rules are inherited from Task Master unless otherwise noted.

Requirements

• Anthropic API key (Claude API)
• OpenAI SDK (for Perplexity API integration, optional)

Quick Start

Installation

# Install globally
npm install -g agencyswarm-mcp

# OR install locally within your project
npm install agencyswarm-mcp

Using MCP:

MCP (Model Control Protocol) provides the easiest way to get started with Agency Swarm MCP directly in your editor.

1. Add the MCP config to your editor (Cursor recommended, but it works with other text editors):

{
	"mcpServers": {
		"agency-swarm": {
			"command": "npx",
			"args": ["-y", "agencyswarm-mcp"],
			"env": {
				"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
				"PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
				"MODEL": "claude-3-7-sonnet-20250219",
				"PERPLEXITY_MODEL": "sonar-pro",
				"MAX_TOKENS": "64000",
				"TEMPERATURE": "0.2",
				"DEFAULT_SUBTASKS": "5",
				"DEFAULT_PRIORITY": "medium"
			}
		}
	}
}

2. Enable the MCP in your editor

3. Prompt the AI to initialize Agency Swarm MCP:

Can you please initialize Agency Swarm MCP into my project?

4. Use common commands directly through your AI assistant:

Can you parse my PRD at scripts/prd.txt?
What's the next task I should work on?
Can you help me implement task 3?
Can you help me expand task 4?

Useful Command-Line Commands

# Parse a PRD and generate tasks
task-master parse-prd your-prd.txt

# List all tasks
task-master list

# Show the next task to work on
task-master next

# Generate task files
task-master generate

Why Use Agency Swarm MCP with Cursor?

• Add our MCP to Cursor once, and you get our workflow, rules, and updates automatically—no manual rule copying or setup in every project.
• All AI rules and best practices are bundled and always active when using our MCP.
• Updates to the MCP or rules are delivered centrally—just update the npm package to get improvements.
• Cursor integration is simple: add the JSON config, and you're ready to go.

Documentation

For more detailed information, check out the documentation in the docs directory:

• Configuration Guide - Set up environment variables and customize Agency Swarm MCP
• Tutorial - Step-by-step guide to getting started
• Command Reference - Complete list of all available commands
• Task Structure - Understanding the task format and features
• Example Interactions - Common Cursor AI interaction examples

Publishing to npm

To publish a new version to npm, simply run:

npm publish

This command automatically triggers the prepare-package.js script via the prepublishOnly hook in package.json. The script will:

• Automatically increment the patch version number in package.json.
• Perform checks and ensure scripts are executable.

After the script runs, npm publish will proceed to package and upload the new version to the registry.

For generating CHANGELOG.md entries, refer to the process in RELEASING.md.

Keeping Your Fork Up-to-Date

To keep your fork in sync with upstream changes:

git remote add upstream https://github.com/eyaltoledano/claude-task-master.git
git fetch upstream
git merge upstream/main

Resolve any conflicts, test, and publish a new npm version if needed.

Licensing

Agency Swarm MCP is licensed under the MIT License with Commons Clause. This means you can:

✅ Allowed:

• Use Agency Swarm MCP for any purpose (personal, commercial, academic)
• Modify the code
• Distribute copies
• Create and sell products built using Agency Swarm MCP

❌ Not Allowed:

• Sell Agency Swarm MCP itself
• Offer Agency Swarm MCP as a hosted service
• Create competing products based on Agency Swarm MCP

See the LICENSE file for the complete license text and licensing details for more information.

Upstream: Task Master

This project is based on Task Master. Most users do not need to reference upstream docs unless contributing to core or troubleshooting advanced issues.