[BUG] MCP tools unavailable in agent-team exec subagents — mcp__*__* returns "No such tool available" despite servers being connected at session level

Resolved 💬 1 comment Opened Apr 24, 2026 by DougLifeOfficial Closed May 28, 2026

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).

  1. Enable agent teams: export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1.
  2. Launch Claude Code (claude) in the project.
  3. From the lead session, spawn a teammate (e.g. via the Task/agent-teams entry point) so the exec subagent process boots.
  4. Ask the teammate, on its first turn, to call any mcp__<server>__<tool> that works in the parent session.
  5. 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; /mcp shows 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).

  1. Enable agent teams:

``
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
``

  1. Launch Claude Code in a project:

``
claude
``

  1. In the lead session, confirm MCP servers are connected (/mcp lists them as connected and the same mcp__<server>__<tool> calls work from the lead).
  2. Spawn a teammate / exec subagent via the agent-teams entry point and let it boot.
  3. On the teammate's first turn, ask it to call any mcp__<server>__<tool> that is known to work in the lead.
  4. Observe: the call returns No such tool available. Every mcp__*__* 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_

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗