massgen 0.1.0a3__py3-none-any.whl → 0.1.1__py3-none-any.whl

massgen/configs/tools/custom_tools/claude_code_wrong_custom_tool_with_mcp_example.yaml

@@ -0,0 +1,38 @@
+# MassGen Configuration: Claude Code with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/claude_code_wrong_custom_tool_with_mcp_example "whats the sum of 123 and 456? and whats the weather of Tokyo?"
+orchestrator:
+  snapshot_storage: "claude_code_snapshots"
+  agent_temporary_workspace: "claude_code_temp"
+
+agents:
+  - id: "claude_code_custom_tool" # Claude Code with wrong custom tool and MCP
+    backend:
+      type: "claude_code"
+      model: "claude-sonnet-4-20250514"
+      cwd: "claude_code_workspace"
+      custom_tools:
+        - name: ["two_num_tool"]
+          function: ["wrong_two_num_tool"]
+      mcp_servers:
+        - name: "weather"
+          type: "stdio"
+          command: "npx"
+          args: ["-y", "@fak111/weather-mcp"]
+    append_system_prompt: |
+      You are an AI assistant with access to a custom math calculation tool and a weather information MCP tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+
+      Weather tools are available via MCP sessions and will be called automatically by the system when needed.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about weather conditions, forecasts, or alerts, include the location and time frame in your
+      response and provide concise, up-to-date information using the integrated tools.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/claude_custom_tool_example.yaml

@@ -0,0 +1,24 @@
+# MassGen Configuration: Gemini with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/claude_custom_tool_example "whats the sum of 123 and 456?"
+agents:
+  - id: "claude_custom_tool" # Anthropic Claude
+    backend:
+      type: "claude"
+      model: "claude-sonnet-4-20250514"  # Model name
+      custom_tools:
+        - name: "two_num_tool"
+          category: "math"
+          path: "massgen/tool/_basic/_two_num_tool.py"
+          function: "two_num_tool"
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/claude_custom_tool_example_no_path.yaml

@@ -0,0 +1,22 @@
+# MassGen Configuration: Claude with Custom Tool (No Path)
+# Usage:
+#   massgen --config @examples/tools/custom_tools/claude_custom_tool_example_no_path "whats the sum of 123 and 456?"
+agents:
+  - id: "claude_custom_tool" # Anthropic Claude
+    backend:
+      type: "claude"
+      model: "claude-sonnet-4-20250514"
+      custom_tools:
+        - name: "two_num_tool"
+          function: "two_num_tool"
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/claude_custom_tool_with_mcp_example.yaml

@@ -0,0 +1,35 @@
+# MassGen Configuration: Claude with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/claude_custom_tool_with_mcp_example "whats the sum of 123 and 456? and whats the weather of Tokyo?"
+agents:
+  - id: "claude_custom_tool" # Anthropic Claude
+    backend:
+      type: "claude"
+      model: "claude-sonnet-4-20250514"
+      custom_tools:
+        - name: "two_num_tool"
+          category: "math"
+          path: "massgen/tool/_basic/_two_num_tool.py"
+          function: "two_num_tool"
+      mcp_servers:
+        - name: "weather"
+          type: "stdio"
+          command: "npx"
+          args: ["-y", "@fak111/weather-mcp"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool and a weather information MCP tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+
+      Weather tools are available via MCP sessions and will be called automatically by the system when needed.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about weather conditions, forecasts, or alerts, include the location and time frame in your
+      response and provide concise, up-to-date information using the integrated tools.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/claude_custom_tool_with_wrong_mcp_example.yaml

@@ -0,0 +1,33 @@
+# MassGen Configuration: Claude with Wrong MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/claude_custom_tool_with_wrong_mcp_example "whats the sum of 123 and 456? and whats the weather of Tokyo?"
+agents:
+  - id: "claude_custom_tool" # Anthropic Claude
+    backend:
+      type: "claude"
+      model: "claude-sonnet-4-20250514"
+      custom_tools:
+        - name: "two_num_tool"
+          function: "two_num_tool"
+      mcp_servers:
+        - name: "weather"
+          type: "stdio"
+          command: "python"
+          args: ["-u", "-m", "aaa.bbb"]  # Wrong MCP command to demonstrate error handling
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool and a weather information MCP tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+
+      Weather tools are available via MCP sessions and will be called automatically by the system when needed.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about weather conditions, forecasts, or alerts, include the location and time frame in your
+      response and provide concise, up-to-date information using the integrated tools.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/claude_wrong_custom_tool_with_mcp_example.yaml

@@ -0,0 +1,33 @@
+# MassGen Configuration: Claude with Wrong Custom Tool and MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/claude_wrong_custom_tool_with_mcp_example "whats the sum of 123 and 456? and whats the weather of Tokyo?"
+agents:
+  - id: "claude_custom_tool" # Anthropic Claude
+    backend:
+      type: "claude"
+      model: "claude-sonnet-4-20250514"
+      custom_tools:
+        - name: "two_num_tool"
+          function: "wrong_two_num_tool"
+      mcp_servers:
+        - name: "weather"
+          type: "stdio"
+          command: "npx"
+          args: ["-y", "@fak111/weather-mcp"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool and a weather information MCP tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+
+      Weather tools are available via MCP sessions and will be called automatically by the system when needed.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about weather conditions, forecasts, or alerts, include the location and time frame in your
+      response and provide concise, up-to-date information using the integrated tools.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/gemini_custom_tool_example.yaml

@@ -0,0 +1,24 @@
+# MassGen Configuration: Gemini with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gemini_custom_tool_example "whats the sum of 123 and 456?"
+agents:
+  - id: "gemini2.5flash_custom_tool" # Google Gemini 2.5 Flash
+    backend:
+      type: "gemini"
+      model: "gemini-2.5-flash"
+      custom_tools:
+        - name: ["two_num_tool"]
+          category: "math"
+          path: "massgen/tool/_basic/_two_num_tool.py"
+          function: ["two_num_tool"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+ui:
+  display_type: "rich_terminal"
+  logging_enabled: true

massgen/configs/tools/custom_tools/gemini_custom_tool_example_no_path.yaml

@@ -0,0 +1,22 @@
+# MassGen Configuration: Gemini with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gemini_custom_tool_example_no_path "whats the sum of 123 and 456?"
+agents:
+  - id: "gemini2.5flash_custom_tool" # Google Gemini 2.5 Flash
+    backend:
+      type: "gemini"
+      model: "gemini-2.5-flash"
+      custom_tools:
+        - name: ["two_num_tool"]
+          function: ["two_num_tool"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/gemini_custom_tool_with_mcp_example.yaml

@@ -0,0 +1,35 @@
+# MassGen Configuration: Gemini with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gemini_custom_tool_with_mcp_example "whats the sum of 123 and 456? and whats the weather of Tokyo?"
+agents:
+  - id: "gemini2.5flash_custom_tool" # Google Gemini 2.5 Flash
+    backend:
+      type: "gemini"
+      model: "gemini-2.5-flash"
+      custom_tools:
+        - name: ["two_num_tool"]
+          category: "math"
+          path: "massgen/tool/_basic/_two_num_tool.py"
+          function: ["two_num_tool"]
+      mcp_servers:
+        - name: "weather"
+          type: "stdio"
+          command: "npx"
+          args: ["-y", "@fak111/weather-mcp"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool and a weather information MCP tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+
+      Weather tools are available via MCP sessions and will be called automatically by the system when needed.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about weather conditions, forecasts, or alerts, include the location and time frame in your
+      response and provide concise, up-to-date information using the integrated tools.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/gemini_custom_tool_with_wrong_mcp_example.yaml

@@ -0,0 +1,33 @@
+# MassGen Configuration: Gemini with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gemini_custom_tool_with_wrong_mcp_example "whats the sum of 123 and 456? and whats the weather of Tokyo?"
+agents:
+  - id: "gemini2.5flash_custom_tool" # Google Gemini 2.5 Flash
+    backend:
+      type: "gemini"
+      model: "gemini-2.5-flash"
+      custom_tools:
+        - name: ["two_num_tool"]
+          function: ["two_num_tool"]
+      mcp_servers:
+        - name: "weather"
+          type: "stdio"
+          command: "python"
+          args: ["-u", "-m", "aaa.bbb"]  # Wrong MCP command to demonstrate error handling
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool and a weather information MCP tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+
+      Weather tools are available via MCP sessions and will be called automatically by the system when needed.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about weather conditions, forecasts, or alerts, include the location and time frame in your
+      response and provide concise, up-to-date information using the integrated tools.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/gemini_wrong_custom_tool_with_mcp_example.yaml

@@ -0,0 +1,33 @@
+# MassGen Configuration: Gemini with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gemini_wrong_custom_tool_with_mcp_example "whats the sum of 123 and 456? and whats the weather of Tokyo?"
+agents:
+  - id: "gemini2.5flash_custom_tool" # Google Gemini 2.5 Flash
+    backend:
+      type: "gemini"
+      model: "gemini-2.5-flash"
+      custom_tools:
+        - name: ["two_num_tool"]
+          function: ["wrong_two_num_tool"]
+      mcp_servers:
+        - name: "weather"
+          type: "stdio"
+          command: "npx"
+          args: ["-y", "@fak111/weather-mcp"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool and a weather information MCP tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+
+      Weather tools are available via MCP sessions and will be called automatically by the system when needed.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about weather conditions, forecasts, or alerts, include the location and time frame in your
+      response and provide concise, up-to-date information using the integrated tools.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/github_issue_market_analysis.yaml

@@ -0,0 +1,94 @@
+# Example Configuration: GitHub Issue Market Analysis for Self-Evolution
+#
+# Use Case: Demonstrate Self-Evolution (Market Analysis) using custom tools
+#
+# This configuration showcases how MassGen agents can autonomously analyze
+# GitHub issues AND broader market trends to prioritize features and drive
+# market-driven development using access to the current MassGen code, custom tools + web search.
+#
+# Run with:
+#   uv run massgen --config massgen/configs/tools/custom_tools/github_issue_market_analysis.yaml "Analyze the massgen dir and MassGen GitHub issues to understand what features users are requesting. Also research current trends in multi-agent AI systems and LLM orchestration. Based on the existing code, the open issues and market trends, write a prioritized recommendation report for the next release."
+
+agents:
+  - id: "agent_a"
+    backend:
+      type: "gemini"
+      model: "gemini-2.5-pro"
+      cwd: "workspace1"
+
+      # Custom GitHub issue analyzer tool
+      custom_tools:
+        - name: ["fetch_github_issues"]
+          category: "market_analysis"
+          path: "massgen/tool/_self_evolution/_github_issue_analyzer.py"
+          function: ["fetch_github_issues"]
+          description: ["Fetch and analyze GitHub issues for market-driven feature prioritization"]
+
+      # Enable web search for market research
+      enable_web_search: true
+
+  - id: "agent_b"
+    backend:
+      type: "openai"
+      model: "gpt-5-mini"
+      cwd: "workspace2"
+
+      text:
+        verbosity: "medium"
+      reasoning:
+        effort: "low"
+        summary: "auto"
+
+      # Same custom tool
+      custom_tools:
+        - name: ["fetch_github_issues"]
+          category: "market_analysis"
+          path: "massgen/tool/_self_evolution/_github_issue_analyzer.py"
+          function: ["fetch_github_issues"]
+
+      # Enable web search for market research
+      enable_web_search: true
+
+# Orchestrator configuration
+orchestrator:
+  snapshot_storage: "snapshots"
+  agent_temporary_workspace: "temp_workspaces"
+  context_paths:
+    - path: "massgen"
+      permission: "read"
+  # Adjust these settings to control collaboration behavior
+  # voting_sensitivity: Controls how critical agents are when voting
+  #   - "lenient": Agents vote for answers more readily (default)
+  #   - "balanced": Moderate voting threshold
+  #   - "strict": Agents are more critical, vote only for excellent answers
+  voting_sensitivity: "balanced"
+
+  # answer_novelty_requirement: How different new answers must be
+  #   - "lenient": Allow similar answers with minor variations (default)
+  #   - "balanced": Require moderate differences
+  #   - "strict": Require substantial novelty
+  answer_novelty_requirement: "lenient"
+
+  # max_new_answers_per_agent: Limit how many answers each agent can provide
+  # Uncomment to enable (useful for faster convergence)
+  max_new_answers_per_agent: 5
+
+  # coordination_config: Advanced coordination settings
+  # coordination_config:
+  #   enable_planning_mode: false  # If true, agents plan without executing during coordination
+
+ui:
+  display_type: "rich_terminal"
+  logging_enabled: true
+
+# What happens:
+# 1. Both agents have access to:
+#    - Custom fetch_github_issues tool (analyzes user requests)
+#    - Web search (researches market trends and competitors)
+# 2. User asks agents to combine GitHub issues + market research
+# 3. Agents independently:
+#    - Fetch and analyze GitHub issues using custom tool
+#    - Research market trends using web search
+#    - Synthesize both sources into recommendations
+# 4. Agents collaborate through voting to reach consensus
+# 5. Final answer provides data-driven feature prioritization report

massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_example.yaml

@@ -0,0 +1,24 @@
+# MassGen Configuration: Gemini with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gpt5_nano_custom_tool_example "whats the sum of 123 and 456?"
+agents:
+  - id: "gpt5_nano_custom_tool" # OpenAI GPT-5 Nano
+    backend:
+      type: "openai"
+      model: "gpt-5-nano"
+      custom_tools:
+        - name: ["two_num_tool"]
+          category: "math"
+          path: "massgen/tool/_basic/_two_num_tool.py"
+          function: ["two_num_tool"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_example_no_path.yaml

@@ -0,0 +1,22 @@
+# MassGen Configuration: GPT-5 Nano with Custom Tool (No Path)
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gpt5_nano_custom_tool_example_no_path "whats the sum of 123 and 456?"
+agents:
+  - id: "gpt5_nano_custom_tool" # OpenAI GPT-5 Nano
+    backend:
+      type: "openai"
+      model: "gpt-5-nano"
+      custom_tools:
+        - name: ["two_num_tool"]
+          function: ["two_num_tool"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_with_mcp_example.yaml

@@ -0,0 +1,35 @@
+# MassGen Configuration: GPT-5 Nano with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gpt5_nano_custom_tool_with_mcp_example "whats the sum of 123 and 456? and whats the weather of Tokyo?"
+agents:
+  - id: "gpt5_nano_custom_tool" # OpenAI GPT-5 Nano
+    backend:
+      type: "openai"
+      model: "gpt-5-nano"
+      custom_tools:
+        - name: ["two_num_tool"]
+          category: "math"
+          path: "massgen/tool/_basic/_two_num_tool.py"
+          function: ["two_num_tool"]
+      mcp_servers:
+        - name: "weather"
+          type: "stdio"
+          command: "npx"
+          args: ["-y", "@fak111/weather-mcp"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool and a weather information MCP tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+
+      Weather tools are available via MCP sessions and will be called automatically by the system when needed.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about weather conditions, forecasts, or alerts, include the location and time frame in your
+      response and provide concise, up-to-date information using the integrated tools.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/gpt5_nano_custom_tool_with_wrong_mcp_example.yaml

@@ -0,0 +1,33 @@
+# MassGen Configuration: GPT-5 Nano with Wrong MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gpt5_nano_custom_tool_with_wrong_mcp_example "whats the sum of 123 and 456? and whats the weather of Tokyo?"
+agents:
+  - id: "gpt5_nano_custom_tool" # OpenAI GPT-5 Nano
+    backend:
+      type: "openai"
+      model: "gpt-5-nano"
+      custom_tools:
+        - name: ["two_num_tool"]
+          function: ["two_num_tool"]
+      mcp_servers:
+        - name: "weather"
+          type: "stdio"
+          command: "python"
+          args: ["-u", "-m", "aaa.bbb"]  # Wrong MCP command to demonstrate error handling
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool and a weather information MCP tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+
+      Weather tools are available via MCP sessions and will be called automatically by the system when needed.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about weather conditions, forecasts, or alerts, include the location and time frame in your
+      response and provide concise, up-to-date information using the integrated tools.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/gpt5_nano_wrong_custom_tool_with_mcp_example.yaml

@@ -0,0 +1,33 @@
+# MassGen Configuration: GPT-5 Nano with Wrong Custom Tool and MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gpt5_nano_wrong_custom_tool_with_mcp_example "whats the sum of 123 and 456? and whats the weather of Tokyo?"
+agents:
+  - id: "gpt5_nano_custom_tool" # OpenAI GPT-5 Nano
+    backend:
+      type: "openai"
+      model: "gpt-5-nano"
+      custom_tools:
+        - name: ["two_num_tool"]
+          function: ["wrong_two_num_tool"]
+      mcp_servers:
+        - name: "weather"
+          type: "stdio"
+          command: "npx"
+          args: ["-y", "@fak111/weather-mcp"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool and a weather information MCP tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+
+      Weather tools are available via MCP sessions and will be called automatically by the system when needed.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about weather conditions, forecasts, or alerts, include the location and time frame in your
+      response and provide concise, up-to-date information using the integrated tools.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/gpt_oss_custom_tool_example.yaml

@@ -0,0 +1,25 @@
+# MassGen Configuration: Gemini with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gpt_oss_custom_tool_example "whats the sum of 123 and 456?"
+agents:
+  - id: "gpt-oss-custom_tool" # Cerebras AI GPT-OSS
+    backend:
+      type: "chatcompletion"
+      model: "gpt-oss-120b"
+      base_url: "https://api.cerebras.ai/v1"
+      custom_tools:
+        - name: ["two_num_tool"]
+          category: "math"
+          path: "massgen/tool/_basic/_two_num_tool.py"
+          function: ["two_num_tool"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+ui:
+  display_type: "simple"
+  logging_enabled: true

massgen/configs/tools/custom_tools/gpt_oss_custom_tool_example_no_path.yaml

@@ -0,0 +1,23 @@
+# MassGen Configuration: Gemini with MCP Integration
+# Usage:
+#   massgen --config @examples/tools/custom_tools/gpt_oss_custom_tool_example_no_path "whats the sum of 123 and 456?"
+agents:
+  - id: "gpt-oss-custom_tool" # Cerebras AI GPT-OSS
+    backend:
+      type: "chatcompletion"
+      model: "gpt-oss-120b"
+      base_url: "https://api.cerebras.ai/v1"
+      custom_tools:
+        - name: ["two_num_tool"]
+          function: ["two_num_tool"]
+    system_message: |
+      You are an AI assistant with access to a custom math calculation tool.
+
+      The two_num_tool is available as a custom tool that can add two numbers together.
+      Do not output tool call syntax or function declarations. Focus on answering the user's question clearly.
+
+      When users ask about adding two numbers together, use the two_num_tool to calculate the sum and provide
+      a clear, accurate result.
+ui:
+  display_type: "simple"
+  logging_enabled: true