Skip to main content
Glama

Worksona MCP Server

Official
by worksona

Worksona MCP Server

A comprehensive MCP (Model Context Protocol) server that integrates all Worksona agents with Claude Desktop, providing automated agent discovery, multi-agent coordination, and enterprise-level AI capabilities.

šŸŽÆ Features

  • Actionable Resources: Ready-to-use task templates, workflows, examples, and quick actions

  • Automatic Agent Discovery: Loads 100+ Worksona agents from the repository automatically

  • Multi-Agent Coordination: Four coordination patterns (sequential, parallel, review, executive)

  • Intelligent Agent Suggestions: AI-powered agent matching for requests

  • Task Templates: Pre-configured prompts for common development tasks

  • Workflow Orchestration: Multi-agent workflows for complex projects

  • Example Prompts: Real-world scenarios with detailed implementation guides

  • Quick Actions: Fast solutions for immediate needs

  • Memory Management: Persistent context and cross-agent memory

  • Enterprise Integration: Full tool access and production-ready architecture

šŸš€ Quick Start

Prerequisites

  • Node.js 18+

  • Claude Desktop with MCP support

Installation

  1. Install the MCP server globally:

    npm install -g worksona-mcp-server
  2. Configure Claude Desktop: Add to ~/.claude-desktop/config.json (macOS) or %APPDATA%/Claude/config.json (Windows):

    { "mcpServers": { "worksona-agents": { "command": "/usr/local/bin/worksona-mcp-server" } } }

    Note: No API key needed! The MCP server automatically detects it's running inside Claude Desktop and uses Claude's built-in AI processing.

  3. Restart Claude Desktop to load the MCP server

šŸŽ® Usage Examples

Attach Task Templates

Instead of writing prompts from scratch, attach task template resources for instant, professional prompts:

  1. Browse Resources in Claude Desktop's attachment panel

  2. Attach "šŸ“š API Documentation" task template

  3. Customize the provided prompt with your API details

  4. Submit - Claude automatically activates the doc-writer agent

Attach Workflow Resources

For complex projects, attach workflow resources that coordinate multiple agents:

  1. Attach "šŸš€ Full-Stack Application" workflow

  2. Customize the workflow prompt with your project requirements

  3. Submit - Claude automatically uses coordinate_team with 4 specialists

Attach Example Prompts

Get detailed guidance for common scenarios:

  1. Attach "šŸ’” Startup MVP Development" example

  2. Follow the comprehensive prompt template

  3. Get coordinated help from product, technical, and marketing specialists

Attach Quick Actions

For immediate needs:

  1. Attach "šŸ› Quick Bug Fix" action

  2. Fill in the bug details

  3. Get rapid debugging from the error-detective agent

Traditional Tool Usage

You can still use tools directly:

I need to create API documentation for my REST service

Claude will use the activate_agent tool with doc-writer automatically.

Research Workflows

Research the competitive landscape for AI coding assistants

Claude will use the research_workflow tool to deploy a team of research specialists.

šŸ“Ž Attachable Resources

The MCP server provides 21 actionable resources organized into 4 categories:

šŸŽÆ Task Templates (6 resources)

Ready-to-use prompts for common development tasks:

  • šŸ“š API Documentation - Comprehensive API docs with examples

  • šŸ” Code Review - Security, performance, and best practices analysis

  • ⚔ Database Optimization - Query and schema optimization

  • šŸ”’ Security Audit - Vulnerability assessment and compliance

  • šŸŽØ Frontend Component - Modern React/Vue components with TypeScript

  • šŸ”§ Backend API - Scalable REST/GraphQL API design

šŸ”„ Workflows (5 resources)

Multi-agent coordination for complex projects:

  • šŸš€ Full-Stack Application - Complete app development pipeline

  • šŸ›”ļø Security Review Workflow - Multi-stage security assessment

  • ⚔ Performance Optimization - Systematic performance improvement

  • šŸ“Š Market Research - Comprehensive market analysis

  • šŸ”„ DevOps Pipeline - End-to-end CI/CD setup

šŸ’” Example Prompts (5 resources)

Real-world scenarios with detailed guidance:

  • šŸ’” Startup MVP Development - From idea to launch

  • šŸ”„ Legacy System Modernization - Migration strategies

  • šŸ¤– AI Feature Integration - Adding AI to existing apps

  • šŸ“± Mobile App Development - Cross-platform mobile apps

  • šŸ“ˆ Data Pipeline & Analytics - Data processing systems

⚔ Quick Actions (5 resources)

Fast solutions for immediate needs:

  • šŸ› Quick Bug Fix - Rapid debugging (15-30 min)

  • ⚔ Performance Check - Fast performance analysis (20-45 min)

  • šŸ” Security Scan - Quick vulnerability assessment (25-40 min)

  • šŸ“– Code Explanation - Understand existing code (15-25 min)

  • šŸ¤” Technology Decision - Expert tech advice (20-35 min)

šŸ”§ Available MCP Tools

Tool

Description

Use Case

activate_agent

Activate a single agent with expertise

Specific tasks requiring domain expertise

coordinate_team

Coordinate multiple agents

Complex multi-faceted projects

suggest_agents

Get AI-powered agent recommendations

When unsure which agent to use

list_agents

Browse available agents by category

Discovering capabilities

šŸ“ Architecture

src/ ā”œā”€ā”€ agents/ # Agent system core │ ā”œā”€ā”€ types.ts # Type definitions │ ā”œā”€ā”€ registry.ts # Agent discovery and management │ └── executor.ts # Agent execution engine ā”œā”€ā”€ orchestration/ # Multi-agent coordination │ ā”œā”€ā”€ coordinator.ts # Workflow orchestration │ └── memory.ts # Cross-agent memory ā”œā”€ā”€ utils/ # Utilities │ ā”œā”€ā”€ context.ts # Project context management │ └── logger.ts # Structured logging └── index.ts # Main MCP server

šŸ” Troubleshooting

Server Won't Start

  • Check Node.js version (18+ required)

  • Verify agents directory exists

  • Check console for error messages

Agents Not Loading

  • Ensure WORKSONA_AGENTS_PATH environment variable is set (if using custom path)

  • Verify agent metadata.json files are valid

  • Check file permissions

Claude Desktop Not Connecting

  • Verify MCP server configuration in Claude Desktop

  • Restart Claude Desktop after configuration changes

  • Check Claude Desktop logs for connection errors

šŸ› ļø Development

Building from Source

npm install npm run build npm start

Environment Variables

  • WORKSONA_AGENTS_PATH: Path to agents directory (optional, defaults to bundled agents)

  • NODE_ENV: Environment (development/production)

  • LOG_LEVEL: Logging level (debug/info/warn/error)

Adding Custom Agents

  1. Place agent files in agents directory structure

  2. Follow the standard agent format (metadata.json + agent.md)

  3. Restart the MCP server to reload agents

šŸ“Š Performance

  • Agent Discovery: ~2-3 seconds for 100+ agents

  • Single Agent Execution: ~500-2000ms average

  • Multi-Agent Coordination: ~2-10 seconds depending on complexity

  • Memory Usage: ~50-100MB typical operation

šŸ”’ Security

  • Agent prompts are executed in isolated contexts

  • No direct file system access outside designated paths

  • Memory is automatically cleaned to prevent data leaks

  • All inputs are validated before processing

šŸ“ License

MIT License - see LICENSE file for details.

šŸ¤ Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Run tests: npm test

  5. Submit a pull request

šŸ“ž Support

  • Check the troubleshooting section above

  • Review Claude Desktop MCP documentation

  • Open an issue for bugs or feature requests

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Integrates 100+ specialized AI agents with Claude Desktop, providing automated agent discovery, multi-agent coordination, and ready-to-use task templates for complex development and business workflows. Enables users to leverage enterprise-level AI capabilities through actionable resources and intelligent agent matching.

  1. šŸŽÆ Features
    1. šŸš€ Quick Start
      1. Prerequisites
      2. Installation
    2. šŸŽ® Usage Examples
      1. Attach Task Templates
      2. Attach Workflow Resources
      3. Attach Example Prompts
      4. Attach Quick Actions
      5. Traditional Tool Usage
      6. Research Workflows
    3. šŸ“Ž Attachable Resources
      1. šŸŽÆ Task Templates (6 resources)
      2. šŸ”„ Workflows (5 resources)
      3. šŸ’” Example Prompts (5 resources)
      4. ⚔ Quick Actions (5 resources)
    4. šŸ”§ Available MCP Tools
      1. šŸ“ Architecture
        1. šŸ” Troubleshooting
          1. Server Won't Start
          2. Agents Not Loading
          3. Claude Desktop Not Connecting
        2. šŸ› ļø Development
          1. Building from Source
          2. Environment Variables
          3. Adding Custom Agents
        3. šŸ“Š Performance
          1. šŸ”’ Security
            1. šŸ“ License
              1. šŸ¤ Contributing
                1. šŸ“ž Support

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/worksona/-worksona-mcp-server'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server