[BUG] MCP tools unavailable in agent-team exec subagents — mcp__*__* returns "No such tool available" despite servers being connected at session level
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
Summary
When using the experimental Agent Teams feature (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1), any mcp__*__* tool call made inside an exec subagent process returns No such tool available. The MCP servers are configured and connected at the parent session level (system-layer info is injected, /mcp reports them as connected), but the tool registry does not appear to be exposed to the exec subagent spawned by the agent-teams runtime.
This affects every MCP server configured in the session — it is not specific to any one server — so it appears to be a generic tool-registry propagation issue rather than a per-server connection problem.
The main agent can call the mcp_tools but none of the subagents can.
Minimal reproduction
Prereqs: at least one MCP server already configured and connected (any server will do — confirm with /mcp).
- Enable agent teams:
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. - Launch Claude Code (
claude) in the project. - From the lead session, spawn a teammate (e.g. via the Task/agent-teams entry point) so the exec subagent process boots.
- Ask the teammate, on its first turn, to call any
mcp__<server>__<tool>that works in the parent session. - The call returns
No such tool available.
Expected: the MCP tool executes just like it does in the parent session.
Actual: No such tool available for every mcp__*__* tool, for every configured MCP server.
Expected behavior
Exec subagents spawned under agent teams should inherit the parent session's MCP tool registry (or synchronously load it before the first turn), so mcp__*__* tools are callable on turn 1 just as they are in the parent session.
Actual behavior
MCP tools are absent from the subagent's tool registry and every mcp__*__* call fails with No such tool available.
What I've verified
- The MCP servers are configured correctly.
- They are connected at the session level (system-layer info is injected into the parent session;
/mcpshows them as connected). - The failure is reproducible across all configured MCP servers, not isolated to one.
Related / prior reports
This looks like the same underlying problem tracked in #23625 (auto-closed as stale), with additional context in #25200 and a proposed fix direction in #31623. Filing fresh per the stale-closure guidance, since the issue is still reproducible on current Claude Code.
Environment
- Claude Code version: 2.1.119
- OS: Windows (running Claude Code under WSL + tmux)
- Feature flag:
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
What Should Happen?
Exec subagents spawned via the agent-teams runtime should have the parent session's MCP tools available on their first turn. mcp__<server>__<tool> calls should succeed inside the subagent just as they do in the parent session, instead of returning "No such tool available".
Error Messages/Logs
Steps to Reproduce
Prereqs: at least one MCP server configured and connected at the session level (any server will do — confirm with /mcp before starting).
- Enable agent teams:
````
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
- Launch Claude Code in a project:
````
claude
- In the lead session, confirm MCP servers are connected (
/mcplists them as connected and the samemcp__<server>__<tool>calls work from the lead). - Spawn a teammate / exec subagent via the agent-teams entry point and let it boot.
- On the teammate's first turn, ask it to call any
mcp__<server>__<tool>that is known to work in the lead. - Observe: the call returns
No such tool available. Everymcp__*__*tool for every configured MCP server fails with the same error.
Expected: the MCP tool executes just like it does in the parent/lead session.
Actual: every mcp__*__* call in the subagent returns No such tool available, even though the servers are connected at the session level.
Claude Model
None
Is this a regression?
Yes, this worked in a previous version
Last Working Version
_No response_
Claude Code Version
2.1.119
Platform
Anthropic API
Operating System
windows
Terminal/Shell
WSL/UBUNTU w/ TMUX
Additional Information
_No response_
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗