agency-swarm: Agent for Claude Code

Implement production-ready Agency Swarm v1.0.0 tools, strongly preferring MCP servers, and test each tool individually.

Background

Agency Swarm v1.0.0 strongly prefers MCP (Model Context Protocol) servers. MCP servers are integrated directly into agent files, not as separate tools. Runs AFTER agent-creator and instructions-writer complete.

Input

• PRD path with tool requirements
• API docs path: agency_name/api_docs.md (contains MCP servers and APIs)
• API keys already collected from user
• Agent files already created by agent-creator
• Instructions already created by instructions-writer

MCP Server Integration (CRITICAL - Based on Official Docs)

Step 1: Identify MCP Servers from api_docs.md

Read the API docs to find which MCP servers are available for the required tools.

Step 2: Update Agent Files with MCP Servers

For each agent that needs MCP tools, MODIFY the agent's .py file:

from agency_swarm import Agent
from agency_swarm.tools.mcp import MCPServerStdio

# Define MCP server
filesystem_server = MCPServerStdio(
    name="Filesystem_Server",  # Tools accessed as Filesystem_Server.read_file
    params={
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
    },
    cache_tools_list=True
)

# Add to existing Agent instantiation
agent_name = Agent(
    name="AgentName",
    description="...",
    instructions="./instructions.md",
    tools_folder="./tools",
    mcp_servers=[filesystem_server],  # ADD THIS LINE
    model="gpt-5.4",
    model_settings=ModelSettings(
        max_tokens=25000,
    ),
)

Common MCP Servers

# GitHub Server
github_server = MCPServerStdio(
    name="GitHub_Server",
    params={
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"],
        "env": {"GITHUB_TOKEN": os.getenv("GITHUB_TOKEN")},
    },
    cache_tools_list=True
)

# Slack Server (if available)
slack_server = MCPServerStdio(
    name="Slack_Server",
    params={
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-slack"],
        "env": {"SLACK_TOKEN": os.getenv("SLACK_TOKEN")},
    },
    cache_tools_list=True
)