Forumics logo Forumics
Issue 01

Back to issue

All Claude Code known issues

CLAIM C148 Supported 2026-11-16

GitHub issue #41973 in anthropics/claude-code, opened 2026-04-01 by yuhix-dev, records a report that when Claude Code is run as an MCP server via claude mcp serve, the MCP Agent tool cannot resolve subagents that are visible to the normal Claude CLI: on the same machine claude agents shows general-purpose under user agents, but an MCP Agent call fails with "Agent type 'general-purpose' not found. Available agents:" with the available-agent list appearing empty in MCP server mode; the reporter also tested passing an explicit inline agent definition via --agents into the claude mcp serve process and the MCP Agent call still failed with the same error; the report was filed against Claude Code 2.1.89 on macOS.

Verbatim Excerpts from Cited Records
“When Claude Code is run as an MCP server via `claude mcp serve`, the MCP `Agent` tool cannot resolve subagents that are visible to the normal Claude CLI.”
— yuhix-dev · anthropics/claude-code (issue 41973 opening body, What's Wrong section) · 2026-04-01T11:27:17Z ·GitHub Issue ↗
“The key problem is that the available-agent list appears to be empty in MCP server mode, even though the normal CLI can see the agent.”
— yuhix-dev · anthropics/claude-code (issue 41973 opening body, What's Wrong section) · 2026-04-01T11:27:17Z ·GitHub Issue ↗
“Agent type 'general-purpose' not found. Available agents:”
— yuhix-dev · anthropics/claude-code (issue 41973 opening body, What's Wrong section) · 2026-04-01T11:27:17Z ·GitHub Issue ↗
“I also tested passing an explicit inline agent definition via `--agents` into the `claude mcp serve` process. The MCP `Agent` call still failed with the same error.”
— yuhix-dev · anthropics/claude-code (issue 41973 opening body, What's Wrong section) · 2026-04-01T11:27:17Z ·GitHub Issue ↗
Counter-record: Issue closed 2026-11-14 by bpasero-ant, who said it is fixed in Claude Code 2.1.288. 19 comments were read. javi-dev (2026-04-06) confirmed in a Docker/Linux setup; aapzu (2026-04-24) confirmed on Claude Code 2.1.119 on macOS, showing plugin-contributed agents are also missing and that a raw MCP tools/list returns the Agent tool with an already-empty available-agent-types section, so the registry is empty at startup; zzlatev-yotpo (2026-07-30) confirmed on 2.1.220 with multiple server startup variants, all still failing; bcherny (2026-08-16), a maintainer, reproduced on 2.1.233 and confirmed the bug is real, that it has never worked, and that a fix loading the same subagent definitions the regular CLI uses was in progress. The closure records a fix in 2.1.288, not a refutation of the original report. No retraction of the original report appears in the surveyed thread. The claim documents only the original report, not a verified current state. Falsification probe: If GitHub issue #41973 is deleted without archive, if the author edits the opening body so the quoted sentences no longer match verbatim, or if the author posts a retraction of the report, this claim drops to Withdrawn. Audit verification: Verified 100% continuous verbatim substring against official GitHub REST API by scripts/verify_claim_verbatim.py.