Delegate MCP v3.0 - Complete Reference

Overview

Agentic AI delegation server with Direct Redis access for secure, fast tool execution. Delegates can be spawned in browser applications, web apps, and any client that needs AI-powered task automation with full CRUD access to all Nexus environments.

Architecture

Core Design

• Direct Redis Access: No HTTP endpoints, connects directly to Redis environments
• Credential Management: Passwords loaded from Locker (ID: e1ac29f6) on first tool execution
• Connection Pooling: Lazy-loaded pools per environment for multi-tenancy
• Boot Context: Configuration loaded from /opt/mcp-servers/delegate/boot_context.json

Port Mapping (66XX pattern)

Tool Inventory (32+ Tools)

Contact Tools (Full CRUD)

• contact_create - Create new contact
• contact_get - Get contact by ID
• contact_search - Search by name/company/category
• contact_update - Update contact fields
• contact_delete - Delete contact
• contact_list - List contacts with filters

Track Tools (Full CRUD)

• track_create - Create new project
• track_get - Get project with tasks
• track_list - List all projects
• track_update - Update project fields
• track_delete - Delete project and tasks
• track_add_task - Add task to project
• track_update_task - Update task status/fields
• track_delete_task - Delete task

KB Tools (Full CRUD)

• kb_create - Create KB node (root or child)
• kb_get - Get node by ID or path
• kb_search - Search KB nodes
• kb_tree - Get tree structure
• kb_roots - List root nodes
• kb_update - Update node content
• kb_delete - Delete node (no children)
• kb_move - Move to new parent
• kb_children - Get child nodes
• kb_breadcrumb - Get path breadcrumb

Document Tools

• document_get - Get document by ID
• document_list - List with category filter
• document_search - Search documents

Transcript Tools

• transcript_get - Get transcript by ID
• transcript_list - List with category filter
• transcript_search - Search transcripts

Locker Tools (Read-only)

• locker_list - List lockers (no secrets)
• locker_search - Search lockers (no secrets)

Context Tools

• context_summary_state - Save summary state
• context_learn - Store quick knowledge
• context_recall - Retrieve knowledge

Voice Tools

• voice_speak_quick - Short notification (250 chars)
• voice_speak_summary - Longer summary (1500 chars)

Orchestration Tools

• spawn_delegate - Spawn sub-delegate
• check_delegate - Check sub-delegate status
• spawn_mission - Spawn parallel workers

File Locations

Locker Credentials

Credentials stored in Locker ID e1ac29f6 (delegate_environment_keys): - 12 environment passwords - Loaded once on first tool execution - Never hardcoded in server code

Version History

v3.0.0 (2025-12-07)

• Added full CRUD for Contact, Track, KB
• Added Document/Transcript read tools
• Added Locker read-only tools
• Direct Redis access (no HTTP)
• Connection pooling
• 32+ tools total

v2.0.0 (2025-12-04)

• Agentic tool discovery loop
• Working memory system
• Orchestration (parallel workers)
• Self-orchestration (delegates spawn delegates)

v1.1.0

• Basic delegation
• Voice notifications

Use Cases

1. Client Applications: "Update my contact for John - his number changed"
2. Project Management: "Create a new project and add these tasks"
3. Knowledge Management: "Save this information to the KB under Nexus > Guides"
4. Research: "Search documents and transcripts for information about X"
5. Parallel Processing: Spawn multiple workers for complex multi-part tasks

Security Notes

• Locker tools are read-only (no reveal of secrets)
• Credentials loaded from Locker, not hardcoded
• Connection pooling prevents credential exposure
• Audit logging enabled