title: Delegation MCP emoji: 🚀 colorFrom: blue colorTo: purple sdk: docker pinned: false license: mit short_description: Intelligent Multi-Agent Routing & Guidance tags:

• mcp-server

• building-mcp-track-enterprise

• multi-agent

• agent-orchestration

🚀 Delegation MCP Server

Intelligent Multi-Agent Routing & Guidance

Built for the MCP 1st Birthday Hackathon - Winter 2025

⚡ Quick Start

That's it! Restart Claude Code and start delegating:

Features:

• ✅ One-command installation - 30 seconds to full setup

• ✅ Intelligent Routing - Rules + Capabilities analysis

• ✅ Privacy-First - Your code never passes through this server

• ✅ Lightweight - Minimal footprint, no heavy databases

• ✅ Cross-platform - Windows, Mac, Linux

🎮 Try the Interactive Demo

Experience the routing intelligence in action! Our HF Space demo lets you:

Interactive Features:

• 🧪 Test Any Query - See routing decisions in real-time

• 📊 Routing Transparency - View the complete decision-making process:

  • Task classification (security, architecture, refactoring, etc.)

  • Complexity assessment (simple/medium/complex)

  • Detected keywords and routing reasoning

  • CLI command that would be executed

• ⚙️ Live Configuration - Toggle agents and routing strategies to see how settings affect decisions

• 💡 Example Queries - Simple and complex multi-step scenarios

Try This:

1. Visit the HF Space

2. Enter: "Audit the authentication system for SQL injection, XSS, and CSRF vulnerabilities"

3. Watch it route to Gemini with full reasoning

4. Disable Gemini in settings → See it route to Claude instead!

Want to test with real agents? Duplicate the Space and add your API keys!

🌟 What Is This?

A lightweight MCP server that acts as a routing intelligence layer for AI coding agents. Instead of executing tasks itself (which creates a bottleneck and security risk), it analyzes your request and guides your main agent (like Claude Code) on which tool to use.

Key Insight: This follows the Routing Guidance pattern:

1. Analyze: The server analyzes the prompt (e.g., "audit security").

2. Route: It determines the best agent based on your presets and rules.

3. Guide: It returns the exact command to run.

4. Execute: The client (Claude) executes the command directly.

This ensures zero lock-in, maximum privacy, and native performance.

🎯 The Core Value Proposition

Problem

Developers manually switch between AI agents, losing context and productivity:

• Claude for architecture

• Gemini for security analysis

• Aider for git operations

• Copilot for GitHub integration

Solution

One MCP server that tells your agent who to call:

You work with ONE agent, but get the power of ALL agents.

📦 Installation

Prerequisites

• Python 3.10+

• At least one AI agent CLI installed:

  • Gemini CLI: npm install -g @google/gemini-cli

  • Aider: pip install aider-chat

  • Claude Code: npm install -g @anthropic-ai/claude-code

  • GitHub Copilot: npm install -g github/copilot

Automated Installation (Recommended)

The installer will:

1. Check system requirements

2. Discover installed agents

3. Configure Claude Code automatically

4. Verify everything works

Restart Claude Code and you're ready!

🎯 How It Works

Intelligent Routing Guidance

We use a hybrid approach to determine the best agent for the job:

1. Rule-Based Presets: Your configured rules take priority (e.g., "Always use Gemini for security").

2. Capability Analysis: If no rule matches, we analyze agent capabilities to find the best fit.

Query: "scan for vulnerabilities"

1. Check Rules: Matches security_audit preset? -> Gemini

2. Guide: Return guidance to use Gemini

Example Interaction

User: "Audit my authentication code for SQL injection"

Claude Code calls get_routing_guidance:

MCP Server responds:

Claude Code then executes:

🔧 MCP Tools

get_routing_guidance

Get routing guidance for a task. Returns which agent should handle it and the exact CLI command to run.

discover_agents

Automatically discover available CLI agents on the system and register them.

list_agents

List all registered agents and their availability status.

⚡ Token Overhead

One of the key advantages of this MCP server is its minimal context footprint. Here's the actual token usage:

What this means:

• ✅ Less than 1% of your context budget

• ✅ Leaves 99%+ for actual code and conversation

• ✅ No heavy prompts or bloated instructions

• ✅ Intelligent routing without sacrificing context

Compare this to running multiple agent instances or complex orchestration frameworks that can consume 10-20% of your context just for coordination overhead.

🏗️ Architecture

v0.4.0 - Lightweight Architecture

Privacy & Security:

• No Code Execution: The server never executes code or commands. It only suggests them.

• No Data Persistence: No databases or logs of your code are kept by the server.

• Direct Connection: Your agent talks directly to the delegated tool (e.g., Claude -> Gemini).

Agent Auto-Discovery:

• Automatically detects installed CLI agents (Claude, Gemini, Aider, etc.)

• Verifies agent availability

• Graceful error handling

🗂️ Project Structure

🚀 Roadmap

✅ Phase 1: Foundation (COMPLETE)

• MCP server with routing guidance

• Capability-based routing

• Agent auto-discovery

• Production-grade architecture

🔜 Phase 2: Intelligence (Q1 2026)

• ML-powered routing

• Learning from user feedback

• Custom agent definitions

🔮 Phase 3: Collaboration (Q2 2026)

• Complex multi-step workflows

• Parallel agent execution guidance

🤝 Contributing

We welcome contributions! Add new agent adapters, improve routing logic, or enhance documentation.

📄 License

MIT License - see LICENSE

🎯 The Vision

"You work with ONE agent, but get the power of ALL agents."

Today's AI landscape has amazing specialists, but they work in silos. Delegation MCP changes that. It's the intelligence layer that lets agents collaborate, creating something greater than the sum of its parts.

Built with ❤️ for the MCP ecosystem