Worksona

You run a Worksona MCP Server to connect multiple Worksona agents with Claude Desktop, enabling automatic agent discovery, multi-agent coordination, and enterprise-ready AI capabilities. This server orchestrates agent workflows, suggests suitable agents for requests, and provides ready-to-use task templates and quick actions to accelerate development and integration tasks.

How to use

You interact with the MCP server through an MCP client (like Claude Desktop). Start by ensuring the server is running locally or remotely, and that Claude Desktop is configured to load your MCP server. Use the available resources to coordinate complex tasks: select a workflow to run multiple agents in sequence or parallel, attach task templates for rapid prompt construction, or pick an example prompt to see best-practice guidance. When you need immediate results, attach quick actions that route to a focused agent or small team within the MCP system.

Practical usage patterns you can apply right away: - Attach a task template to generate API documentation or code reviews. - Use a multi-agent workflow to build a feature end-to-end, with specialized agents handling frontend, backend, and deployment concerns. - Let the system suggest agents for a given request to optimize coverage and reduce dithering. - Employ memory features to maintain context across agents for long-running projects.

How to install

Prerequisites you need before installation: - Node.js 18+ - Claude Desktop with MCP support.

# Install the MCP server globally
npm install -g worksona-mcp-server

Configure Claude Desktop to load the MCP server by adding a configuration entry for the agent loader. Use the path that points to the locally installed MCP server binary.

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

Restart Claude Desktop to load the MCP server and begin discovering agents and coordinating workflows.

Additional configuration and notes

You can run the MCP server locally and configure Claude Desktop to find it automatically. The server is designed to load 100+ Worksona agents, coordinate them across four patterns (sequential, parallel, review, executive), and provide intelligent agent suggestions, memory management, and enterprise-ready integration.

Environment and troubleshooting notes: ensure the agent directory is accessible and that the server has permission to load agent manifests. If you modify agent configurations, restart the MCP server to reload changes.

Troubleshooting

Server Won't Start: Verify you have Node.js 18+ installed and that the agent directory exists. Check the console for error messages.

Agents Not Loading: Confirm the agent path is accessible and agent metadata is valid. Check file permissions and restart the MCP server if necessary.

Claude Desktop Not Connecting: Double-check the MCP server configuration in Claude Desktop and restart Claude Desktop after changes. Review logs for connection errors.

Development

Building from source is supported if you clone and build locally. Typical workflow involves installing dependencies, building, and starting the server. Use the same structure described for the runtime to ensure compatibility.

Available tools

activate_agent

Activate a single agent with specialized expertise to handle a targeted task.

coordinate_team

Coordinate multiple agents in a structured workflow for complex projects.

suggest_agents

Provide AI-powered recommendations to select the most suitable agents for a given request.

list_agents

Browse available agents by category to understand capabilities and coverage.