← Back to directory

Agency Orchestrator

Community

One sentence to assemble your AI expert team, deliver complete deliverables in minutes.

GitHub source repository ↗

★ 2.1k Stars Category · Dev Tools Very popular Source revision 80ea7c369356

63FMRS · C

Reliability

10/20

Security and permissions

12/20

Maintenance

16/20

Documentation

15/20

Setup experience

10/20

Agency Orchestrator is feature-rich and suitable for quickly building multi-agent collaboration workflows. Installation and configuration are simple, and the MCP interface facilitates integration. However, attention is needed regarding LLM capabilities and data security risks.

Read the FMRS scoring method →

Agency Orchestrator is an AI agent orchestration engine that defines multi-role collaboration workflows via YAML or natural language, automatically forming professional teams (267 Chinese roles + 184 English roles + 5 other languages), executing in parallel based on DAG, with automatic acceptance verification and human approval. Available via Web Studio, Desktop, Docker, or CLI, supporting 11 LLM providers (7 of which require no API key). Provides MCP Server mode for direct invocation by AI coding tools like Claude Code and Cursor.

Tools

run_workflow

Run a specified workflow with input variables, returning execution results.

validate_workflow

Validate a workflow YAML configuration without executing it.

list_workflows

List available workflow templates.

plan_workflow

View the execution plan (DAG) of a workflow.

compose_workflow

Automatically orchestrate and generate a workflow YAML based on a natural language description.

list_roles

List all available roles.

Setup

Install the CLI globally: npm install -g agency-orchestrator.
Start the MCP server: ao serve.
Configure in Claude Code's settings.json:

{
  "mcpServers": {
    "agency-orchestrator": {
      "command": "npx",
      "args": ["agency-orchestrator", "serve"]
    }
  }
}

Or configure the same in Cursor's .cursor/mcp.json.
Depending on the chosen LLM provider, set up API keys or use already-installed CLIs (e.g., Claude Code, Gemini CLI).

claude_desktop_config.json

{
  "mcpServers": {
    "agency-orchestrator": {
      "command": "npx",
      "args": [
        "agency-orchestrator",
        "serve"
      ]
    }
  }
}

Generate and validate client config

Fit and risk

Best for

Developers and creators who want to use AI multi-agent collaboration for complex tasks (like business planning, technical solutions, content creation).
Teams that prefer no-code YAML workflows over writing Python code.
Users who want to leverage existing AI subscriptions (like Claude, Gemini, Copilot) to reduce costs.

Not for

Deep customization scenarios requiring fine-grained control over each agent's internal logic.
Enterprises with strict data privacy requirements, as some API calls require network access.
Scenarios relying on small local models (e.g., 8B level) for high-quality outputs, as multi-role handoffs may amplify drift.

Required permissions

When executing workflows, it calls configured LLM APIs or local CLIs, requiring network access and API permissions.
It can read/write local file system (e.g., read input files, save outputs to `ao-output/` directory).
The MCP server itself only provides stdio communication and does not actively access external systems.

Risks and side effects

LLM outputs may be inaccurate or hallucinated; acceptance criteria can mitigate but not fully avoid.
When using third-party APIs, ensure API keys are securely stored to prevent leakage.
Workflows with human approval nodes require user intervention, otherwise the flow pauses.

Troubleshooting

Ensure Node.js and npm are correctly installed, and agency-orchestrator is installed globally.
Check the MCP configuration for correct command and arguments, especially the npx path.
If using CLI as the LLM provider, ensure the corresponding CLI is installed and logged in.
Verify the workflow YAML syntax, which can be checked with `ao validate`.
Check terminal output or logs for specific error messages.

Use cases

Invoke workflows directly from your IDE via MCP for code review, requirements analysis, etc.

Describe a task in natural language and let AI automatically orchestrate a multi-role collaboration workflow.

Integrate automated workflows in CI/CD pipelines, such as PR review, security audit, etc.

Supported clients

Claude DesktopFull support

Claude CodeFull support

CursorFull support

Related MCP servers

Compare with other MCP servers