claude self-hosted-runner setup loads all MCP tool definitions upfront

Open Beginner friendly
#111,048 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
62/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript
Domain
ai, cli

Research direction

Find the setup flow for claude self-hosted-runner setup and inspect where it starts Claude Code with its --tools list. Read the Configure tool search documentation linked in the issue to confirm how including ToolSearch changes MCP tool loading. Done means the wizard defers unused MCP and connector tool definitions instead of loading all of them upfront.

Written by the indexing model from the issue text.

Description

area:cost area:mcp area:self-hosted-environments bug platform:linux

Problem

claude self-hosted-runner setup starts Claude Code with a fixed --tools list that does not include ToolSearch. When ToolSearch is left out of --tools, MCP tools load upfront instead of being deferred (Configure tool search).

As a result, every configured MCP server and claude.ai connector has its full tool definitions sent with every request in the wizard. The session transcript records deferred_tools_delta with toolSearchAbsent: true.

In my case that was 400 claude.ai connector tools (about 1.06 million characters of definitions) plus 207 tools from one user-scope MCP server. The wizard uses none of them.

Version

Claude Code 2.1.327, Linux

Dominant language
TypeScript
Stars
156k
Forks
25k
Avg merge
16h 19m
Merged PRs (30d)
5

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

  • No Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from anthropics/claude-code

All issues in anthropics/claude-code

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.