From d0715dfad699147556efbd1a90c04c45dda23340 Mon Sep 17 00:00:00 2001 From: iliya Date: Mon, 30 Mar 2026 18:59:39 +0300 Subject: [PATCH] docs(README): add warning about Claude Code issue with agent teams - Included a warning regarding an upstream issue in Claude Code affecting the inheritance of external MCP tools by teammates spawned via Agent/Task. - Noted the impact on bootstrap processes and provided a link to track the issue status. --- README.md | 3 +++ mcp-server/src/tools/index.ts | 5 ++++- 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d4801cd1..a4699ce6 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,9 @@

100% free, open source. No API keys. No configuration. Runs entirely locally. Not just coding agents.

+ +> [!WARNING] +> There is an upstream Claude Code issue where teammates spawned via Agent/Task may fail to inherit external MCP tools. In Agent Teams this breaks bootstrap because `mcp__agent-teams__member_briefing` is missing from the teammate tool surface, so agents report that `member_briefing` is unavailable and stop before starting work. We reproduced this locally with direct Claude Code binaries `2.1.86` and `2.1.87`, so a reliable version-pin workaround is not confirmed. Track upstream status in [anthropics/claude-code#7296](https://github.com/anthropics/claude-code/issues/7296).
diff --git a/mcp-server/src/tools/index.ts b/mcp-server/src/tools/index.ts index 9d3408a1..e8de3914 100644 --- a/mcp-server/src/tools/index.ts +++ b/mcp-server/src/tools/index.ts @@ -1,6 +1,9 @@ import type { FastMCP } from 'fastmcp'; -import { AGENT_TEAMS_MCP_TOOL_GROUPS, AGENT_TEAMS_REGISTERED_TOOL_NAMES } from 'agent-teams-controller'; +import agentTeamsControllerModule from 'agent-teams-controller'; + +const { AGENT_TEAMS_MCP_TOOL_GROUPS, AGENT_TEAMS_REGISTERED_TOOL_NAMES } = + agentTeamsControllerModule as typeof import('agent-teams-controller'); import { registerCrossTeamTools } from './crossTeamTools'; import { registerKanbanTools } from './kanbanTools';