[DOCS] Missing LSP tool in primary reference and agent system instructions

What’s FIXED

While the primary request regarding the master tool table remains unaddressed, there have been significant updates to the surrounding documentation for LSP functionality:

• LSP Component Documentation: A new, detailed section has been added at https://code.claude.com/docs/en/plugins-reference#lsp-servers. This provides technical specifications for .lsp.json configuration, including required fields (command, extensionToLanguage) and optional parameters like initializationOptions and restartOnCrash.
• Plugin Integration Guidance: The "Create Plugins" guide at https://code.claude.com/docs/en/plugins#add-lsp-servers-to-your-plugin now includes instructions for creating custom LSP plugins for languages not covered by the official marketplace.
• Troubleshooting & Warnings: The documentation now explicitly warns users at https://code.claude.com/docs/en/plugins-reference#lsp-servers that language server binaries must be installed separately on the host machine to avoid "Executable not found" errors.

What’s UNRESOLVED

The core issue reported in the original feedback remains unresolved:

• Missing from Master Tool Table: The "Tools available to Claude" reference table at https://code.claude.com/docs/en/settings#tools-available-to-claude still only lists 17 tools (ending with Write). The LSP tool is entirely absent from this list.
• Lack of Permission Clarity: Because the LSP tool is not in the master list, there is no official confirmation in the settings documentation regarding its permission requirements. While the agent uses it for diagnostics and navigation, users cannot verify if it follows a "No Permission Required" model or if it can be restricted via disallowedTools.
• System Prompt Inconsistency: The documentation for subagents at https://code.claude.com/docs/en/sub-agents#control-subagent-capabilities describes how to restrict tools, but since LSP isn't defined as a primary tool, it is unclear if users can or should manage it within Task or Agent definitions.

Conclusion

I am keeping this issue open.

Although the documentation for configuring LSP servers via the plugin system has improved, the LSP tool itself is still a "ghost" in the primary configuration and tools reference. For technical accuracy and parity with other internal tools like Grep or Glob, the LSP tool must be explicitly added to the table at https://code.claude.com/docs/en/settings#tools-available-to-claude. Users need a single source of truth to understand the scope and permission model of every tool the agent has at its disposal.

Issue #19349 Verification

Title: [DOCS] Missing LSP tool in primary reference and agent system instructions
Issue Date: 2026-01-19
Verification Date: 2026-01-23
Status: RESOLVED

---

Issue Summary

I reported that the LSP tool was missing from the "Tools available to Claude" reference table at https://code.claude.com/docs/en/settings#tools-available-to-claude. The issue noted that while LSP Servers documentation existed in the plugins-reference page, the primary tools table did not include an entry for the LSP tool, making it difficult for users to understand its permission requirements and capabilities.

---

Verification Results

Claim 1: LSP tool missing from "Tools available to Claude" table

Status: RESOLVED

The LSP tool is now present in the tools table at line 869 of settings.md:

| **LSP** | Code intelligence via language servers. Reports type errors and warnings automatically after file edits. Also supports navigation operations: jump to definitions, find references, get type info, list symbols, find implementations, trace call hierarchies. Requires a [code intelligence plugin](https://code.claude.com/en/discover-plugins#code-intelligence) and its language server binary | No |

Verdict: Anthropic has added the LSP tool to the primary reference table with:

• A comprehensive description of its capabilities
• Clear indication that no permission is required
• A link to the code intelligence plugin documentation

Claim 2: LSP Servers documentation exists but primary table was incomplete

Status: RESOLVED

The LSP Servers documentation still exists at plugins-reference.md (lines 165-248), and the primary tools table now correctly references it. The documentation is consistent across both locations.

Claim 3: Table listed 17 tools

Status: RESOLVED

The current table lists 21 tools:

1. AskUserQuestion
2. Bash
3. TaskOutput
4. Edit
5. ExitPlanMode
6. Glob
7. Grep
8. KillShell
9. MCPSearch
10. NotebookEdit
11. Read
12. Skill
13. Task
14. TaskCreate
15. TaskGet
16. TaskList
17. TaskUpdate
18. WebFetch
19. WebSearch
20. Write
21. LSP (now added)

---

Current State

| Claim | Status |
|-------|--------|
| LSP tool missing from tools table | RESOLVED |
| LSP documentation exists in plugins-reference | Still exists, now properly cross-referenced |
| Primary docs don't define tool parameters | RESOLVED - description now included |

---

Suggested Fix

N/A - Issue has been resolved.

---

References

• URL: https://code.claude.com/docs/en/settings#tools-available-to-claude
• Lines 843-870 in mirror: Contains the "Tools available to Claude" section with LSP entry at line 869
• URL: https://code.claude.com/docs/en/plugins-reference#lsp-servers
• Lines 165-248 in mirror: LSP Servers documentation in plugins-reference.md

---

Conclusion & Recommendation

Primary Concern: The LSP tool was not documented in the primary "Tools available to Claude" reference table.

Resolution Status: RESOLVED

Recommendation: CLOSE

Anthropic has added the LSP tool to the settings documentation with a comprehensive description that includes its capabilities (diagnostics, navigation operations), permission requirements (No), and a link to the code intelligence plugin documentation. The issue has been fully addressed.

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.