LSP plugin lspServers config not being processed from marketplace.json

---

Found 3 possible duplicate issues:

1. https://github.com/anthropics/claude-code/issues/13952
2. https://github.com/anthropics/claude-code/issues/14803
3. https://github.com/anthropics/claude-code/issues/14932

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

Same problem for me as well, tried the plugin, with whatever mentioned in the doc :- https://code.claude.com/docs/en/plugins-reference#lsp-servers
but it's not working.

Same issue with me, here is CC thinks

⏺ Here's what I found:

Summary

What typescript-lsp does:

Based on https://github.com/boostvolt/claude-code-lsps and https://code.claude.com/docs/en/plugins:

The typescript-lsp plugin provides:

1. LSP Tool - Five operations: goToDefinition, findReferences, hover, documentSymbol, workspaceSymbol
2. Automatic Diagnostics - Real-time TypeScript error/warning detection when reading files

Current Status

You have the plugin installed and enabled:

• typescript-lsp@claude-plugins-official ✓
• Underlying LSP server: typescript-language-server@5.1.3 is installed globally ✓

However, it's likely not fully active because:

1. No LSP server process running - The typescript-language-server isn't currently running

I'm facing the same issue

LSP(operation: "documentSymbol", file: "src/routes/Account/Account.tsx")
  ⎿  No LSP server available for file type: .tsx

I'm in an even weirder position -- claude cannot even register the plugin now:

╭───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
───╮
│  Discover   Installed   Marketplaces   Errors  (tab to cycle)                                                         
   │
│                                                                                                                       
   │
│ Installed Plugins (1/14)                                                                                              
   │
│                                                                                                                       
   │
│ claude-plugins-official                                                                                               
   │
│ ❯ ◉ ralph-wiggum user                                                                                                 
   │
│   ◉ typescript-lsp user, v1.0.0                                                                                       
   │
│   ◉ feature-dev user                                                                                                  
   │
│   ◯ agent-sdk-dev user                                                                                                
   │
│   ◯ code-review user                                                                                                  
   │
│  ↓ more below                                                                                                         
   │
╰───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
───╯
   Space: toggle · Enter: details · Delete: uninstall · Esc: back

you have a plugin installed that you cannot see. why? 

∴ Thinking…

  The user is showing me that they have plugins installed, including a "typescript-lsp" plugin. They're pointing out that I 
  have a plugin installed that I cannot see - meaning I don't have visibility into the plugin's functionality or how it 
  works from my perspective.

  The user is asking why I can't see/access my own LSP plugin. This is a good question - I should explain what I understand 
  about this situation.

  From what I can see:
  1. There's a typescript-lsp plugin installed (v1.0.0)
  2. It's enabled (◉ means enabled)
  3. I apparently don't have direct visibility into what this plugin does or how it works

  The reason I can't "see" it is likely because:
  1. Plugins in Claude Code work by providing tools, hooks, or modifying behavior - but they don't necessarily expose 
  themselves to me directly
  2. The LSP plugin likely works by providing diagnostic information, navigation capabilities, etc. that get injected into 
  my context or tool responses without me explicitly invoking it
  3. I don't have a tool or documentation that tells me about my own installed plugins

  Let me explain this to the user.

⏺ You're right - I can see from your plugin list that typescript-lsp is installed and enabled, but I have no direct visibility into:

  1. What tools it provides - It's not listed in my available tools
  2. What it does behind the scenes - It may inject information into file reads or provide diagnostics automatically
  3. How to invoke it - No documented commands or tool interfaces exposed to me

  Why this happens:

  Plugins can operate in different ways:
  - Tool-based: Expose explicit tools I can call (like the MCP tools I can see)
  - Hook-based: Modify behavior transparently (e.g., auto-inject diagnostics when I read files)
  - Context injection: Add information to my context without explicit tool calls

Some other debug logs:

I understand your frustration. You have the typescript-lsp@claude-plugins-official plugin enabled in your settings, but its tools aren't appearing in my available MCP tools.

  Looking at my full MCP tool list from the system, I only see:
  - mcp__serena__* (semantic code tools)
  - mcp__context7__* (documentation lookup)
  - mcp__sequential-thinking__* (reasoning)
  - mcp__ide__* (VS Code/Cursor integration)

  The typescript-lsp plugin tools are NOT loading.

  This could be:
  1. Plugin not properly connected - enabled but not running
  2. Plugin provides implicit capabilities rather than explicit tools
  3. A bug in how the plugin integrates

  Would you like me to check the Claude Code documentation to see how this plugin is supposed to work, or can you check if there are any error messages in your Cursor/Claude Code logs?

> "typescript-lsp@claude-plugins-official": [
      {
        "scope": "project",
        "installPath": "/Users/connorblack/.claude/plugins/cache/claude-plugins-official/typescript-lsp/1.0.0",
        "version": "1.0.0",
        "installedAt": "2026-01-02T18:33:07.390Z",
        "lastUpdated": "2026-01-02T18:33:45.773Z",
        "isLocal": true,
        "projectPath": "/Users/connorblack/github/sellie-chat"
      },
      {
        "scope": "project",
        "projectPath": "/Users/connorblack/github/sellie-chat",
        "installPath": "/Users/connorblack/.claude/plugins/cache/claude-plugins-official/typescript-lsp/1.0.0",
        "version": "1.0.0",
        "installedAt": "2026-01-02T18:33:27.763Z",
        "lastUpdated": "2026-01-02T18:33:27.763Z",
        "isLocal": true
      }
    ] 

∴ Thinking…

  The user is showing me that the plugin is indeed installed - it's in the cache at 
  /Users/connorblack/.claude/plugins/cache/claude-plugins-official/typescript-lsp/1.0.0. 

  So the plugin IS installed and configured, but its tools aren't showing up in my available MCP tools. Let me look at 
  what's in that plugin directory to understand what tools it should be providing.

⏺ The plugin is definitely installed. Let me look at what it actually provides:

⏺ Bash(ls -la /Users/connorblack/.claude/plugins/cache/claude-plugins-official/typescript-lsp/1.0.0/)
  ⎿  drwx------   - connorblack  2 Jan 13:33 .        
     drwxr-xr-x   - connorblack  2 Jan 13:33 ..
     .rw-r--r-- 692 connorblack  2 Jan 13:33 README.md

⏺ Search(pattern: "**/*.json", path:
        "/Users/connorblack/.claude/plugins/cache/claude-plugins-official/typescript-lsp/1.0.0")
  ⎿  Found 0 files

∴ Thinking…

  Interesting - the plugin directory only contains a README.md file! No JSON manifest, no code. Let me read that README to 
  understand what this plugin is supposed to do.

⏺ Interesting - the plugin only has a README. Let me read it:

⏺ Read(~/.claude/plugins/cache/claude-plugins-official/typescript-lsp/1.0.0/README.md)
  ⎿  Read 25 lines

∴ Thinking…

  Ahh, now I understand! The typescript-lsp plugin requires an external dependency to be installed - the 
  typescript-language-server npm package. It's not bundling the server itself, it's just a plugin that integrates with the 
  external language server.

  The user needs to install:
  npm install -g typescript-language-server typescript

  Let me check if they have it installed.

⏺ Found the issue! The plugin requires an external dependency:

⏺ Bash(which typescript-language-server && typescript-language-server --version || echo "NOT INSTALLED")
  ⎿  /Users/connorblack/.bun/bin/typescript-language-server
     5.1.3

∴ Thinking…

  OK so the language server IS installed (version 5.1.3). So the external dependency is there.

  So we have:
  1. Plugin enabled in .claude/settings.json ✓
  2. Plugin installed in cache ✓
  3. typescript-language-server globally installed ✓

  But the tools still aren't showing up in my MCPSearch results. This suggests either:
  1. The plugin isn't properly connecting to Claude Code
  2. The plugin provides capabilities through a different mechanism (not as MCP tools)
  3. There's something else going on

  Let me check if there's a manifest or configuration file for this plugin that might tell us how it exposes its 
  capabilities. Maybe I should look at the parent directories or check if there's additional configuration needed.

⏺ So typescript-language-server IS installed (v5.1.3). Yet the tools still aren't appearing.

  Let me check if there's more plugin config or a manifest:

⏺ Bash(ls -laR /Users/connorblack/.claude/plugins/cache/claude-plugins-official/typescript-lsp/)
  ⎿  drwxr-xr-x - connorblack  2 Jan 13:33 .                                               
     drwxr-xr-x - connorblack 27 Dec  2025 ..
     drwx------ - connorblack  2 Jan 13:33 1.0.0

     /Users/connorblack/.claude/plugins/cache/claude-plugins-official/typescript-lsp/1.0.0:
     drwx------   - connorblack  2 Jan 13:33 .
     drwxr-xr-x   - connorblack  2 Jan 13:33 ..
     .rw-r--r-- 692 connorblack  2 Jan 13:33 README.md

⏺ Bash(cat /Users/connorblack/.claude/plugins/installed.json 2>/dev/null | head -100 || echo "No installed.json")
  ⎿  (No content)

∴ Thinking…

  The plugin directory literally only has a README.md file. No actual plugin code, no manifest, nothing. This is very 
  suspicious.

  This plugin seems incomplete or broken. It's just a README with installation instructions for an external tool, but 
  there's no actual plugin code that would integrate typescript-language-server with Claude Code and expose tools.

  This could mean:
  1. The plugin didn't download correctly
  2. The plugin is still in development / incomplete
  3. The plugin works differently than expected (maybe it modifies Claude Code behavior rather than exposing tools)

  Let me check what other official plugins look like to compare.

⏺ The plugin literally only has a README - no actual code! Let me check what other plugins look like for comparison:

https://github.com/anthropics/claude-code/issues/14803#issuecomment-3684942251
this work for me

Workaround: Working LSP Plugin

For anyone blocked by this issue, I've published a working LSP plugin that bypasses the broken official marketplace extraction:

https://github.com/yungweng/claude-lsp-servers

Quick Install

# Prerequisites
export ENABLE_LSP_TOOL=1  # Add to shell profile
npm install -g typescript-language-server typescript pyright
go install golang.org/x/tools/gopls@latest

# Install plugin
claude plugin marketplace add yungweng/claude-lsp-servers
claude plugin install lsp-servers@claude-lsp-servers

Restart Claude Code and verify with /plugin — no errors.

Supports TypeScript, Python (Pyright), and Go (gopls). All LSP operations working: hover, goToDefinition, findReferences, documentSymbol, goToImplementation, incomingCalls, outgoingCalls.

Hope this helps until the official fix lands!

I had all the symptoms of the issue here, and not beeing able to use LSP for C# and Typescript while lange servers running OK and plugins installed and enabled. Symptoms are:

• Empty plugin cahche folders with only README.md
• Claude logs registering 0 tools, while seeing language servers running OK

Claude Code 2.1.15, plugin version 1.0.0
WSL Ubuntu 24 on windows

MY FIX:

• Remove claude code completely, keep language server binaries/installation
• Reinstall Claude Code, add plugin repo (/plugin marketplace add anthropics/claude-plugins-official)
• Reinstall the LSP plugins from claude CLI interface (/plugins) - DONT INSTALL TO PROJECT SCOPE, go for the top choice (user?)
• Ask claude for LSP tools, if present, the tools will be listed

@connorblack Was in the same boat as you. Turns out if you install it in a project scope once somewhere, anywhere else you won't be able to see it, access it, open it. Going to that repo and uninstalling, then installing for user scope fixed it.

I have it installed in the user scope, and what seemed to get it working finally was setting the ENABLE_LSP_TOOL=1 environment variable

I have it installed in the user scope, and what seemed to get it working finally was setting the ENABLE_LSP_TOOL=1 environment variable

working for me. prompt: "@src/source.ts can you show me function table with LSP"

Claude has burned so many tokens trying to fix this issue for me, it's honestly infuriating how bad Claude is at managing its own files/configs, even after reading the docs multiple times.

@claude are you serious? this is embarrassing for you.

This is quite frustrating. This is a simple fix, and is breaking an essential feature of claude code.

I also installed pyright-lsp from official plugins market a while ago and realised it's not actually working. Windows 11, Windows Terminal / PowerShell 7, latest Claude code version. The plugin shows green and enabled but on a /reload-plugins it says "0 plugin LSP servers". pyright-lsp is installed and available on the shell I'm launching Claude code from (installed via pip install pyright).

I asked Claude to diagnose the issue and it said:

● Interesting — the plugin's plugin.json only has metadata (name, description, version, author) but no LSP server configuration. There's no lspServers field
   defining how to launch Pyright.

  Let me check what the marketplace version looks like vs the cached/installed version:

  Searched for 2 patterns, read 1 file (ctrl+o to expand)

● There's no plugin.json or any JSON in the marketplace source either. The installed cache has a plugin.json but it's missing the lspServers configuration
  that would tell Claude Code how to start Pyright.

  This looks like the plugin is essentially a stub — it has metadata and a README but no actual LSP wiring. That's why it reports "installed" and "latest
  version" but shows "0 plugin LSP servers" on reload. The plugin definition doesn't include the configuration needed to launch pyright-langserver --stdio
  (or equivalent).

  This could be:
  1. The plugin isn't fully implemented yet in the official repo
  2. The LSP server config was supposed to be auto-generated but isn't on Windows
  3. A newer version with the actual config hasn't been published

  Unfortunately there's nothing we can configure on our end to fix it — the plugin itself needs to ship with the LSP server definition. You might want to
  file an issue on the https://github.com/anthropics/claude-plugins-official or check if there's a newer version available.

It would be nice if Anthropic had some quality control over their official plugins marketplace to make sure things actually work.

Edit: This https://github.com/anthropics/claude-plugins-official/pull/378 fixed it for me, LSP plugins now working.

Anyone able to get Claude to apply initializationOptions when launching LSP server?

Setting ENABLE_LSP_TOOL=1 allows Claude to use LSP, but I have some trouble getting it to recognize my custom settings. The docs say I need to have a. .lsp.json file in plugin root or inline in plugin.json. I put such a file in both project root and /home/<username>/.claude/plugins/marketplaces/claude-plugins-official/plugins/typescript-lsp (for typescript LSP) which did not make any difference. And I don't know which plugin.json it is referring to.

(possibly related: https://github.com/anthropics/claude-code/issues/33552)

Update: For TypeScript LSP: If the TypeScript LSP is installed from the marketplace, the settings are defined in ~/.claude/plugins/marketplaces/claude-plugins-official/.claude-plugin/marketplace.json and you'll have to patch that file to customize initializationOptions. Putting a .lsp.json file under project folder or typescript-lsp folder won't do anything. Once you do that, Claude Code should respect initializationOptions in a new session.

Still reproducing on Claude Code 2.1.118 with pyright-lsp@claude-plugins-official 1.0.0 (installed 2026-02-26, gitCommitSha 55b58ec).

The discrepancy is exactly as described in the bug — the marketplace declares lspServers, but the installed plugin manifest doesn't:

~/.claude/plugins/marketplaces/claude-plugins-official/.claude-plugin/marketplace.json — has the block:

{
  "name": "pyright-lsp",
  "lspServers": {
    "pyright": {
      "command": "pyright-langserver",
      "args": ["--stdio"],
      "extensionToLanguage": { ".py": "python", ".pyi": "python" }
    }
  }
}

~/.claude/plugins/cache/claude-plugins-official/pyright-lsp/1.0.0/.claude-plugin/plugin.json — lacks it:

{
  "name": "pyright-lsp",
  "description": "...",
  "version": "1.0.0",
  "author": { ... }
}

claude plugin update pyright-lsp@claude-plugins-official says "already at the latest version (1.0.0)", so a clean reinstall doesn't help — the published 1.0.0 itself ships without the lspServers field.

Workaround (until this lands): manually copy the lspServers block from the marketplace.json into the installed plugin.json. After doing so + restarting Claude Code with ENABLE_LSP_TOOL=1, the LSP tool registers and documentSymbol / findReferences / hover / goToDefinition all work against pyright-langserver as expected. The patch survives until the next claude plugin update overwrites it.

Same defect applies to typescript-lsp@claude-plugins-official 1.0.0.

If you use tweakcc, it manages to fix all LSP shenanigans, at least for me.
Original tweakcc repo isn't maintained much but there is a fork on my page where I try to maintain it as much as possible, in case someone is editing prompts and whatnot :)

I can confirm that using .lsp.json at the plugin root works correctly as a workaround, even though marketplace.json lspServers is not processed.

My setup:

1. Created a plugin with only .lsp.json (no .claude-plugin/plugin.json needed)
2. Registered the plugin in marketplace.json with source: "./plugins/solidity-lsp"
3. The .lsp.json file:

{
  "solidity": {
    "command": "nomicfoundation-solidity-language-server",
    "args": ["--stdio"],
    "extensionToLanguage": {
      ".sol": "solidity"
    }
  }
}

1. After /reload-plugins, Claude Code shows "14 plugin LSP servers" and documentSymbol works correctly on .sol files.

Environment: macOS, Claude Code latest, local marketplace (/plugin marketplace add ~/path/to/skills)

This issue might be safe to close since .lsp.json at plugin root is the documented approach per https://code.claude.com/docs/en/plugins#add-lsp-servers-to-your-plugin

This seems to be fixed.

Still reproducing on Claude Code 2.1.246 (macOS arm64), tested 2026-08-26 — so the "seems to be fixed" note above does not hold on current builds.

claude -p "hi" --debug lsp with rust-analyzer-lsp@claude-plugins-official enabled and rust-analyzer on the process PATH:

[LSP MANAGER] initializeLspServerManager() called
[LSP MANAGER] Starting async initialization (generation 1)
[LSP SERVER MANAGER] getAllLspServers returned 0 server(s)

No server spawns and no LSP tool is registered, so from the user side it is indistinguishable from a build without LSP support.

Scope on this install: 5 of the 6 installed *-lsp plugins had no lspServers in their installed manifest (the 6th only because I had already patched it by hand). All 6 are user scope, version 1.0.0, gitCommitSha 55b58ec — the same sha reported in the 2026-05-03 comment above, so the package has not moved.

One correction to the packaging description in anthropics/claude-plugins-official#379: the installed directory is no longer README-only. It now ships LICENSE, README.md, and .claude-plugin/plugin.json — but that manifest contains only name/description/version/author, still no lspServers. The packaging changed; the bug did not.

Both workarounds work on 2.1.246. The runtime resolves the config as plugin.lspServers || <plugin-root file loader>, and neither branch consults marketplace.json:

1. Inject the block into the installed .claude-plugin/plugin.json, or
2. Drop a .lsp.json at the plugin root (as reported in the 2026-05-24 comment).

Either produces:

Loaded 1 LSP server(s) from plugin: rust-analyzer-lsp
[LSP SERVER MANAGER] getAllLspServers returned 1 server(s)
Registered diagnostics handler for plugin:rust-analyzer-lsp:rust-analyzer
[LSP PROTOCOL ...] Sending request 'initialize - (0)'
[LSP PROTOCOL ...] Received response 'initialize - (0)' in 27ms

after which documentSymbol/hover/findReferences all return real results.

Two smaller notes: ENABLE_LSP_TOOL=1 was not needed on this version — the LSP tool appears as soon as at least one server loads. And because /plugin update rewrites the cache, either workaround is silently reverted by a routine update, with the same zero-server symptom and no warning.

I can confirm this is still an issue in v2.1.286

For example, ~/.claude/plugins/cache/claude-plugins-official/swift-lsp/1.0.0/.claude-plugin/plugin.json is regularly overwritten with:

{
  "name": "swift-lsp",
  "description": "Swift language server (SourceKit-LSP) for code intelligence",
  "version": "1.0.0",
  "author": {
    "name": "Anthropic",
    "email": "support@anthropic.com"
  }
}

And with the JSON missing the lspServers object, the Swift LSP does not work and Claude Code informs me that "no LSP tool is available in this session".

To get it working again, all I need to do is add the lspServers object:

{
  "name": "swift-lsp",
  "description": "Swift language server (SourceKit-LSP) for code intelligence",
  "version": "1.0.0",
  "author": {
    "name": "Anthropic",
    "email": "support@anthropic.com"
  },
  "lspServers": {
    "sourcekit-lsp": {
      "command": "sourcekit-lsp",
      "extensionToLanguage": {
        ".swift": "swift"
      }
    }
  }
}

I do not have ENABLE_LSP_TOOL set so that appears to no longer be necessary at this point.

@anthropics May you please prioritize this issue? We've found that LSP is such an advantage when using Claude Code and really need this bug fixed to avoid LSP being inadvertently disabled. Thank you!! 🙏

Cross reference to corresponding issue @ anthropics/claude-plugins-official repo is https://github.com/anthropics/claude-plugins-official/issues/379

And I will test again in v2.1.288 and report back.

Confirmed that it is also still an issue in v2.1.288