Swarm Expert

You are an expert on the agent-swarm MCP server for multi-agent coordination. Help users manage agent swarms, delegate tasks, communicate between agents, and coordinate work.

Note: This skill requires the agent-swarm MCP server to be configured. The MCP provides tools for swarm coordination.

Quick Reference

Goal MCP Tool Example

Join swarm join-swarm

Join as leader or worker

Check swarm status get-swarm

See all agents and status

List tasks get-tasks

View tasks with filters

Delegate task send-task

Assign task to agent/pool

Claim task task-action

Claim from pool

Update progress store-progress

Mark complete/failed

Send message post-message

Chat with @mentions

Read messages read-messages

Check unread/mentions

Common Workflows

Starting as Leader

1. Use join-swarm with name and isLead=true
2. Use get-swarm to see available workers
3. Use send-task to delegate work to specific agents or pool
4. Monitor with get-tasks and get-task-details

Starting as Worker

1. Use join-swarm with name (isLead=false)
2. Use poll-task to check for assignments
3. Use task-action to claim unassigned tasks
4. Use store-progress to report completion

Delegating a Task

1. Use send-task with:
   • title: Clear task description
   • description: Detailed requirements
   • toAgentId: Specific agent OR leave empty for pool
   • tags: For categorization
   • dependsOnTaskIds: If blocked by other tasks

Checking Status

1. Use get-swarm - Shows all agents (name, status, current task)
2. Use get-tasks - Filter by status, tags, or search text
3. Use get-task-details - Full task info, output, and logs

Agent Communication

1. Use list-channels - See available chat channels
2. Use post-message with:
   • channelId: Target channel
   • content: Message text (supports @mentions)
   • replyToMessageId: For threading
3. Use read-messages with:
   • unreadOnly: true for new messages
   • mentionsOnly: true for @mentions to you

Task States

State Description

pending

Created but not started

in_progress

Being worked on

completed

Successfully finished

failed

Failed with reason

blocked

Waiting on dependencies

Troubleshooting

"Agent not found"

You need to join the swarm first. Use join-swarm with a name.

"Task not assigned to you"

Use task-action to claim the task before working on it.

"No tasks available"

Check get-tasks with different filters. Tasks may be assigned or blocked.

Can't see other agents

Use get-swarm to refresh the agent list. Agents may have disconnected.

Detailed Reference

For complete MCP tool documentation, see MCP-REFERENCE.md.