# Accordo

> An MCP (Model Context Protocol) server that provides structured workflow guidance to guide coding agents through a disciplined development process.

- **Type:** MCP server
- **Install:** `agentstack add mcp-andurilcode-accordo`
- **Verified:** Pending review
- **Seller:** [AndurilCode](https://agentstack.voostack.com/s/andurilcode)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [AndurilCode](https://github.com/AndurilCode)
- **Source:** https://github.com/AndurilCode/accordo
- **Website:** https://medium.com/@gabry.pavanello

## Install

```sh
agentstack add mcp-andurilcode-accordo
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Accordo MCP Server

[](https://sonarcloud.io/summary/new_code?id=AndurilCode_accordo)

A powerful MCP (Model Context Protocol) server that provides **dynamic YAML-driven workflow guidance** for AI coding agents. Features structured development workflows with progression control and decision points.

## What This Does

This server guides AI agents through structured, schema-driven development workflows:
- **📋 Dynamic YAML Workflows**: Custom workflows defined in YAML with schema-driven execution
- **🔍 Discovery-First**: Automatically discovers and selects appropriate workflows based on task
- **⚡ Real-time State**: Live workflow state tracking with comprehensive session management
- **🎯 Mandatory Guidance**: Authoritative phase-by-phase instructions agents must follow
- **🤖 Agent-Generated Workflows**: Unique capability for agents to create custom YAML workflows on-the-fly

### Two Workflow Approaches

### Built-in Workflow Discovery Process

1. **Automatic Discovery** - System scans `.accordo/workflows/` for available YAML workflows
2. **Intelligent Matching** - Analyzes task description against workflow capabilities and goals
3. **Workflow Selection** - Agent chooses the most appropriate workflow from discovered options
4. **Immediate Execution** - Selected workflow starts with full state management and progression control

This provides **instant access** to proven workflows for common development patterns - coding, documentation, debugging, and more!

### Agent Workflow Generation Process

1. **Analyze Task Requirements** - Agent understands specific needs
2. **Get Creation Guidance** - Comprehensive templates and best practices provided
3. **Generate Custom YAML** - Agent creates workflow tailored to exact requirements
4. **Start Execution** - Custom workflow runs with full state management

This enables agents to create workflows for **any domain** - web development, data science, DevOps, research, documentation, testing, and more!

## Quick Start

### Installing **accordo CLI**

The accordo CLI provides easy configuration and management of MCP servers. Install it directly with:

```bash
# Download and run the installation script
curl -fsSL https://raw.githubusercontent.com/AndurilCode/accordo/refs/heads/main/install.sh | bash
```

The installer will:
- ✅ Detect your environment (virtual env, available tools)
- 🌍 **Global installation (recommended)**: Uses pipx for system-wide access
- 📦 **Virtual environment**: Uses uv or pip if you're in a venv
- 🔧 **Auto-setup**: Handles dependencies and PATH configuration

#### CLI Usage

```bash
# Configure MCP servers interactively
accordo configure

# Quick setup for specific platforms
accordo configure -p cursor -y
accordo configure -p claude-code -y

# Deploy workflow guidelines to AI assistants
accordo bootstrap-rules              # All assistants
accordo bootstrap-rules cursor       # Cursor only
accordo bootstrap-rules --force all  # Overwrite existing

# List supported platforms and manage servers
accordo list-platforms
accordo list-servers -p cursor
accordo validate -p cursor

# Get help
accordo --help
```

### Manual MCP Configuration

Alternatively, install [uv](https://docs.astral.sh/uv/) for Python package management and configure your MCP client manually:
**For Cursor** (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "accordo": {
      "command": "uvx",
      "args": ["accordo-workflow-mcp"]
    }
  }
}
```

Or use the following link to install the MCP server (Cursor Installed):

[](https://cursor.com/install-mcp?name=accordo&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBnaXQraHR0cHM6Ly9naXRodWIuY29tL0FuZHVyaWxDb2RlL2FjY29yZG9AbWFpbiBhY2NvcmRvLW1jcCJ9)

## Getting Help

### 📚 Documentation
- **[Complete Documentation](docs/)** - Comprehensive guides and references
- **[Installation Prerequisites](docs/installation/prerequisites.md)** - Detailed setup requirements

### 🎯 Examples
- **[Workflow Examples](examples/workflows/)** - Ready-to-use workflow YAML files
- **[Configuration Examples](examples/configurations/)** - MCP client setup examples

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [AndurilCode](https://github.com/AndurilCode)
- **Source:** [AndurilCode/accordo](https://github.com/AndurilCode/accordo)
- **License:** MIT
- **Homepage:** https://medium.com/@gabry.pavanello

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-andurilcode-accordo
- Seller: https://agentstack.voostack.com/s/andurilcode
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.